react-semaphor 0.1.337 → 0.1.339

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chunks/index-DE0vIuYG.js"),d=require("./chunks/common-types-C73-Ud1-.js"),P=require("./chunks/calendar-preferences-dialog-Bm7ji3k9.js"),t=require("react/jsx-runtime"),a=require("./chunks/switch-CyRoZr5T.js"),C=require("react"),N=require("./chunks/resource-management-panel-P9iNqBM1.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-BtqtLx1-.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-DT9osgRT.js"),d=require("./chunks/common-types-C73-Ud1-.js"),P=require("./chunks/calendar-preferences-dialog-8-KE5sVX.js"),t=require("react/jsx-runtime"),a=require("./chunks/switch-DYRgERrC.js"),C=require("react"),N=require("./chunks/resource-management-panel-ByR-FD3h.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-CcqDPVke.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, q as P, U as _, r as w, s as F, t as x, v as R, w as I, C as M, i as L, I as k, x as U, j as O, k as z, l as V, m as H } from "./chunks/index-DzyUhzV3.js";
-import { W as ca, D as fa, T as ma, Q as pa, N as ha, a9 as ga, A as Ca, H as Da, H as Ea, J as xa, V as Ta, a as ba, a8 as ya, a4 as va, P as Aa, O as Ba, ac as Na, a7 as Sa, a6 as Pa, a5 as _a, ab as wa, aa as Fa, a1 as Ra, _ as Ia, M as Ma, Y as La, L as ka, z as Ua, X as Oa, Z as za, B as Va, a3 as Ha, a0 as qa, $ as Wa, a2 as ja, y as Ga, K as Qa, G as Ka } from "./chunks/index-DzyUhzV3.js";
+import { E as T, F as N, S, q as P, U as _, r as w, s as F, t as x, v as R, w as I, C as M, i as L, I as k, x as U, j as O, k as z, l as V, m as H } from "./chunks/index-DVPvpd8u.js";
+import { W as ca, D as fa, T as ma, Q as pa, N as ha, a9 as ga, A as Ca, H as Da, H as Ea, J as xa, V as Ta, a as ba, a8 as ya, a4 as va, P as Aa, O as Ba, ac as Na, a7 as Sa, a6 as Pa, a5 as _a, ab as wa, aa as Fa, a1 as Ra, _ as Ia, M as Ma, Y as La, L as ka, z as Ua, X as Oa, Z as za, B as Va, a3 as Ha, a0 as qa, $ as Wa, a2 as ja, y as Ga, K as Qa, G as Ka } from "./chunks/index-DVPvpd8u.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-Cocogo9H.js";
+import { C as le } from "./chunks/calendar-preferences-dialog-2IbYrrP1.js";
 import { jsx as a, jsxs as d } from "react/jsx-runtime";
-import { u as q, P as W, b as j, B as G, a as C, g as Q, d as K, e as X } from "./chunks/switch-BAYfpAEb.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-BAYfpAEb.js";
+import { u as q, P as W, b as j, B as G, a as C, g as Q, d as K, e as X } from "./chunks/switch-CP7SmEIZ.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-CP7SmEIZ.js";
 import * as m from "react";
 import { useMemo as Y, useEffect as b } from "react";
