react-semaphor 0.1.370 → 0.1.371

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

@@ -1,9 +1,9 @@
-import { t as y, a as M, b as B, c as Q, d as J, e as Y, f as H, g as W, n as V, h as $, i as I } from "../chunks/validation-PPSpYtVf.js";
-import { m as Le, j as Me, k as Be, l as Qe, v as Je } from "../chunks/validation-PPSpYtVf.js";
-import { j as F } from "../chunks/index-CuHybtft.js";
-import { createContext as X, useContext as G, useMemo as m, useState as O, useCallback as R, useEffect as N, useRef as j } from "react";
+import { t as y, a as M, b as B, c as Q, d as J, e as Y, f as F, g as H, n as V, h as $, i as k } from "../chunks/validation-CQFpcSSP.js";
+import { m as ze, j as Me, k as Be, l as Qe, v as Je } from "../chunks/validation-CQFpcSSP.js";
+import { j as W } from "../chunks/index-CuHybtft.js";
+import { createContext as X, useContext as G, useMemo as m, useState as O, useCallback as R, useEffect as L, useRef as j } from "react";
 import { jsx as Z } from "react/jsx-runtime";
-import { v as ee } from "../chunks/validators-DBNa-eb1.js";
+import { c as ee } from "../chunks/validators-CuKnUZFO.js";
 const te = [
   "records",
   "changes",
@@ -21,7 +21,7 @@ const te = [
   "largestNegativeDrivers",
   "largestPositiveDrivers"
 ];
-function U(e) {
+function N(e) {
   if (!e)
     return {};
   const t = se(e.executionResult), n = ne(e, t), r = ie(n);
@@ -39,7 +39,7 @@ function ne(e, t) {
   const n = oe(e.resultSets);
   for (const i of te) {
     if (n[i]) {
-      n[i] = z(n[i]);
+      n[i] = U(n[i]);
       continue;
     }
     const u = ae(e[i]);
@@ -59,11 +59,11 @@ function oe(e) {
   return Object.fromEntries(
     Object.entries(e || {}).map(([t, n]) => [
       t,
-      z(n)
+      U(n)
     ])
   );
 }
-function z(e) {
+function U(e) {
   var t;
   return {
     ...e,
@@ -157,6 +157,13 @@ const Pe = {
       role: "sqlParam"
     };
   },
+  derivedField(e) {
+    return {
+      ...e,
+      kind: "derived_field",
+      expressionLanguage: e.expressionLanguage || "semaphor_sql_template"
+    };
+  },
   metric(e) {
     return {
       ...e,
@@ -200,7 +207,7 @@ function de() {
       e,
       t,
       n ?? {}
-    ).then(U),
+    ).then(N),
     executeMetric: (e, t) => h(e, t),
     executeRecords: (e, t) => h(e, t),
     executeInputOptions: (e, t) => h(e, t),
@@ -264,18 +271,18 @@ function he(e) {
   if (!e.token)
     return "";
   try {
-    return F(e.token).apiServiceUrl || "";
+    return W(e.token).apiServiceUrl || "";
   } catch {
     return "";
   }
 }
-const L = X({});
+const z = X({});
 function ve() {
   if (!(typeof window > "u"))
     return window.__SEMAPHOR_DATA_APP_RUNTIME__;
 }
 function ye() {
-  return G(L);
+  return G(z);
 }
 function je({
   token: e,
@@ -292,13 +299,13 @@ function je({
     }),
     [s, a, u]
   );
-  return /* @__PURE__ */ Z(L.Provider, { value: c, children: r });
+  return /* @__PURE__ */ Z(z.Provider, { value: c, children: r });
 }
-const k = { value: null }, D = {}, qe = { records: [] }, x = { options: [] }, Se = { records: [] }, E = {};
+const I = { value: null }, x = {}, qe = { records: [] }, D = { options: [] }, Se = { records: [] }, E = {};
 function Ae(e) {
   const t = y(e.inputs), n = Y(e);
   try {
-    const r = H(e), i = v(r);
+    const r = F(e), i = v(r);
     return i ? {
       error: i,
       activeInputs: t,
@@ -309,14 +316,14 @@ function Ae(e) {
         i,
         n
       ),
-      idleData: D
+      idleData: x
     } : {
       intent: r,
       error: null,
       activeInputs: t,
       analysisOptions: n,
       queryKey: d(r, t, void 0, n),
-      idleData: D
+      idleData: x
     };
   } catch (r) {
     const i = p(r);
@@ -330,25 +337,25 @@ function Ae(e) {
         i,
         n
       ),
-      idleData: D
+      idleData: x
     };
   }
 }
 function ge(e) {
   const t = y(e.inputs);
   try {
-    const n = W(e), r = v(n);
+    const n = H(e), r = v(n);
     return r ? {
       error: r,
       activeInputs: t,
       queryKey: d(void 0, t, r),
-      idleData: k
+      idleData: I
     } : {
       intent: n,
       error: null,
       activeInputs: t,
       queryKey: d(n, t),
-      idleData: k
+      idleData: I
     };
   } catch (n) {
     const r = p(n);
@@ -356,11 +363,11 @@ function ge(e) {
       error: r,
       activeInputs: t,
       queryKey: d(void 0, t, r),
-      idleData: k
+      idleData: I
     };
   }
 }
-function Ie(e) {
+function ke(e) {
   const t = y(e.inputs), n = qe;
   try {
     const r = J(e), i = v(r);
@@ -386,29 +393,29 @@ function Ie(e) {
     };
   }
 }
-function ke(e) {
+function Ie(e) {
   try {
     const t = Q(e), n = v(t);
     return n ? {
       error: n,
       queryKey: d(void 0, void 0, n),
-      idleData: x
+      idleData: D
     } : {
       intent: t,
       error: null,
       queryKey: d(t),
-      idleData: x
+      idleData: D
     };
   } catch (t) {
     const n = p(t);
     return {
       error: n,
       queryKey: d(void 0, void 0, n),
-      idleData: x
+      idleData: D
     };
   }
 }
-function De(e) {
+function xe(e) {
   const t = y(e.inputs), n = Se;
   try {
     const r = B(e), i = v(r);
@@ -434,7 +441,7 @@ function De(e) {
     };
   }
 }
-function xe(e) {
+function De(e) {
   const t = y(e.inputs);
   try {
     const n = M(e), r = v(n);
@@ -503,7 +510,7 @@ function Ve(e) {
       controlRole: e.kind === "control" ? e.role : void 0,
       value: i,
       options: u,
-      isActive: I(i),
+      isActive: k(i),
       setValue: s,
       clear: f,
       toAnalyticsInput: () => ({
@@ -512,7 +519,7 @@ function Ve(e) {
         kind: e.kind,
         label: e.label,
         value: i,
-        isActive: I(i),
+        isActive: k(i),
         operator: a.operator,
         controlRole: e.kind === "control" ? e.role : void 0
       })
@@ -521,7 +528,7 @@ function Ve(e) {
 }
 function $e(e) {
   const [t, n] = O(() => Ke(e));
-  return N(() => {
+  return L(() => {
     n((r) => {
       let i = r;
       for (const u of e)
@@ -549,7 +556,7 @@ function $e(e) {
         controlRole: r.kind === "control" ? r.role : void 0,
         value: u,
         options: s,
-        isActive: I(u),
+        isActive: k(u),
         setValue: f,
         clear: a,
         toAnalyticsInput: () => ({
@@ -558,7 +565,7 @@ function $e(e) {
           kind: r.kind,
           label: r.label,
           value: u,
-          isActive: I(u),
+          isActive: k(u),
           operator: c.operator,
           controlRole: r.kind === "control" ? r.role : void 0
         })
@@ -567,7 +574,7 @@ function $e(e) {
     [e, t]
   );
 }
-function Ne(e, t = {}) {
+function Le(e, t = {}) {
   const n = m(
     () => t.inputs ? {
       ...e,
@@ -589,22 +596,22 @@ function Ne(e, t = {}) {
       case "records":
         return {
           queryKind: n.queryKind,
-          request: Ie(n)
+          request: ke(n)
         };
       case "inputOptions":
         return {
           queryKind: n.queryKind,
-          request: ke(n)
+          request: Ie(n)
         };
       case "sql":
         return {
           queryKind: n.queryKind,
-          request: De(n)
+          request: xe(n)
         };
       case "matrix":
         return {
           queryKind: n.queryKind,
-          request: xe(n)
+          request: De(n)
         };
       default:
         return K(n);
@@ -679,7 +686,7 @@ function Ne(e, t = {}) {
       };
     }
     case "analysis": {
-      const o = U(s);
+      const o = N(s);
       return {
         id: n.id,
         intent: r.request.intent,
@@ -757,7 +764,7 @@ function Ee(e, t, n, r) {
     data: n,
     error: null
   });
-  return u.current = t, s.current = r, N(() => {
+  return u.current = t, s.current = r, L(() => {
     let c;
     try {
       c = u.current({
@@ -803,19 +810,19 @@ function K(e) {
   throw new Error(`Unsupported Semaphor query kind: ${JSON.stringify(e)}`);
 }
 export {
-  L as SemaphorDataAppContext,
+  z as SemaphorDataAppContext,
   je as SemaphorDataAppProvider,
   de as createSemaphorQueryExecutor,
   _e as defineSemaphorDataApp,
   Te as defineSemaphorInput,
-  I as hasSemaphorInputValue,
-  U as normalizeSemaphorAnalysisPayload,
-  Le as normalizeSemaphorAnalysisQueryOptions,
+  k as hasSemaphorInputValue,
+  N as normalizeSemaphorAnalysisPayload,
+  ze as normalizeSemaphorAnalysisQueryOptions,
   V as normalizeSemaphorInputOptions,
   ve as readWindowRuntime,
   Pe as semaphor,
   y as toSemaphorActiveInputSnapshots,
-  H as toSemaphorAnalysisIntent,
+  F as toSemaphorAnalysisIntent,
   Y as toSemaphorAnalysisQueryOptions,
   Me as toSemaphorInputBinding,
   Be as toSemaphorInputBindings,
@@ -823,12 +830,12 @@ export {
   Qe as toSemaphorInputSnapshots,
   $ as toSemaphorInputSpec,
   M as toSemaphorMatrixIntent,
-  W as toSemaphorMetricIntent,
+  H as toSemaphorMetricIntent,
   J as toSemaphorRecordsIntent,
   B as toSemaphorSqlIntent,
   ye as useSemaphorDataAppRuntime,
   Ve as useSemaphorInput,
   $e as useSemaphorInputs,
-  Ne as useSemaphorQuery,
+  Le as useSemaphorQuery,
   Je as validateSemaphorDataAppQuerySpecs
 };

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

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("../chunks/validators-CgxWT8UX.js");require("../chunks/source-identity-C-xaeE_I.js");const e=require("../chunks/validation-DYL3ArlL.js");exports.normalizeSemaphorAnalysisQueryOptions=e.normalizeSemaphorAnalysisQueryOptions;exports.validateSemaphorDataAppQuerySpecs=e.validateSemaphorDataAppQuerySpecs;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("../chunks/validators-DHee9kM2.js");require("../chunks/catalog-field-grounding-Du6mKDcF.js");require("../chunks/source-identity-C-xaeE_I.js");const e=require("../chunks/validation-D4Zz6WPD.js");exports.normalizeSemaphorAnalysisQueryOptions=e.normalizeSemaphorAnalysisQueryOptions;exports.validateSemaphorDataAppQuerySpecs=e.validateSemaphorDataAppQuerySpecs;

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

@@ -1,7 +1,8 @@
-import "../chunks/validators-DBNa-eb1.js";
+import "../chunks/validators-CuKnUZFO.js";
+import "../chunks/catalog-field-grounding-DoEBOXQd.js";
 import "../chunks/source-identity-Dj3dryN9.js";
-import { m as o, v as m } from "../chunks/validation-PPSpYtVf.js";
+import { m, v as i } from "../chunks/validation-CQFpcSSP.js";
 export {
-  o as normalizeSemaphorAnalysisQueryOptions,
-  m as validateSemaphorDataAppQuerySpecs
+  m as normalizeSemaphorAnalysisQueryOptions,
+  i as validateSemaphorDataAppQuerySpecs
 };

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chunks/index-BtqYNH_S.js"),d=require("./chunks/common-types-C73-Ud1-.js"),P=require("./chunks/calendar-preferences-dialog-CUGzkNcE.js"),t=require("react/jsx-runtime"),a=require("./chunks/switch-fIkmwzUt.js"),C=require("react"),N=require("./chunks/resource-management-panel-Bf8-3eUf.js"),y=require("./types/index.cjs"),_=require("./chunks/use-debounced-dirty-check-XHSwAefL.js");require("react-dom");require("./chunks/index-DRlMUglg.js");const r=require("./chunks/dashboard-briefing-launcher-BEZnvIla.js"),S=require("./chunks/normalize-dashboard-for-dirty-check-BXRUMVb2.js");require("./chunks/index-BxM99sFL.js");function R(o){const i=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(o){for(const n in o)if(n!=="default"){const u=Object.getOwnPropertyDescriptor(o,n);Object.defineProperty(i,n,u.get?u:{enumerable:!0,get:()=>o[n]})}}return i.default=o,Object.freeze(i)}const h=R(C);function j(o){const{displayPreferences:i,cardId:n,...u}=o,s={...u,id:o.dashboardId};return t.jsx(e.ErrorBoundary,{FallbackComponent:e.Fallback,children:t.jsxs(e.SemaphorContextProvider,{dashboardProps:s,children:[t.jsx(e.SemaphorReadyIndicator,{componentType:"visual",componentId:o.cardId}),t.jsx(e.UXProvider,{appearance:o.appearance,children:t.jsx(e.DisplayPreferencesProvider,{displayPreferences:i,children:t.jsx(e.Container,{type:"visual",cardId:n,...s,children:t.jsx(w,{cardId:n})})})})]})})}function w({cardId:o}){const i=a.useDashboardStore(s=>{var c;return(c=s.dashboard)==null?void 0:c.sheets}),{card:n,frame:u}=C.useMemo(()=>{const s=i==null?void 0:i.flatMap(l=>l.frames),c=s==null?void 0:s.flatMap(l=>l==null?void 0:l.cards),D=c==null?void 0:c.find(l=>(l==null?void 0:l.id)===o),E=s==null?void 0:s.find(l=>{var p;return(p=l==null?void 0:l.cards)==null?void 0:p.find(g=>(g==null?void 0:g.id)===o)});return{card:D,frame:E}},[i,o]);return!n||!u?t.jsx(e.FallbackVisual,{error:new Error("Card not found"),resetErrorBoundary:()=>{},customerFacingMessage:`Card not found with ID: ${o}`}):t.jsx("main",{className:"flex h-full grow flex-col",children:t.jsx(e.ErrorBoundary,{FallbackComponent:({error:s,resetErrorBoundary:c})=>t.jsx(e.FallbackVisual,{error:s,resetErrorBoundary:c,customerFacingMessage:"Error creating visual. Please try again."}),children:t.jsx(e.DashboardCard,{card:n,frame:u})})})}function M(o,i,n,u){C.useEffect(()=>{o&&!n&&i&&u(e.cloneDeep(i))},[o,n,i,u])}function L({name:o,items:i,value:n,onChange:u,isLoading:s,isError:c,refetch:D,className:E,icon:l,showNone:p=!1}){const g=h.useRef(null),[b,T]=h.useState(!1),[B,A]=h.useState("100%"),x=p?[...i||[],{id:"none",name:"None"}]:i;h.useLayoutEffect(()=>{g.current&&A(g.current.offsetWidth)},[]);function F(){var f;return s?"Loading...":c?"Error":n?(f=i==null?void 0:i.find(m=>m.id===n))==null?void 0:f.name:`Select ${o}`}function v(f,m){u(m),T(!1)}return t.jsxs(a.Popover,{open:b,onOpenChange:T,children:[t.jsx(a.PopoverTrigger,{asChild:!0,children:t.jsxs(a.Button,{ref:g,variant:"outline",role:"combobox","aria-expanded":b,className:a.cn("flex h-9 w-full justify-between",E),children:[t.jsxs("div",{className:"flex items-center gap-2",children:[l&&t.jsx("div",{className:"mr-2",children:l}),t.jsx("span",{className:"max-w-[150px] overflow-hidden truncate text-ellipsis whitespace-nowrap",children:F()})]}),t.jsx(a.ChevronDown,{className:"size-4 opacity-50"})]})}),t.jsx(a.PopoverContent,{className:"w-full p-0",style:{minWidth:B},children:t.jsxs(e.Command,{children:[t.jsxs("div",{className:"flex h-9 items-center justify-between border-b pr-1",children:[t.jsx(e.CommandInput,{className:"h-9",placeholder:"Search..."}),t.jsx(e.IconButton,{className:"h-7",onClick:D,children:t.jsx(e.RefreshCw,{className:a.cn("size-3.5 opacity-50",s&&"animate-spin")})})]}),t.jsxs(e.CommandList,{children:[t.jsxs(e.CommandEmpty,{children:["No ",o==null?void 0:o.toLowerCase()," found."]}),t.jsx(e.CommandGroup,{children:x==null?void 0:x.map(f=>t.jsx(e.CommandItem,{className:"overflow-x-auto",value:f.name,onSelect:m=>v(m,f.id),children:t.jsxs("div",{className:"flex items-center gap-2",children:[t.jsx(a.Check,{className:a.cn("size-4",n===f.id?"opacity-100":"opacity-0")}),t.jsx("div",{title:f.name,children:f.name})]})},f.id))})]})]})})]})}function I(o,i){C.useEffect(()=>(o&&i&&(window.__SEMAPHOR_PRINT_STATE__={...i}),()=>{o&&window.__SEMAPHOR_PRINT_STATE__&&delete window.__SEMAPHOR_PRINT_STATE__}),[o,i])}exports.CardSummary=e.CardSummary;exports.Dashboard=e.Dashboard;exports.DashboardCreateDialogBase=e.DashboardCreateDialogBase;exports.DashboardExportDialog=e.DashboardExportDialog;exports.DashboardWC=e.DashboardWC;exports.ExportError=e.ExportError;exports.ResourceType=e.ResourceType;exports.SemaphorContextProvider=e.SemaphorContextProvider;exports.SemaphorDataProvider=e.SemaphorQueryClient;exports.SemaphorQueryClient=e.SemaphorQueryClient;exports.ShareDialog=e.ShareDialog;exports.SummaryCard=e.SummaryCard;exports.Surfboard=e.DashboardPlus;exports.cancelExport=e.cancelExport;exports.cloneDeep=e.cloneDeep;exports.createExport=e.createExport;exports.downloadDocumentPdf=e.downloadDocumentPdf;exports.downloadPdf=e.downloadPdf;exports.formatFileSize=e.formatFileSize;exports.getDownloadUrl=e.getDownloadUrl;exports.getExportStatus=e.getExportStatus;exports.getExports=e.getExports;exports.isExportComplete=e.isExportComplete;exports.isExportInProgress=e.isExportInProgress;exports.useActiveExports=e.useActiveExports;exports.useAddNewFrame=e.useAddNewFrame;exports.useCard=e.useCard;exports.useCardSummary=e.useCardSummary;exports.useDashboardById=e.useDashboardById;exports.useDashboardQuery=e.useDashboardQuery;exports.useDashboardSummary=e.useDashboardSummary;exports.useDataColumns=e.useDataColumns;exports.useDateFilterHook=e.useDateFilterHook;exports.useEditorAside=e.useEditorAside;exports.useExportActions=e.useExportActions;exports.useExportStore=e.useExportStore;exports.useInProgressExportsCount=e.useInProgressExportsCount;exports.useManagementStore=e.useManagementStore;exports.useResourceManagement=e.useResourceManagement;exports.useTextFilterHook=e.useTextFilterHook;exports.CALCULATED_FIELD_ENTITY_MARKER=d.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=d.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=d.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=d.EMPTY_SELECTION;exports.PivotMarkerEnum=d.PivotMarkerEnum;exports.getFieldRuntimeColumnName=d.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=d.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=d.hasCalculatedFormulaInputs;exports.isCalculatedDimension=d.isCalculatedDimension;exports.isCalculatedField=d.isCalculatedField;exports.isCalculatedMetric=d.isCalculatedMetric;exports.CalendarPreferencesDialog=P.CalendarPreferencesDialog;exports.createEmptyKpiConfig=a.createEmptyKpiConfig;exports.createSqlGenConfig=a.createSqlGenConfig;exports.emitDashboardLoad=a.emitDashboardLoad;exports.emitDashboardUnload=a.emitDashboardUnload;exports.fmt=a.fmt;exports.getColumnDataType=a.getColumnDataType;exports.getFilterValueType=a.getFilterValueType;exports.getFormattedTableNameForQuery=a.getFormattedTableNameForQuery;exports.getQualifiedTableName=a.getQualifiedTableName;exports.getSql=a.getSql;exports.invalidateToken=a.invalidateToken;exports.isBooleanDataType=a.isBooleanDataType;exports.isColumnInSqlGen=a.isColumnInSqlGen;exports.isDateDataType=a.isDateDataType;exports.isNumberDataType=a.isNumberDataType;exports.isTextDataType=a.isTextDataType;exports.resolveDataType=a.resolveDataType;exports.resolveDatamodelName=a.resolveDatamodelName;exports.useCurrentActiveCard=a.useCurrentActiveCard;exports.useCurrentCardConfig=a.useCurrentCardConfig;exports.useCurrentSheetActiveCards=a.useCurrentSheetActiveCards;exports.useDashboardActions=a.useDashboardActions;exports.useDashboardStore=a.useDashboardStore;exports.useEditorActions=a.useEditorActions;exports.useEditorStore=a.useEditorStore;exports.ResourceManagementPanel=N.ResourceManagementPanel;exports.DEFAULT_CALENDAR_CONTEXT=y.DEFAULT_CALENDAR_CONTEXT;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=y.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.useDebouncedDirtyCheck=_.useDebouncedDirtyCheck;exports.AdvancedModeToggle=r.AdvancedModeToggle;exports.BriefingAuthor=r.BriefingAuthor;exports.BriefingsApiError=r.BriefingsApiError;exports.DashboardBriefingLauncher=r.DashboardBriefingLauncher;exports.DashboardControlsSettings=r.DashboardControlsSettings;exports.DashboardFilterControlsButton=r.DashboardFilterControlsButton;exports.DashboardFilterControlsLauncher=r.DashboardFilterControlsLauncher;exports.DocumentControlsSettings=r.DocumentControlsSettings;exports.ExportNotificationItem=r.ExportNotificationItem;exports.ExportNotificationList=r.ExportNotificationList;exports.NotificationBell=r.NotificationBell;exports.UnsavedChangesAlert=r.UnsavedChangesAlert;exports.VisualEditingControls=r.VisualEditingControls;exports.WatchDashboardButton=r.WatchDashboardButton;exports.applyBriefingFormPatch=r.applyBriefingFormPatch;exports.briefingFormDraftToCreateRequest=r.briefingFormDraftToCreateRequest;exports.briefingFormDraftToUpdateRequest=r.briefingFormDraftToUpdateRequest;exports.briefingToFormDraft=r.briefingToFormDraft;exports.cancelBriefingRun=r.cancelBriefingRun;exports.createBriefing=r.createBriefing;exports.createBriefingFormDraft=r.createBriefingFormDraft;exports.deleteBriefing=r.deleteBriefing;exports.deleteBriefingRun=r.deleteBriefingRun;exports.getBriefing=r.getBriefing;exports.getBriefingArtifact=r.getBriefingArtifact;exports.getBriefingEvidence=r.getBriefingEvidence;exports.getBriefingPreviewRun=r.getBriefingPreviewRun;exports.getBriefingRun=r.getBriefingRun;exports.listBriefingRuns=r.listBriefingRuns;exports.listBriefingTenantSummaries=r.listBriefingTenantSummaries;exports.listBriefings=r.listBriefings;exports.pauseBriefing=r.pauseBriefing;exports.polishBriefingText=r.polishBriefingText;exports.previewBriefingPlan=r.previewBriefingPlan;exports.resumeBriefing=r.resumeBriefing;exports.runBriefingNow=r.runBriefingNow;exports.runBriefingPreview=r.runBriefingPreview;exports.updateBriefing=r.updateBriefing;exports.useExportPolling=r.useExportPolling;exports.useExportRecovery=r.useExportRecovery;exports.validateBriefingFormDraft=r.validateBriefingFormDraft;exports.normalizeDashboardForDirtyCheck=S.normalizeDashboardForDirtyCheck;exports.serializeDashboardForDirtyCheck=S.serializeDashboardForDirtyCheck;exports.Combobox=L;exports.Visual=j;exports.useExposePrintState=I;exports.usePristineSnapshotInitializer=M;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chunks/index-DlLvzmJF.js"),d=require("./chunks/common-types-C73-Ud1-.js"),P=require("./chunks/calendar-preferences-dialog-Dn6o2r2Y.js"),t=require("react/jsx-runtime"),a=require("./chunks/switch-fIkmwzUt.js"),C=require("react"),N=require("./chunks/resource-management-panel-DytUMSGA.js"),y=require("./types/index.cjs"),_=require("./chunks/use-debounced-dirty-check-XHSwAefL.js");require("react-dom");require("./chunks/index-DRlMUglg.js");const r=require("./chunks/dashboard-briefing-launcher-BO-kXtEd.js"),S=require("./chunks/normalize-dashboard-for-dirty-check-BXRUMVb2.js");require("./chunks/index-BxM99sFL.js");function R(o){const i=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(o){for(const n in o)if(n!=="default"){const u=Object.getOwnPropertyDescriptor(o,n);Object.defineProperty(i,n,u.get?u:{enumerable:!0,get:()=>o[n]})}}return i.default=o,Object.freeze(i)}const h=R(C);function j(o){const{displayPreferences:i,cardId:n,...u}=o,s={...u,id:o.dashboardId};return t.jsx(e.ErrorBoundary,{FallbackComponent:e.Fallback,children:t.jsxs(e.SemaphorContextProvider,{dashboardProps:s,children:[t.jsx(e.SemaphorReadyIndicator,{componentType:"visual",componentId:o.cardId}),t.jsx(e.UXProvider,{appearance:o.appearance,children:t.jsx(e.DisplayPreferencesProvider,{displayPreferences:i,children:t.jsx(e.Container,{type:"visual",cardId:n,...s,children:t.jsx(w,{cardId:n})})})})]})})}function w({cardId:o}){const i=a.useDashboardStore(s=>{var c;return(c=s.dashboard)==null?void 0:c.sheets}),{card:n,frame:u}=C.useMemo(()=>{const s=i==null?void 0:i.flatMap(l=>l.frames),c=s==null?void 0:s.flatMap(l=>l==null?void 0:l.cards),D=c==null?void 0:c.find(l=>(l==null?void 0:l.id)===o),E=s==null?void 0:s.find(l=>{var p;return(p=l==null?void 0:l.cards)==null?void 0:p.find(g=>(g==null?void 0:g.id)===o)});return{card:D,frame:E}},[i,o]);return!n||!u?t.jsx(e.FallbackVisual,{error:new Error("Card not found"),resetErrorBoundary:()=>{},customerFacingMessage:`Card not found with ID: ${o}`}):t.jsx("main",{className:"flex h-full grow flex-col",children:t.jsx(e.ErrorBoundary,{FallbackComponent:({error:s,resetErrorBoundary:c})=>t.jsx(e.FallbackVisual,{error:s,resetErrorBoundary:c,customerFacingMessage:"Error creating visual. Please try again."}),children:t.jsx(e.DashboardCard,{card:n,frame:u})})})}function M(o,i,n,u){C.useEffect(()=>{o&&!n&&i&&u(e.cloneDeep(i))},[o,n,i,u])}function L({name:o,items:i,value:n,onChange:u,isLoading:s,isError:c,refetch:D,className:E,icon:l,showNone:p=!1}){const g=h.useRef(null),[b,T]=h.useState(!1),[B,A]=h.useState("100%"),x=p?[...i||[],{id:"none",name:"None"}]:i;h.useLayoutEffect(()=>{g.current&&A(g.current.offsetWidth)},[]);function F(){var f;return s?"Loading...":c?"Error":n?(f=i==null?void 0:i.find(m=>m.id===n))==null?void 0:f.name:`Select ${o}`}function v(f,m){u(m),T(!1)}return t.jsxs(a.Popover,{open:b,onOpenChange:T,children:[t.jsx(a.PopoverTrigger,{asChild:!0,children:t.jsxs(a.Button,{ref:g,variant:"outline",role:"combobox","aria-expanded":b,className:a.cn("flex h-9 w-full justify-between",E),children:[t.jsxs("div",{className:"flex items-center gap-2",children:[l&&t.jsx("div",{className:"mr-2",children:l}),t.jsx("span",{className:"max-w-[150px] overflow-hidden truncate text-ellipsis whitespace-nowrap",children:F()})]}),t.jsx(a.ChevronDown,{className:"size-4 opacity-50"})]})}),t.jsx(a.PopoverContent,{className:"w-full p-0",style:{minWidth:B},children:t.jsxs(e.Command,{children:[t.jsxs("div",{className:"flex h-9 items-center justify-between border-b pr-1",children:[t.jsx(e.CommandInput,{className:"h-9",placeholder:"Search..."}),t.jsx(e.IconButton,{className:"h-7",onClick:D,children:t.jsx(e.RefreshCw,{className:a.cn("size-3.5 opacity-50",s&&"animate-spin")})})]}),t.jsxs(e.CommandList,{children:[t.jsxs(e.CommandEmpty,{children:["No ",o==null?void 0:o.toLowerCase()," found."]}),t.jsx(e.CommandGroup,{children:x==null?void 0:x.map(f=>t.jsx(e.CommandItem,{className:"overflow-x-auto",value:f.name,onSelect:m=>v(m,f.id),children:t.jsxs("div",{className:"flex items-center gap-2",children:[t.jsx(a.Check,{className:a.cn("size-4",n===f.id?"opacity-100":"opacity-0")}),t.jsx("div",{title:f.name,children:f.name})]})},f.id))})]})]})})]})}function I(o,i){C.useEffect(()=>(o&&i&&(window.__SEMAPHOR_PRINT_STATE__={...i}),()=>{o&&window.__SEMAPHOR_PRINT_STATE__&&delete window.__SEMAPHOR_PRINT_STATE__}),[o,i])}exports.CardSummary=e.CardSummary;exports.Dashboard=e.Dashboard;exports.DashboardCreateDialogBase=e.DashboardCreateDialogBase;exports.DashboardExportDialog=e.DashboardExportDialog;exports.DashboardWC=e.DashboardWC;exports.ExportError=e.ExportError;exports.ResourceType=e.ResourceType;exports.SemaphorContextProvider=e.SemaphorContextProvider;exports.SemaphorDataProvider=e.SemaphorQueryClient;exports.SemaphorQueryClient=e.SemaphorQueryClient;exports.ShareDialog=e.ShareDialog;exports.SummaryCard=e.SummaryCard;exports.Surfboard=e.DashboardPlus;exports.cancelExport=e.cancelExport;exports.cloneDeep=e.cloneDeep;exports.createExport=e.createExport;exports.downloadDocumentPdf=e.downloadDocumentPdf;exports.downloadPdf=e.downloadPdf;exports.formatFileSize=e.formatFileSize;exports.getDownloadUrl=e.getDownloadUrl;exports.getExportStatus=e.getExportStatus;exports.getExports=e.getExports;exports.isExportComplete=e.isExportComplete;exports.isExportInProgress=e.isExportInProgress;exports.useActiveExports=e.useActiveExports;exports.useAddNewFrame=e.useAddNewFrame;exports.useCard=e.useCard;exports.useCardSummary=e.useCardSummary;exports.useDashboardById=e.useDashboardById;exports.useDashboardQuery=e.useDashboardQuery;exports.useDashboardSummary=e.useDashboardSummary;exports.useDataColumns=e.useDataColumns;exports.useDateFilterHook=e.useDateFilterHook;exports.useEditorAside=e.useEditorAside;exports.useExportActions=e.useExportActions;exports.useExportStore=e.useExportStore;exports.useInProgressExportsCount=e.useInProgressExportsCount;exports.useManagementStore=e.useManagementStore;exports.useResourceManagement=e.useResourceManagement;exports.useTextFilterHook=e.useTextFilterHook;exports.CALCULATED_FIELD_ENTITY_MARKER=d.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=d.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=d.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=d.EMPTY_SELECTION;exports.PivotMarkerEnum=d.PivotMarkerEnum;exports.getFieldRuntimeColumnName=d.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=d.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=d.hasCalculatedFormulaInputs;exports.isCalculatedDimension=d.isCalculatedDimension;exports.isCalculatedField=d.isCalculatedField;exports.isCalculatedMetric=d.isCalculatedMetric;exports.CalendarPreferencesDialog=P.CalendarPreferencesDialog;exports.createEmptyKpiConfig=a.createEmptyKpiConfig;exports.createSqlGenConfig=a.createSqlGenConfig;exports.emitDashboardLoad=a.emitDashboardLoad;exports.emitDashboardUnload=a.emitDashboardUnload;exports.fmt=a.fmt;exports.getColumnDataType=a.getColumnDataType;exports.getFilterValueType=a.getFilterValueType;exports.getFormattedTableNameForQuery=a.getFormattedTableNameForQuery;exports.getQualifiedTableName=a.getQualifiedTableName;exports.getSql=a.getSql;exports.invalidateToken=a.invalidateToken;exports.isBooleanDataType=a.isBooleanDataType;exports.isColumnInSqlGen=a.isColumnInSqlGen;exports.isDateDataType=a.isDateDataType;exports.isNumberDataType=a.isNumberDataType;exports.isTextDataType=a.isTextDataType;exports.resolveDataType=a.resolveDataType;exports.resolveDatamodelName=a.resolveDatamodelName;exports.useCurrentActiveCard=a.useCurrentActiveCard;exports.useCurrentCardConfig=a.useCurrentCardConfig;exports.useCurrentSheetActiveCards=a.useCurrentSheetActiveCards;exports.useDashboardActions=a.useDashboardActions;exports.useDashboardStore=a.useDashboardStore;exports.useEditorActions=a.useEditorActions;exports.useEditorStore=a.useEditorStore;exports.ResourceManagementPanel=N.ResourceManagementPanel;exports.DEFAULT_CALENDAR_CONTEXT=y.DEFAULT_CALENDAR_CONTEXT;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=y.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.useDebouncedDirtyCheck=_.useDebouncedDirtyCheck;exports.AdvancedModeToggle=r.AdvancedModeToggle;exports.BriefingAuthor=r.BriefingAuthor;exports.BriefingsApiError=r.BriefingsApiError;exports.DashboardBriefingLauncher=r.DashboardBriefingLauncher;exports.DashboardControlsSettings=r.DashboardControlsSettings;exports.DashboardFilterControlsButton=r.DashboardFilterControlsButton;exports.DashboardFilterControlsLauncher=r.DashboardFilterControlsLauncher;exports.DocumentControlsSettings=r.DocumentControlsSettings;exports.ExportNotificationItem=r.ExportNotificationItem;exports.ExportNotificationList=r.ExportNotificationList;exports.NotificationBell=r.NotificationBell;exports.UnsavedChangesAlert=r.UnsavedChangesAlert;exports.VisualEditingControls=r.VisualEditingControls;exports.WatchDashboardButton=r.WatchDashboardButton;exports.applyBriefingFormPatch=r.applyBriefingFormPatch;exports.briefingFormDraftToCreateRequest=r.briefingFormDraftToCreateRequest;exports.briefingFormDraftToUpdateRequest=r.briefingFormDraftToUpdateRequest;exports.briefingToFormDraft=r.briefingToFormDraft;exports.cancelBriefingRun=r.cancelBriefingRun;exports.createBriefing=r.createBriefing;exports.createBriefingFormDraft=r.createBriefingFormDraft;exports.deleteBriefing=r.deleteBriefing;exports.deleteBriefingRun=r.deleteBriefingRun;exports.getBriefing=r.getBriefing;exports.getBriefingArtifact=r.getBriefingArtifact;exports.getBriefingEvidence=r.getBriefingEvidence;exports.getBriefingPreviewRun=r.getBriefingPreviewRun;exports.getBriefingRun=r.getBriefingRun;exports.listBriefingRuns=r.listBriefingRuns;exports.listBriefingTenantSummaries=r.listBriefingTenantSummaries;exports.listBriefings=r.listBriefings;exports.pauseBriefing=r.pauseBriefing;exports.polishBriefingText=r.polishBriefingText;exports.previewBriefingPlan=r.previewBriefingPlan;exports.resumeBriefing=r.resumeBriefing;exports.runBriefingNow=r.runBriefingNow;exports.runBriefingPreview=r.runBriefingPreview;exports.updateBriefing=r.updateBriefing;exports.useExportPolling=r.useExportPolling;exports.useExportRecovery=r.useExportRecovery;exports.validateBriefingFormDraft=r.validateBriefingFormDraft;exports.normalizeDashboardForDirtyCheck=S.normalizeDashboardForDirtyCheck;exports.serializeDashboardForDirtyCheck=S.serializeDashboardForDirtyCheck;exports.Combobox=L;exports.Visual=j;exports.useExposePrintState=I;exports.usePristineSnapshotInitializer=M;

package/dist/index.js

@@ -1,18 +1,18 @@
-import { E as T, F as N, S, p as P, U as _, q as w, r as F, s as x, t as R, v as I, C as M, h as L, I as k, w as U, i as O, j as z, k as V, l as q } from "./chunks/index-CPyEi9gS.js";
-import { V as ca, D as fa, Q as ma, P as pa, M as ha, a8 as ga, z as Ca, G as Da, G as Ea, H as xa, T as Ta, a as ba, a7 as ya, a3 as va, O as Aa, N as Ba, ab as Na, a6 as Sa, a5 as Pa, a4 as _a, aa as wa, a9 as Fa, a0 as Ra, Z as Ia, L as Ma, X as La, K as ka, y as Ua, W as Oa, Y as za, A as Va, a2 as qa, $ as Ha, _ as Wa, a1 as ja, x as Ga, J as Qa, B as Ka } from "./chunks/index-CPyEi9gS.js";
+import { E as T, F as N, S, p as P, U as _, q as w, r as F, s as x, t as R, v as I, C as M, h as L, I as k, w as U, i as O, j as z, k as V, l as q } from "./chunks/index-C0Qnfr_7.js";
+import { V as ca, D as fa, Q as ma, P as pa, M as ha, a8 as ga, z as Ca, G as Da, G as Ea, H as xa, T as Ta, a as ba, a7 as ya, a3 as va, O as Aa, N as Ba, ab as Na, a6 as Sa, a5 as Pa, a4 as _a, aa as wa, a9 as Fa, a0 as Ra, Z as Ia, L as Ma, X as La, K as ka, y as Ua, W as Oa, Y as za, A as Va, a2 as qa, $ as Ha, _ as Wa, a1 as ja, x as Ga, J as Qa, B as Ka } from "./chunks/index-C0Qnfr_7.js";
 import { a as Ya, C as $a, D as Ja, E as Za, P as ae, g as ee, d as se, h as re, b as oe, c as te, i as ne } from "./chunks/common-types-4bjoIgvm.js";
-import { C as le } from "./chunks/calendar-preferences-dialog-6q51A6XC.js";
+import { C as le } from "./chunks/calendar-preferences-dialog-ClBAkMmF.js";
 import { jsx as a, jsxs as d } from "react/jsx-runtime";
 import { u as H, P as W, b as j, B as G, a as C, g as Q, d as K, e as X } from "./chunks/switch-Dkx2qEOr.js";
 import { F as ue, q as ce, h as fe, i as me, k as pe, s as he, r as ge, w as Ce, x as De, p as Ee, j as xe, o as Te, t as be, n as ye, m as ve, l as Ae, y as Be, v as Ne, z as Se, D as Pe, A as _e, E as we, H as Fe, G as Re } from "./chunks/switch-Dkx2qEOr.js";
 import * as m from "react";
 import { useMemo as Y, useEffect as b } from "react";
-import { ResourceManagementPanel as Me } from "./chunks/resource-management-panel-mJ84NxzC.js";
+import { ResourceManagementPanel as Me } from "./chunks/resource-management-panel-YvIfaphX.js";
 import { DEFAULT_CALENDAR_CONTEXT as ke, DEFAULT_SEMANTIC_DOMAIN_ACCESS as Ue } from "./types/index.js";
 import { u as ze } from "./chunks/use-debounced-dirty-check-BwAbnX_5.js";
 import "react-dom";
 import "./chunks/index-CJdxSyQq.js";
-import { A as qe, J as He, B as We, K as je, D as Ge, d as Qe, e as Ke, c as Xe, a as Ye, E as $e, N as Je, U as Ze, V as as, W as es, C as ss, G as rs, H as os, F as ts, t as ns, h as is, z as ls, j as ds, v as us, g as cs, w as fs, x as ms, o as ps, s as hs, q as gs, f as Cs, l as Ds, p as Es, y as xs, m as Ts, r as bs, k as ys, n as vs, i as As, u as Bs, b as Ns, I as Ss } from "./chunks/dashboard-briefing-launcher-ptERmNJr.js";
+import { A as qe, J as He, B as We, K as je, D as Ge, d as Qe, e as Ke, c as Xe, a as Ye, E as $e, N as Je, U as Ze, V as as, W as es, C as ss, G as rs, H as os, F as ts, t as ns, h as is, z as ls, j as ds, v as us, g as cs, w as fs, x as ms, o as ps, s as hs, q as gs, f as Cs, l as Ds, p as Es, y as xs, m as Ts, r as bs, k as ys, n as vs, i as As, u as Bs, b as Ns, I as Ss } from "./chunks/dashboard-briefing-launcher-D3Xfc_26.js";
 import { n as _s, s as ws } from "./chunks/normalize-dashboard-for-dirty-check-5KpZN8xr.js";
 import "./chunks/index-CuHybtft.js";
 function ta(e) {

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/index-BtqYNH_S.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-CUGzkNcE.js");exports.Surfboard=r.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.CalendarPreferencesDialog=a.CalendarPreferencesDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/index-DlLvzmJF.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-Dn6o2r2Y.js");exports.Surfboard=r.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.CalendarPreferencesDialog=a.CalendarPreferencesDialog;

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { a as e } from "../chunks/index-CPyEi9gS.js";
+import { a as e } from "../chunks/index-C0Qnfr_7.js";
 import { C, E } from "../chunks/common-types-4bjoIgvm.js";
-import { C as s } from "../chunks/calendar-preferences-dialog-6q51A6XC.js";
+import { C as s } from "../chunks/calendar-preferences-dialog-ClBAkMmF.js";
 export {
   C as CONTROL_CARD_DEFAULT_VALUE,
   s as CalendarPreferencesDialog,

package/dist/types/analytics-protocol.d.ts

@@ -789,12 +789,51 @@ export declare type SemaphorDashboardViewIntent = {
     text?: string;
 };
 
+export declare type SemaphorDerivedFieldAggregationBehavior = 'additive' | 'non_additive' | 'ratio_of_sums' | 'weighted' | 'pre_aggregated' | 'snapshot';
+
+export declare type SemaphorDerivedFieldAggregationStrategy = 'default' | 'symmetric_aggregate' | 'aggregate_then_join' | 'weighted';
+
+export declare type SemaphorDerivedFieldComputeStage = 'row' | 'aggregate';
+
+export declare type SemaphorDerivedFieldDefinition = {
+    kind: 'derived_field';
+    name: string;
+    label: string;
+    description?: string;
+    resultRole: SemaphorDerivedFieldResultRole;
+    dataType: NonNullable<SemaphorFieldRef['dataType']>;
+    computeStage: SemaphorDerivedFieldComputeStage;
+    expression: string;
+    expressionLanguage?: 'semaphor_sql_template';
+    inputs: Record<string, SemaphorDerivedFieldInput>;
+    defaultAggregate?: SemaphorAggregateFunction;
+    aggregationBehavior?: SemaphorDerivedFieldAggregationBehavior;
+    aggregationStrategy?: SemaphorDerivedFieldAggregationStrategy;
+    format?: unknown;
+    tags?: string[];
+};
+
+export declare type SemaphorDerivedFieldInput = {
+    kind: 'field';
+    field: SemaphorFieldRef;
+    aggregate?: SemaphorAggregateFunction;
+} | {
+    kind: 'metric';
+    metric: SemaphorFieldRef;
+} | {
+    kind: 'dimension';
+    dimension: SemaphorFieldRef;
+};
+
+export declare type SemaphorDerivedFieldResultRole = 'measure' | 'group' | 'date' | 'id' | 'filter';
+
 export declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 export declare type SemaphorExecutionFieldRef = SemaphorFieldRef & {
     semanticAggregate?: SemaphorAggregateFunction;
     effectiveAggregate?: SemaphorAggregateFunction;
     aggregateSource?: SemaphorMetricAggregateSource;
+    derivedField?: SemaphorDerivedFieldDefinition;
 };
 
 export declare type SemaphorExperienceIntent = SemaphorDashboardIntent;
@@ -841,6 +880,7 @@ export declare type SemaphorInputOptionsIntent = {
     field: SemaphorFieldRef;
     search?: string;
     limit?: number;
+    derivedFields?: SemaphorDerivedFieldDefinition[];
 };
 
 export declare type SemaphorInputOptionsResult = SemaphorAnalyticsResultBase & {
@@ -1059,6 +1099,7 @@ export declare type SemaphorMetricIntent = {
     };
     inputs?: SemaphorInputBinding[];
     limit?: number;
+    derivedFields?: SemaphorDerivedFieldDefinition[];
 };
 
 export declare type SemaphorMetricResult = SemaphorAnalyticsResultBase & {
@@ -1135,6 +1176,7 @@ export declare type SemaphorRecordsIntent = {
         direction: 'asc' | 'desc';
     };
     inputs?: SemaphorInputBinding[];
+    derivedFields?: SemaphorDerivedFieldDefinition[];
 };
 
 export declare type SemaphorRecordsResult = SemaphorAnalyticsResultBase & {
@@ -1180,6 +1222,44 @@ export declare type SemaphorRelativeTimeWindow = {
     completeness?: 'include_partial' | 'complete_periods';
 };
 
+export declare type SemaphorResultCalculation = {
+    id: string;
+    label: string;
+    kind: 'percent_of_total';
+    input: SemaphorResultColumnRef;
+    denominator?: SemaphorResultCalculationDenominator;
+    output: SemaphorResultCalculationOutput;
+} | {
+    id: string;
+    label: string;
+    kind: 'rank';
+    input: SemaphorResultColumnRef;
+    order?: 'asc' | 'desc';
+    output: SemaphorResultCalculationOutput;
+} | {
+    id: string;
+    label: string;
+    kind: 'running_total' | 'previous_row_delta';
+    input: SemaphorResultColumnRef;
+    orderBy?: SemaphorResultColumnRef;
+    output: SemaphorResultCalculationOutput;
+};
+
+export declare type SemaphorResultCalculationDenominator = {
+    scope: 'returned_result';
+} | {
+    scope: 'population';
+    metric: SemaphorFieldRef;
+    filters?: SemaphorAnalyticsFilter[];
+};
+
+export declare type SemaphorResultCalculationOutput = {
+    key: string;
+    label?: string;
+    dataType?: SemaphorFieldRef['dataType'];
+    format?: unknown;
+};
+
 export declare type SemaphorResultColumn = {
     /**
      * Stable row accessor for this result. Consumers should read values with
@@ -1198,6 +1278,13 @@ export declare type SemaphorResultColumn = {
     dataType?: SemaphorFieldRef['dataType'];
     aggregate?: SemaphorFieldRef['aggregate'];
     source?: SemaphorFieldRef['source'];
+    derivedField?: SemaphorDerivedFieldDefinition;
+};
+
+export declare type SemaphorResultColumnRef = {
+    columnKey: string;
+} | {
+    field: SemaphorFieldRef;
 };
 
 export declare type SemaphorSemanticSourceRef = Extract<SemaphorSourceRef, {
@@ -1306,6 +1393,10 @@ export declare function validateSemaphorAnalyticsRecoveryPlan(plan: SemaphorAnal
 
 export declare function validateSemaphorDashboardIntent(intent: SemaphorDashboardIntent): SemaphorValidationResult;
 
+export declare function validateSemaphorDerivedFieldDefinition(definition: SemaphorDerivedFieldDefinition): SemaphorValidationResult;
+
 export declare function validateSemaphorOperationIntent(intent: SemaphorOperationIntent): SemaphorAnalyticsValidationResult;
 
+export declare function validateSemaphorResultCalculation(calculation: SemaphorResultCalculation): SemaphorValidationResult;
+
 export { }