-import { ResourceManagementPanel as Me } from "./chunks/resource-management-panel-C4YydU9I.js";
+import { ResourceManagementPanel as Me } from "./chunks/resource-management-panel-98Hy6SYB.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 He, J as qe, 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-DF4CoaRn.js";
+import { A as He, J as qe, 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-DtxDRAiu.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-DE0vIuYG.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-Bm7ji3k9.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-DT9osgRT.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-8-KE5sVX.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-DzyUhzV3.js";
+import { a as e } from "../chunks/index-DVPvpd8u.js";
 import { C, E } from "../chunks/common-types-4bjoIgvm.js";
-import { C as s } from "../chunks/calendar-preferences-dialog-Cocogo9H.js";
+import { C as s } from "../chunks/calendar-preferences-dialog-2IbYrrP1.js";
 export {
   C as CONTROL_CARD_DEFAULT_VALUE,
   s as CalendarPreferencesDialog,

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

@@ -62,8 +62,6 @@ export declare function getSemaphorConnectionCapabilities(connectionType: string
     connectionId?: string;
 }): SemaphorConnectionCapabilities;
 
-export declare function inferAnalyticsMetricFormat(field: AnalyticsCatalogField): AnalyticsMetricFormat | undefined;
-
 export declare function isAnalyticsCatalogDateField(field: AnalyticsCatalogField): boolean;
 
 export declare function isAnalyticsCatalogDimensionField(field: AnalyticsCatalogField): boolean;
@@ -84,6 +82,10 @@ export declare function normalizeAnalyticsCatalogName(value: unknown): string;
 
 export declare function normalizeSemaphorDialect(input: string | undefined): SemaphorDialect;
 
+export declare function preferSemaphorFieldRefMetadata(current: SemaphorFieldRef, next: SemaphorFieldRef): SemaphorFieldRef;
+
+export declare function preferSemaphorSourceMetadata(current: SemaphorSourceRef, next: SemaphorSourceRef): SemaphorSourceRef;
+
 export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
     revenueKpi: {
         version: 1;
@@ -97,8 +99,14 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
             readonly connectionId: "conn_sales";
             readonly label: "Orders";
         };
-        metrics: string[];
-        primaryMetric: string;
+        metrics: {
+            name: string;
+            role: "measure";
+        }[];
+        primaryMetric: {
+            name: string;
+            role: "measure";
+        };
         comparison: {
             kind: "previous_period";
         };
@@ -116,13 +124,17 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
             readonly connectionId: "conn_sales";
             readonly label: "Orders";
         };
-        fields: {
+        fields: ({
             name: string;
             role: "date";
             dataType: "date";
             label: string;
-        }[];
-        measures: string[];
+        } | {
+            name: string;
+            role: "measure";
+            dataType: "number";
+            label?: undefined;
+        })[];
         dateField: {
             name: string;
             role: "date";
@@ -152,9 +164,11 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
             role: "measure";
             dataType: "number";
         })[];
-        measures: string[];
         orderBy: {
-            field: string;
+            field: {
+                name: string;
+                role: "measure";
+            };
             direction: "desc";
         };
         limit: number;
@@ -190,8 +204,14 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
             readonly connectionId: "conn_sales";
             readonly label: "Orders";
         };
-        metrics: string[];
-        primaryMetric: string;
+        metrics: {
+            name: string;
+            role: "measure";
+        }[];
+        primaryMetric: {
+            name: string;
+            role: "measure";
+        };
         dateField: {
             name: string;
             role: "date";
@@ -215,8 +235,14 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
             readonly connectionId: "conn_sales";
             readonly label: "Orders";
         };
-        metrics: string[];
-        primaryMetric: string;
+        metrics: {
+            name: string;
+            role: "measure";
+        }[];
+        primaryMetric: {
+            name: string;
+            role: "measure";
+        };
         dateField: {
             name: string;
             role: "date";
@@ -239,7 +265,7 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
                 dataType: "string";
             };
             operator: "=";
-            value: string;
+            values: string[];
         }[];
         limit: number;
     };
@@ -249,11 +275,8 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
         id: string;
         label: string;
         source: {
-            kind: "physical";
+            kind: "sql";
             connectionId: string;
-            databaseName: string;
-            schemaName: string;
-            tableName: string;
             dialect: "postgres";
         };
         sql: string;
@@ -271,17 +294,6 @@ export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
     };
 };
 
-export declare type SemaphorAgentFilterInput = {
-    id?: string;
-    field: string | SemaphorFieldRef;
-    operator?: SemaphorAgentFilterInputOperator;
-    operation?: SemaphorAgentFilterInputOperator | string;
-    value?: unknown;
-    values?: unknown[];
-};
-
-export declare type SemaphorAgentFilterInputOperator = SemaphorAnalyticsFilterOperator | 'equals' | 'eq' | 'not_equals' | 'neq' | 'like' | 'not_like' | 'not in' | 'not contains' | 'not between' | 'is_null' | 'is_not_null' | 'is null' | 'is not null';
-
 export declare type SemaphorAnalyticsExecutionResult = {
     intentId?: string;
     queryId?: string;
@@ -308,12 +320,11 @@ export declare type SemaphorAnalyticsExecutionStatus = 'answered' | 'partial' |
 
 export declare type SemaphorAnalyticsFieldRole = 'metric' | 'dateField' | 'dimension' | 'input' | 'source' | 'sql';
 
-export declare type SemaphorAnalyticsFilter = {
+export declare type SemaphorAnalyticsFilter = SemaphorAnalyticsValueFilter | SemaphorAnalyticsNullFilter;
+
+export declare type SemaphorAnalyticsFilterBase = {
     id?: string;
     field: SemaphorFieldRef;
-    operator?: SemaphorAnalyticsFilterOperator;
-    value?: unknown;
-    values?: unknown[];
 };
 
 export declare type SemaphorAnalyticsFilterOperator = SemaphorInputOperator | 'not_contains' | 'is_null' | 'is_not_null';
@@ -322,6 +333,13 @@ export declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRec
 
 export declare type SemaphorAnalyticsIntentFixtureName = keyof typeof SEMAPHOR_ANALYTICS_INTENT_FIXTURES;
 
+export declare type SemaphorAnalyticsNullFilter = SemaphorAnalyticsFilterBase & {
+    operator: SemaphorAnalyticsNullFilterOperator;
+    values?: never;
+};
+
+export declare type SemaphorAnalyticsNullFilterOperator = 'is_null' | 'is_not_null';
+
 export declare type SemaphorAnalyticsObligation = {
     id: string;
     type: SemaphorAnalyticsObligationType;
@@ -334,8 +352,7 @@ export declare type SemaphorAnalyticsObligation = {
     displayFieldCandidates?: string[];
     requiredFieldCandidates?: string[];
     limit?: number;
-    timeWindowDays?: number;
-    timeWindowMonths?: number;
+    timeWindow?: SemaphorTimeWindow;
     comparison?: 'same_period_last_year' | 'previous_period';
     required?: boolean;
 };
@@ -397,6 +414,13 @@ export declare type SemaphorAnalyticsValidationResult = {
     repairHints: SemaphorAnalyticsRepairHint[];
 };
 
+export declare type SemaphorAnalyticsValueFilter = SemaphorAnalyticsFilterBase & {
+    operator?: SemaphorAnalyticsValueFilterOperator;
+    values: unknown[];
+};
+
+export declare type SemaphorAnalyticsValueFilterOperator = Exclude<SemaphorAnalyticsFilterOperator, 'is_null' | 'is_not_null'>;
+
 export declare type SemaphorCompiledQuery = {
     kind: 'config';
     queryId: string;
@@ -405,21 +429,21 @@ export declare type SemaphorCompiledQuery = {
     connectionId: string;
     cardConfig: unknown;
     cardDataSource: unknown;
-    activeFilters?: unknown[];
+    activeFilters?: SemaphorAnalyticsFilter[];
     rowLimit: number;
     analyticsIntent?: SemaphorAnalyticsIntent;
 } | {
     kind: 'sql';
     queryId: string;
     source: Extract<SemaphorSourceRef, {
-        kind: 'physical' | 'sql';
+        kind: 'sql';
     }>;
     connectionId: string;
     dialect: SemaphorDialect;
     sql: string;
     parameters?: Record<string, unknown>;
     pythonCode?: string;
-    activeFilters?: unknown[];
+    activeFilters?: SemaphorAnalyticsFilter[];
     rowLimit: number;
     analyticsIntent?: SemaphorAnalyticsIntent;
 };
@@ -459,7 +483,7 @@ export declare type SemaphorDashboardViewIntent = {
     text?: string;
 };
 
-export declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+export declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 export declare type SemaphorExperienceIntent = SemaphorDashboardIntent;
 
@@ -471,6 +495,8 @@ export declare type SemaphorFieldRef = {
     source?: SemaphorSourceRef;
 };
 
+export declare function semaphorFieldRefsMatch(left: SemaphorFieldRef, right: SemaphorFieldRef): boolean;
+
 export declare type SemaphorInputBinding = {
     inputId: string;
     field?: SemaphorFieldRef;
@@ -518,7 +544,6 @@ export declare type SemaphorInputSpec = {
     operator?: SemaphorInputOperator;
     multi?: boolean;
     defaultValue?: unknown;
-    source?: SemaphorSourceRef;
     scope?: SemaphorInputScope;
 };
 
@@ -534,9 +559,8 @@ export declare type SemaphorMetricIntent = {
     version?: SemaphorProtocolVersion;
     id?: string;
     source: SemaphorSourceRef;
-    metrics: string[];
-    primaryMetric?: string;
-    metricRefs?: SemaphorFieldRef[];
+    metrics: SemaphorFieldRef[];
+    primaryMetric?: SemaphorFieldRef;
     label?: string;
     dateField?: SemaphorFieldRef;
     timeGrain?: SemaphorTimeGrain;
@@ -601,12 +625,11 @@ export declare type SemaphorRecordsIntent = {
     id?: string;
     label?: string;
     fields: SemaphorFieldRef[];
-    measures?: string[];
     dateField?: SemaphorFieldRef;
     timeGrain?: SemaphorTimeGrain;
     limit?: number;
     orderBy?: {
-        field: string;
+        field: SemaphorFieldRef;
         direction: 'asc' | 'desc';
     };
     inputs?: SemaphorInputBinding[];
@@ -662,6 +685,8 @@ export declare function semaphorSourceHasRequiredCoordinates(input: {
     source: SemaphorSourceCoordinateInput;
 }): boolean;
 
+export declare function semaphorSourceIdentityKey(source: SemaphorSourceRef | undefined): string;
+
 export declare type SemaphorSourceLevel = 'database' | 'schema' | 'table';
 
 export declare type SemaphorSourceRef = {
@@ -683,20 +708,21 @@ export declare type SemaphorSourceRef = {
 } | {
     kind: 'sql';
     connectionId: string;
-    sql: string;
     dialect?: SemaphorDialect;
     label?: string;
 };
 
+export declare function semaphorSourcesReferToSameDataset(left: SemaphorSourceRef | undefined, right: SemaphorSourceRef | undefined): boolean;
+
 export declare type SemaphorSqlIntent = {
     kind: 'sql';
     version?: SemaphorProtocolVersion;
     id?: string;
     label?: string;
     source: Extract<SemaphorSourceRef, {
-        kind: 'sql' | 'physical';
+        kind: 'sql';
     }>;
-    sql?: string;
+    sql: string;
     parameters?: Record<string, unknown>;
     pythonCode?: string;
     limit?: number;

package/dist/types/dashboard-authoring.d.ts

@@ -127,6 +127,13 @@ declare interface CardConfig {
     pivotByColumns?: PivotByField[];
     sortByColumns?: SortByField[];
     detailColumns?: DetailField[];
+    /**
+     * Typed source that anchors the query before auto-join materializes an
+     * executable joinPlan.baseEntity. This is distinct from
+     * DataSource.selectedEntities, which lists available datasets but does not
+     * define join-root semantics.
+     */
+    queryBaseSource?: SemaphorSourceRef;
     /** Preserves non-detail config when switching to detail tables. */
     detailTableBackup?: DetailTableBackupConfig;
     filters?: FilterGroup;
@@ -498,22 +505,6 @@ export declare type DashboardAuthoringBreakpoint = (typeof DASHBOARD_AUTHORING_B
 
 export declare function dashboardAuthoringDatasetMatchesSource(dataset: unknown, source: SemaphorSourceRef | undefined): boolean;
 
-export declare type DashboardAuthoringDatasetRef = {
-    kind: 'semantic';
-    domainId: string;
-    datasetName: string;
-    datasetId?: string;
-    label?: string;
-    connectionId?: string;
-} | {
-    kind: 'physical';
-    connectionId: string;
-    databaseName?: string;
-    schemaName?: string;
-    tableName: string;
-    label?: string;
-};
-
 export declare type DashboardAuthoringDatasetScopeIssue = 'invalid_dataset_count' | 'invalid_multi_dataset_scope';
 
 export declare type DashboardAuthoringDatasetScopeResult = {
@@ -544,24 +535,6 @@ export declare type DashboardAuthoringValidationResult = {
     warnings: DashboardPlanWarning[];
 };
 
-export declare type DashboardCardQueryFieldRef = {
-    name: string;
-    source?: DashboardAuthoringDatasetRef;
-};
-
-export declare type DashboardCardQueryIntent = {
-    metrics?: string[];
-    primaryMetric?: string;
-    metricRefs?: DashboardCardQueryFieldRef[];
-    dateField?: string;
-    dateFieldRef?: DashboardCardQueryFieldRef;
-    timeGrain?: 'day' | 'week' | 'month' | 'quarter' | 'year';
-    dimensions?: string[];
-    dimensionRefs?: DashboardCardQueryFieldRef[];
-    filters?: SemaphorAnalyticsFilter[];
-    limit?: number;
-};
-
 export declare type DashboardCardSizeIntent = 'kpi' | 'chart' | 'table' | 'text';
 
 export declare type DashboardChangeCompileResult = {
@@ -603,7 +576,7 @@ export declare type DashboardChangePlan = {
     dashboardId: string;
     title?: string;
     description?: string;
-    datasets: DashboardAuthoringDatasetRef[];
+    datasets: SemaphorSourceRef[];
     operations: DashboardChangeOperation[];
     warnings?: DashboardPlanWarning[];
     unresolvedRequests?: string[];
@@ -731,7 +704,7 @@ export declare type DashboardPlan = {
     id: string;
     title: string;
     description?: string;
-    datasets: DashboardAuthoringDatasetRef[];
+    datasets: SemaphorSourceRef[];
     sheets: DashboardPlanSheet[];
     filterInputs?: DashboardPlanFilterInput[];
     calculatedFields?: DashboardPlanCalculatedField[];
@@ -759,7 +732,6 @@ export declare type DashboardPlanCard = {
     role: DashboardCardSizeIntent;
     priority: number;
     section?: string;
-    query?: DashboardCardQueryIntent;
     analyticsIntent?: SemaphorAnalyticsIntent;
     text?: string;
 };
@@ -1434,7 +1406,7 @@ declare type FilterSemanticContext = {
 
 declare type FilterValue = string | number | boolean | Date | null | [number, number] | [string, string] | string[] | number[];
 
-export declare function findDashboardAuthoringDatasetForSource(datasets: readonly DashboardAuthoringDatasetRef[], source: SemaphorSourceRef | undefined): DashboardAuthoringDatasetRef | undefined;
+export declare function findDashboardAuthoringDatasetForSource(datasets: readonly SemaphorSourceRef[], source: SemaphorSourceRef | undefined): SemaphorSourceRef | undefined;
 
 /**
  * Absolute fixed month/year default used by Month Picker defaults.
@@ -1829,18 +1801,31 @@ declare type SelectedEntities = SelectedEntity[];
 
 declare type SelectedEntity = DatabaseEntityReference | DataModelEntityReference | DatasetEntityReference | FileEntityReference;
 
-declare type SemaphorAnalyticsFilter = {
+declare type SemaphorAnalyticsFilter = SemaphorAnalyticsValueFilter | SemaphorAnalyticsNullFilter;
+
+declare type SemaphorAnalyticsFilterBase = {
     id?: string;
     field: SemaphorFieldRef;
-    operator?: SemaphorAnalyticsFilterOperator;
-    value?: unknown;
-    values?: unknown[];
 };
 
 declare type SemaphorAnalyticsFilterOperator = SemaphorInputOperator | 'not_contains' | 'is_null' | 'is_not_null';
 
 declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRecordsIntent | SemaphorInputOptionsIntent | SemaphorSqlIntent;
 
+declare type SemaphorAnalyticsNullFilter = SemaphorAnalyticsFilterBase & {
+    operator: SemaphorAnalyticsNullFilterOperator;
+    values?: never;
+};
+
+declare type SemaphorAnalyticsNullFilterOperator = 'is_null' | 'is_not_null';
+
+declare type SemaphorAnalyticsValueFilter = SemaphorAnalyticsFilterBase & {
+    operator?: SemaphorAnalyticsValueFilterOperator;
+    values: unknown[];
+};
+
+declare type SemaphorAnalyticsValueFilterOperator = Exclude<SemaphorAnalyticsFilterOperator, 'is_null' | 'is_not_null'>;
+
 declare type SemaphorDashboardIntent = {
     version: SemaphorProtocolVersion;
     kind: 'dashboard';
@@ -1866,7 +1851,7 @@ declare type SemaphorDashboardViewIntent = {
     text?: string;
 };
 
-declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 declare type SemaphorFieldRef = {
     name: string;
@@ -1914,7 +1899,6 @@ declare type SemaphorInputSpec = {
     operator?: SemaphorInputOperator;
     multi?: boolean;
     defaultValue?: unknown;
-    source?: SemaphorSourceRef;
     scope?: SemaphorInputScope;
 };
 
@@ -1930,9 +1914,8 @@ declare type SemaphorMetricIntent = {
     version?: SemaphorProtocolVersion;
     id?: string;
     source: SemaphorSourceRef;
-    metrics: string[];
-    primaryMetric?: string;
-    metricRefs?: SemaphorFieldRef[];
+    metrics: SemaphorFieldRef[];
+    primaryMetric?: SemaphorFieldRef;
     label?: string;
     dateField?: SemaphorFieldRef;
     timeGrain?: SemaphorTimeGrain;
@@ -1957,12 +1940,11 @@ declare type SemaphorRecordsIntent = {
     id?: string;
     label?: string;
     fields: SemaphorFieldRef[];
-    measures?: string[];
     dateField?: SemaphorFieldRef;
     timeGrain?: SemaphorTimeGrain;
     limit?: number;
     orderBy?: {
-        field: string;
+        field: SemaphorFieldRef;
         direction: 'asc' | 'desc';
     };
     inputs?: SemaphorInputBinding[];
@@ -1987,7 +1969,6 @@ declare type SemaphorSourceRef = {
 } | {
     kind: 'sql';
     connectionId: string;
-    sql: string;
     dialect?: SemaphorDialect;
     label?: string;
 };
@@ -1998,9 +1979,9 @@ declare type SemaphorSqlIntent = {
     id?: string;
     label?: string;
     source: Extract<SemaphorSourceRef, {
-        kind: 'sql' | 'physical';
+        kind: 'sql';
     }>;
-    sql?: string;
+    sql: string;
     parameters?: Record<string, unknown>;
     pythonCode?: string;
     limit?: number;

package/dist/types/dashboard.d.ts

@@ -204,6 +204,13 @@ declare interface CardConfig {
     pivotByColumns?: PivotByField[];
     sortByColumns?: SortByField[];
     detailColumns?: DetailField[];
+    /**
+     * Typed source that anchors the query before auto-join materializes an
+     * executable joinPlan.baseEntity. This is distinct from
+     * DataSource.selectedEntities, which lists available datasets but does not
+     * define join-root semantics.
+     */
+    queryBaseSource?: SemaphorSourceRef;
     /** Preserves non-detail config when switching to detail tables. */
     detailTableBackup?: DetailTableBackupConfig;
     filters?: FilterGroup;
@@ -1898,6 +1905,31 @@ declare type SemanticExecutionPayload = {
     }>;
 };
 
+declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+
+declare type SemaphorSourceRef = {
+    kind: 'semantic';
+    domainId: string;
+    datasetName: string;
+    datasetId?: string;
+    label?: string;
+    connectionId?: string;
+} | {
+    kind: 'physical';
+    connectionId: string;
+    connectionType?: string;
+    tableName: string;
+    databaseName?: string;
+    schemaName?: string;
+    label?: string;
+    dialect?: SemaphorDialect;
+} | {
+    kind: 'sql';
+    connectionId: string;
+    dialect?: SemaphorDialect;
+    label?: string;
+};
+
 declare interface SortByField extends Field {
     role: 'sortby';
     direction: 'asc' | 'desc';