react-semaphor 0.1.425 → 0.1.426

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chunks/dashboard-MKIqgGDp.js"),d=require("./chunks/common-types-C73-Ud1-.js"),P=require("./chunks/calendar-preferences-dialog-BLaSWhLl.js"),i=require("react/jsx-runtime"),r=require("./chunks/code-editor-CkXyNgYc.js"),h=require("react"),B=require("./types/index.cjs"),l=require("./chunks/dashboard-briefing-launcher-CII8-4qo.js"),N=require("./chunks/use-debounced-dirty-check-XHSwAefL.js");require("./chunks/analyze-result-contract-ege_u6Nl.js");require("react-dom");require("./chunks/index-Dpm_VET4.js");const y=require("./chunks/normalize-dashboard-for-dirty-check-BXRUMVb2.js"),_=require("./chunks/index-jSrCwPQz.js");function R(a){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(a){for(const o in a)if(o!=="default"){const u=Object.getOwnPropertyDescriptor(a,o);Object.defineProperty(t,o,u.get?u:{enumerable:!0,get:()=>a[o]})}}return t.default=a,Object.freeze(t)}const C=R(h);function w(a){const{displayPreferences:t,cardId:o,...u}=a,n={...u,id:a.dashboardId};return i.jsx(e.ErrorBoundary,{FallbackComponent:e.Fallback,children:i.jsxs(e.SemaphorContextProvider,{dashboardProps:n,children:[i.jsx(e.SemaphorReadyIndicator,{componentType:"visual",componentId:a.cardId}),i.jsx(e.UXProvider,{appearance:a.appearance,children:i.jsx(e.DisplayPreferencesProvider,{displayPreferences:t,children:i.jsx(e.Container,{type:"visual",cardId:o,...n,children:i.jsx(j,{cardId:o})})})})]})})}function j({cardId:a}){const t=r.useDashboardStore(n=>{var c;return(c=n.dashboard)==null?void 0:c.sheets}),{card:o,frame:u}=h.useMemo(()=>{const n=t==null?void 0:t.flatMap(s=>s.frames),c=n==null?void 0:n.flatMap(s=>s==null?void 0:s.cards),D=c==null?void 0:c.find(s=>(s==null?void 0:s.id)===a),E=n==null?void 0:n.find(s=>{var m;return(m=s==null?void 0:s.cards)==null?void 0:m.find(g=>(g==null?void 0:g.id)===a)});return{card:D,frame:E}},[t,a]);return!o||!u?i.jsx(e.FallbackVisual,{error:new Error("Card not found"),resetErrorBoundary:()=>{},customerFacingMessage:`Card not found with ID: ${a}`}):i.jsx("main",{className:"flex h-full grow flex-col",children:i.jsx(e.ErrorBoundary,{FallbackComponent:({error:n,resetErrorBoundary:c})=>i.jsx(e.FallbackVisual,{error:n,resetErrorBoundary:c,customerFacingMessage:"Error creating visual. Please try again."}),children:i.jsx(e.DashboardCard,{card:o,frame:u})})})}function L(a,t,o,u){h.useEffect(()=>{a&&!o&&t&&u(e.cloneDeep(t))},[a,o,t,u])}function M({name:a,items:t,value:o,onChange:u,isLoading:n,isError:c,refetch:D,className:E,icon:s,showNone:m=!1}){const g=C.useRef(null),[b,T]=C.useState(!1),[S,A]=C.useState("100%"),x=m?[...t||[],{id:"none",name:"None"}]:t;C.useLayoutEffect(()=>{g.current&&A(g.current.offsetWidth)},[]);function v(){var f;return n?"Loading...":c?"Error":o?(f=t==null?void 0:t.find(p=>p.id===o))==null?void 0:f.name:`Select ${a}`}function F(f,p){u(p),T(!1)}return i.jsxs(r.Popover,{open:b,onOpenChange:T,children:[i.jsx(r.PopoverTrigger,{asChild:!0,children:i.jsxs(r.Button,{ref:g,variant:"outline",role:"combobox","aria-expanded":b,className:r.cn("flex h-9 w-full justify-between",E),children:[i.jsxs("div",{className:"flex items-center gap-2",children:[s&&i.jsx("div",{className:"mr-2",children:s}),i.jsx("span",{className:"max-w-[150px] overflow-hidden truncate text-ellipsis whitespace-nowrap",children:v()})]}),i.jsx(_.ChevronDown,{className:"size-4 opacity-50"})]})}),i.jsx(r.PopoverContent,{className:"w-full p-0",style:{minWidth:S},children:i.jsxs(e.Command,{children:[i.jsxs("div",{className:"flex h-9 items-center justify-between border-b pr-1",children:[i.jsx(e.CommandInput,{className:"h-9",placeholder:"Search..."}),i.jsx(e.IconButton,{className:"h-7",onClick:D,children:i.jsx(e.RefreshCw,{className:r.cn("size-3.5 opacity-50",n&&"animate-spin")})})]}),i.jsxs(e.CommandList,{children:[i.jsxs(e.CommandEmpty,{children:["No ",a==null?void 0:a.toLowerCase()," found."]}),i.jsx(e.CommandGroup,{children:x==null?void 0:x.map(f=>i.jsx(e.CommandItem,{className:"overflow-x-auto",value:f.name,onSelect:p=>F(p,f.id),children:i.jsxs("div",{className:"flex items-center gap-2",children:[i.jsx(r.Check,{className:r.cn("size-4",o===f.id?"opacity-100":"opacity-0")}),i.jsx("div",{title:f.name,children:f.name})]})},f.id))})]})]})})]})}function I(a,t){h.useEffect(()=>(a&&t&&(window.__SEMAPHOR_PRINT_STATE__={...t}),()=>{a&&window.__SEMAPHOR_PRINT_STATE__&&delete window.__SEMAPHOR_PRINT_STATE__}),[a,t])}exports.BriefingAuthor=e.BriefingAuthor;exports.BriefingAuthorDialog=e.BriefingAuthorDialog;exports.BriefingUiCapabilitiesBoundary=e.BriefingUiCapabilitiesBoundary;exports.BriefingUiCapabilitiesProvider=e.BriefingUiCapabilitiesProvider;exports.BriefingsApiError=e.BriefingsApiError;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.MatrixTableVisual=e.MatrixTableVisual;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.applyBriefingFormPatch=e.applyBriefingFormPatch;exports.briefingFormDraftToCreateRequest=e.briefingFormDraftToCreateRequest;exports.briefingFormDraftToUpdateRequest=e.briefingFormDraftToUpdateRequest;exports.briefingToFormDraft=e.briefingToFormDraft;exports.cancelBriefingPreviewRun=e.cancelBriefingPreviewRun;exports.cancelBriefingRun=e.cancelBriefingRun;exports.cancelExport=e.cancelExport;exports.cloneDeep=e.cloneDeep;exports.createBriefing=e.createBriefing;exports.createBriefingFormDraft=e.createBriefingFormDraft;exports.createExport=e.createExport;exports.deleteBriefing=e.deleteBriefing;exports.deleteBriefingRun=e.deleteBriefingRun;exports.downloadDocumentPdf=e.downloadDocumentPdf;exports.downloadPdf=e.downloadPdf;exports.formatFileSize=e.formatFileSize;exports.getBriefing=e.getBriefing;exports.getBriefingArtifact=e.getBriefingArtifact;exports.getBriefingEvidence=e.getBriefingEvidence;exports.getBriefingPreviewRun=e.getBriefingPreviewRun;exports.getBriefingRun=e.getBriefingRun;exports.getDownloadUrl=e.getDownloadUrl;exports.getExportStatus=e.getExportStatus;exports.getExports=e.getExports;exports.isExportComplete=e.isExportComplete;exports.isExportInProgress=e.isExportInProgress;exports.listBriefingRuns=e.listBriefingRuns;exports.listBriefingTenantSummaries=e.listBriefingTenantSummaries;exports.listBriefings=e.listBriefings;exports.pauseBriefing=e.pauseBriefing;exports.polishBriefingText=e.polishBriefingText;exports.previewBriefingPlan=e.previewBriefingPlan;exports.resumeBriefing=e.resumeBriefing;exports.runBriefingNow=e.runBriefingNow;exports.runBriefingPreview=e.runBriefingPreview;exports.updateBriefing=e.updateBriefing;exports.useActiveExports=e.useActiveExports;exports.useAddNewFrame=e.useAddNewFrame;exports.useBriefingUiCapabilities=e.useBriefingUiCapabilities;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.validateBriefingFormDraft=e.validateBriefingFormDraft;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=r.createEmptyKpiConfig;exports.createSqlGenConfig=r.createSqlGenConfig;exports.emitDashboardLoad=r.emitDashboardLoad;exports.emitDashboardUnload=r.emitDashboardUnload;exports.fmt=r.fmt;exports.getColumnDataType=r.getColumnDataType;exports.getFilterValueType=r.getFilterValueType;exports.getFormattedTableNameForQuery=r.getFormattedTableNameForQuery;exports.getQualifiedTableName=r.getQualifiedTableName;exports.getSql=r.getSql;exports.invalidateToken=r.invalidateToken;exports.isBooleanDataType=r.isBooleanDataType;exports.isColumnInSqlGen=r.isColumnInSqlGen;exports.isDateDataType=r.isDateDataType;exports.isNumberDataType=r.isNumberDataType;exports.isTextDataType=r.isTextDataType;exports.resolveDataType=r.resolveDataType;exports.resolveDatamodelName=r.resolveDatamodelName;exports.useCurrentActiveCard=r.useCurrentActiveCard;exports.useCurrentCardConfig=r.useCurrentCardConfig;exports.useCurrentSheetActiveCards=r.useCurrentSheetActiveCards;exports.useDashboardActions=r.useDashboardActions;exports.useDashboardStore=r.useDashboardStore;exports.useEditorActions=r.useEditorActions;exports.useEditorStore=r.useEditorStore;exports.DEFAULT_CALENDAR_CONTEXT=B.DEFAULT_CALENDAR_CONTEXT;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=B.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.AdvancedModeToggle=l.AdvancedModeToggle;exports.DashboardBriefingLauncher=l.DashboardBriefingLauncher;exports.DashboardControlsSettings=l.DashboardControlsSettings;exports.DashboardFilterControlsButton=l.DashboardFilterControlsButton;exports.DashboardFilterControlsLauncher=l.DashboardFilterControlsLauncher;exports.DocumentControlsSettings=l.DocumentControlsSettings;exports.ExportNotificationItem=l.ExportNotificationItem;exports.ExportNotificationList=l.ExportNotificationList;exports.NotificationBell=l.NotificationBell;exports.UnsavedChangesAlert=l.UnsavedChangesAlert;exports.VisualEditingControls=l.VisualEditingControls;exports.VisualsLibraryDialog=l.VisualsLibraryDialog;exports.WatchDashboardButton=l.WatchDashboardButton;exports.useExportPolling=l.useExportPolling;exports.useExportRecovery=l.useExportRecovery;exports.useDebouncedDirtyCheck=N.useDebouncedDirtyCheck;exports.normalizeDashboardForDirtyCheck=y.normalizeDashboardForDirtyCheck;exports.serializeDashboardForDirtyCheck=y.serializeDashboardForDirtyCheck;exports.Combobox=M;exports.Visual=w;exports.useExposePrintState=I;exports.usePristineSnapshotInitializer=L;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chunks/dashboard-JNK2ly_e.js"),d=require("./chunks/common-types-C73-Ud1-.js"),P=require("./chunks/calendar-preferences-dialog-C-gN-vlq.js"),i=require("react/jsx-runtime"),r=require("./chunks/code-editor-tfzm8LWW.js"),h=require("react"),B=require("./types/index.cjs"),l=require("./chunks/dashboard-briefing-launcher-0kR-QThz.js"),N=require("./chunks/use-debounced-dirty-check-XHSwAefL.js");require("./chunks/analyze-result-contract-ege_u6Nl.js");require("react-dom");require("./chunks/index-Dpm_VET4.js");const y=require("./chunks/normalize-dashboard-for-dirty-check-BXRUMVb2.js"),_=require("./chunks/index-jSrCwPQz.js");function R(a){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(a){for(const o in a)if(o!=="default"){const u=Object.getOwnPropertyDescriptor(a,o);Object.defineProperty(t,o,u.get?u:{enumerable:!0,get:()=>a[o]})}}return t.default=a,Object.freeze(t)}const C=R(h);function w(a){const{displayPreferences:t,cardId:o,...u}=a,n={...u,id:a.dashboardId};return i.jsx(e.ErrorBoundary,{FallbackComponent:e.Fallback,children:i.jsxs(e.SemaphorContextProvider,{dashboardProps:n,children:[i.jsx(e.SemaphorReadyIndicator,{componentType:"visual",componentId:a.cardId}),i.jsx(e.UXProvider,{appearance:a.appearance,children:i.jsx(e.DisplayPreferencesProvider,{displayPreferences:t,children:i.jsx(e.Container,{type:"visual",cardId:o,...n,children:i.jsx(j,{cardId:o})})})})]})})}function j({cardId:a}){const t=r.useDashboardStore(n=>{var c;return(c=n.dashboard)==null?void 0:c.sheets}),{card:o,frame:u}=h.useMemo(()=>{const n=t==null?void 0:t.flatMap(s=>s.frames),c=n==null?void 0:n.flatMap(s=>s==null?void 0:s.cards),D=c==null?void 0:c.find(s=>(s==null?void 0:s.id)===a),E=n==null?void 0:n.find(s=>{var m;return(m=s==null?void 0:s.cards)==null?void 0:m.find(g=>(g==null?void 0:g.id)===a)});return{card:D,frame:E}},[t,a]);return!o||!u?i.jsx(e.FallbackVisual,{error:new Error("Card not found"),resetErrorBoundary:()=>{},customerFacingMessage:`Card not found with ID: ${a}`}):i.jsx("main",{className:"flex h-full grow flex-col",children:i.jsx(e.ErrorBoundary,{FallbackComponent:({error:n,resetErrorBoundary:c})=>i.jsx(e.FallbackVisual,{error:n,resetErrorBoundary:c,customerFacingMessage:"Error creating visual. Please try again."}),children:i.jsx(e.DashboardCard,{card:o,frame:u})})})}function L(a,t,o,u){h.useEffect(()=>{a&&!o&&t&&u(e.cloneDeep(t))},[a,o,t,u])}function M({name:a,items:t,value:o,onChange:u,isLoading:n,isError:c,refetch:D,className:E,icon:s,showNone:m=!1}){const g=C.useRef(null),[b,T]=C.useState(!1),[S,A]=C.useState("100%"),x=m?[...t||[],{id:"none",name:"None"}]:t;C.useLayoutEffect(()=>{g.current&&A(g.current.offsetWidth)},[]);function v(){var f;return n?"Loading...":c?"Error":o?(f=t==null?void 0:t.find(p=>p.id===o))==null?void 0:f.name:`Select ${a}`}function F(f,p){u(p),T(!1)}return i.jsxs(r.Popover,{open:b,onOpenChange:T,children:[i.jsx(r.PopoverTrigger,{asChild:!0,children:i.jsxs(r.Button,{ref:g,variant:"outline",role:"combobox","aria-expanded":b,className:r.cn("flex h-9 w-full justify-between",E),children:[i.jsxs("div",{className:"flex items-center gap-2",children:[s&&i.jsx("div",{className:"mr-2",children:s}),i.jsx("span",{className:"max-w-[150px] overflow-hidden truncate text-ellipsis whitespace-nowrap",children:v()})]}),i.jsx(_.ChevronDown,{className:"size-4 opacity-50"})]})}),i.jsx(r.PopoverContent,{className:"w-full p-0",style:{minWidth:S},children:i.jsxs(e.Command,{children:[i.jsxs("div",{className:"flex h-9 items-center justify-between border-b pr-1",children:[i.jsx(e.CommandInput,{className:"h-9",placeholder:"Search..."}),i.jsx(e.IconButton,{className:"h-7",onClick:D,children:i.jsx(e.RefreshCw,{className:r.cn("size-3.5 opacity-50",n&&"animate-spin")})})]}),i.jsxs(e.CommandList,{children:[i.jsxs(e.CommandEmpty,{children:["No ",a==null?void 0:a.toLowerCase()," found."]}),i.jsx(e.CommandGroup,{children:x==null?void 0:x.map(f=>i.jsx(e.CommandItem,{className:"overflow-x-auto",value:f.name,onSelect:p=>F(p,f.id),children:i.jsxs("div",{className:"flex items-center gap-2",children:[i.jsx(r.Check,{className:r.cn("size-4",o===f.id?"opacity-100":"opacity-0")}),i.jsx("div",{title:f.name,children:f.name})]})},f.id))})]})]})})]})}function I(a,t){h.useEffect(()=>(a&&t&&(window.__SEMAPHOR_PRINT_STATE__={...t}),()=>{a&&window.__SEMAPHOR_PRINT_STATE__&&delete window.__SEMAPHOR_PRINT_STATE__}),[a,t])}exports.BriefingAuthor=e.BriefingAuthor;exports.BriefingAuthorDialog=e.BriefingAuthorDialog;exports.BriefingUiCapabilitiesBoundary=e.BriefingUiCapabilitiesBoundary;exports.BriefingUiCapabilitiesProvider=e.BriefingUiCapabilitiesProvider;exports.BriefingsApiError=e.BriefingsApiError;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.MatrixTableVisual=e.MatrixTableVisual;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.applyBriefingFormPatch=e.applyBriefingFormPatch;exports.briefingFormDraftToCreateRequest=e.briefingFormDraftToCreateRequest;exports.briefingFormDraftToUpdateRequest=e.briefingFormDraftToUpdateRequest;exports.briefingToFormDraft=e.briefingToFormDraft;exports.cancelBriefingPreviewRun=e.cancelBriefingPreviewRun;exports.cancelBriefingRun=e.cancelBriefingRun;exports.cancelExport=e.cancelExport;exports.cloneDeep=e.cloneDeep;exports.createBriefing=e.createBriefing;exports.createBriefingFormDraft=e.createBriefingFormDraft;exports.createExport=e.createExport;exports.deleteBriefing=e.deleteBriefing;exports.deleteBriefingRun=e.deleteBriefingRun;exports.downloadDocumentPdf=e.downloadDocumentPdf;exports.downloadPdf=e.downloadPdf;exports.formatFileSize=e.formatFileSize;exports.getBriefing=e.getBriefing;exports.getBriefingArtifact=e.getBriefingArtifact;exports.getBriefingEvidence=e.getBriefingEvidence;exports.getBriefingPreviewRun=e.getBriefingPreviewRun;exports.getBriefingRun=e.getBriefingRun;exports.getDownloadUrl=e.getDownloadUrl;exports.getExportStatus=e.getExportStatus;exports.getExports=e.getExports;exports.isExportComplete=e.isExportComplete;exports.isExportInProgress=e.isExportInProgress;exports.listBriefingRuns=e.listBriefingRuns;exports.listBriefingTenantSummaries=e.listBriefingTenantSummaries;exports.listBriefings=e.listBriefings;exports.pauseBriefing=e.pauseBriefing;exports.polishBriefingText=e.polishBriefingText;exports.previewBriefingPlan=e.previewBriefingPlan;exports.resumeBriefing=e.resumeBriefing;exports.runBriefingNow=e.runBriefingNow;exports.runBriefingPreview=e.runBriefingPreview;exports.updateBriefing=e.updateBriefing;exports.useActiveExports=e.useActiveExports;exports.useAddNewFrame=e.useAddNewFrame;exports.useBriefingUiCapabilities=e.useBriefingUiCapabilities;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.validateBriefingFormDraft=e.validateBriefingFormDraft;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=r.createEmptyKpiConfig;exports.createSqlGenConfig=r.createSqlGenConfig;exports.emitDashboardLoad=r.emitDashboardLoad;exports.emitDashboardUnload=r.emitDashboardUnload;exports.fmt=r.fmt;exports.getColumnDataType=r.getColumnDataType;exports.getFilterValueType=r.getFilterValueType;exports.getFormattedTableNameForQuery=r.getFormattedTableNameForQuery;exports.getQualifiedTableName=r.getQualifiedTableName;exports.getSql=r.getSql;exports.invalidateToken=r.invalidateToken;exports.isBooleanDataType=r.isBooleanDataType;exports.isColumnInSqlGen=r.isColumnInSqlGen;exports.isDateDataType=r.isDateDataType;exports.isNumberDataType=r.isNumberDataType;exports.isTextDataType=r.isTextDataType;exports.resolveDataType=r.resolveDataType;exports.resolveDatamodelName=r.resolveDatamodelName;exports.useCurrentActiveCard=r.useCurrentActiveCard;exports.useCurrentCardConfig=r.useCurrentCardConfig;exports.useCurrentSheetActiveCards=r.useCurrentSheetActiveCards;exports.useDashboardActions=r.useDashboardActions;exports.useDashboardStore=r.useDashboardStore;exports.useEditorActions=r.useEditorActions;exports.useEditorStore=r.useEditorStore;exports.DEFAULT_CALENDAR_CONTEXT=B.DEFAULT_CALENDAR_CONTEXT;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=B.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.AdvancedModeToggle=l.AdvancedModeToggle;exports.DashboardBriefingLauncher=l.DashboardBriefingLauncher;exports.DashboardControlsSettings=l.DashboardControlsSettings;exports.DashboardFilterControlsButton=l.DashboardFilterControlsButton;exports.DashboardFilterControlsLauncher=l.DashboardFilterControlsLauncher;exports.DocumentControlsSettings=l.DocumentControlsSettings;exports.ExportNotificationItem=l.ExportNotificationItem;exports.ExportNotificationList=l.ExportNotificationList;exports.NotificationBell=l.NotificationBell;exports.UnsavedChangesAlert=l.UnsavedChangesAlert;exports.VisualEditingControls=l.VisualEditingControls;exports.VisualsLibraryDialog=l.VisualsLibraryDialog;exports.WatchDashboardButton=l.WatchDashboardButton;exports.useExportPolling=l.useExportPolling;exports.useExportRecovery=l.useExportRecovery;exports.useDebouncedDirtyCheck=N.useDebouncedDirtyCheck;exports.normalizeDashboardForDirtyCheck=y.normalizeDashboardForDirtyCheck;exports.serializeDashboardForDirtyCheck=y.serializeDashboardForDirtyCheck;exports.Combobox=M;exports.Visual=w;exports.useExposePrintState=I;exports.usePristineSnapshotInitializer=L;

package/dist/index.js

@@ -1,14 +1,14 @@
-import { E as b, F as N, S, q as P, U as w, r as _, s as F, t as x, v as R, w as I, h as M, i as L, I as k, x as U, j as O, k as V, l as z, m as q } from "./chunks/dashboard-5agU0G_D.js";
-import { B as fa, y as ma, z as pa, A as ha, G as ga, H as Ca, D as Da, J as Ea, K as xa, L as ba, M as Ta, N as ya, O as Ba, P as va, P as Aa, Q as Na, T as Sa, a as Pa, V as wa, W as _a, X as Fa, Y as Ra, Z as Ia, _ as Ma, $ as La, a0 as ka, a1 as Ua, a2 as Oa, a3 as Va, a4 as za, a5 as qa, a6 as Wa, a7 as ja, a8 as Ha, a9 as Ga, aa as Qa, ab as Ka, ac as Xa, ad as Ya, ae as $a, af as Ja, ag as Za, ah as ae, ai as ee, aj as se, ak as re, al as oe, am as ie, an as te, ao as ne, ap as le, aq as de, ar as ue, as as ce, at as fe, au as me, av as pe, aw as he, ax as ge, ay as Ce, az as De, aA as Ee, aB as xe, aC as be, aD as Te, aE as ye, aF as Be, aG as ve, aH as Ae, aI as Ne, aJ as Se } from "./chunks/dashboard-5agU0G_D.js";
+import { E as b, F as N, S, q as P, U as w, r as _, s as F, t as x, v as R, w as I, h as M, i as L, I as k, x as U, j as O, k as V, l as z, m as q } from "./chunks/dashboard-ZoKNg47G.js";
+import { B as fa, y as ma, z as pa, A as ha, G as ga, H as Ca, D as Da, J as Ea, K as xa, L as ba, M as Ta, N as ya, O as Ba, P as va, P as Aa, Q as Na, T as Sa, a as Pa, V as wa, W as _a, X as Fa, Y as Ra, Z as Ia, _ as Ma, $ as La, a0 as ka, a1 as Ua, a2 as Oa, a3 as Va, a4 as za, a5 as qa, a6 as Wa, a7 as ja, a8 as Ha, a9 as Ga, aa as Qa, ab as Ka, ac as Xa, ad as Ya, ae as $a, af as Ja, ag as Za, ah as ae, ai as ee, aj as se, ak as re, al as oe, am as ie, an as te, ao as ne, ap as le, aq as de, ar as ue, as as ce, at as fe, au as me, av as pe, aw as he, ax as ge, ay as Ce, az as De, aA as Ee, aB as xe, aC as be, aD as Te, aE as ye, aF as Be, aG as ve, aH as Ae, aI as Ne, aJ as Se } from "./chunks/dashboard-ZoKNg47G.js";
 import { a as we, C as _e, D as Fe, E as Re, P as Ie, g as Me, h as Le, b as ke, i as Ue, c as Oe, d as Ve } from "./chunks/common-types-ClkOI-3O.js";
-import { C as qe } from "./chunks/calendar-preferences-dialog-DJwV0aqn.js";
+import { C as qe } from "./chunks/calendar-preferences-dialog-tBSngRN-.js";
 import { jsx as a, jsxs as d } from "react/jsx-runtime";
-import { u as W, P as j, a as H, B as G, c as C, b as Q, d as K } from "./chunks/code-editor-Bkk7s8hI.js";
-import { f as je, g as He, h as Ge, i as Qe, j as Ke, k as Xe, l as Ye, m as $e, n as Je, o as Ze, p as as, q as es, r as ss, s as rs, t as os, v as is, w as ts, x as ns, y as ls, z as ds, A as us, D as cs, E as fs, F as ms } from "./chunks/code-editor-Bkk7s8hI.js";
+import { u as W, P as j, a as H, B as G, c as C, b as Q, d as K } from "./chunks/code-editor-Pod1s6SK.js";
+import { f as je, g as He, h as Ge, i as Qe, j as Ke, k as Xe, l as Ye, m as $e, n as Je, o as Ze, p as as, q as es, r as ss, s as rs, t as os, v as is, w as ts, x as ns, y as ls, z as ds, A as us, D as cs, E as fs, F as ms } from "./chunks/code-editor-Pod1s6SK.js";
 import * as m from "react";
 import { useMemo as X, useEffect as T } from "react";
 import { DEFAULT_CALENDAR_CONTEXT as hs, DEFAULT_SEMANTIC_DOMAIN_ACCESS as gs } from "./types/index.js";
-import { A as Ds, D as Es, a as xs, b as bs, c as Ts, d as ys, E as Bs, e as vs, N as As, U as Ns, V as Ss, f as Ps, W as ws, u as _s, g as Fs } from "./chunks/dashboard-briefing-launcher-qyEVfuOm.js";
+import { A as Ds, D as Es, a as xs, b as bs, c as Ts, d as ys, E as Bs, e as vs, N as As, U as Ns, V as Ss, f as Ps, W as ws, u as _s, g as Fs } from "./chunks/dashboard-briefing-launcher-BE-sNAzW.js";
 import { u as Is } from "./chunks/use-debounced-dirty-check-BwAbnX_5.js";
 import "./chunks/analyze-result-contract-DnfF8kBb.js";
 import "react-dom";

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/dashboard-MKIqgGDp.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-BLaSWhLl.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/dashboard-JNK2ly_e.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-C-gN-vlq.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/dashboard-5agU0G_D.js";
+import { a as e } from "../chunks/dashboard-ZoKNg47G.js";
 import { C, E } from "../chunks/common-types-ClkOI-3O.js";
-import { C as s } from "../chunks/calendar-preferences-dialog-DJwV0aqn.js";
+import { C as s } from "../chunks/calendar-preferences-dialog-tBSngRN-.js";
 export {
   C as CONTROL_CARD_DEFAULT_VALUE,
   s as CalendarPreferencesDialog,

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

@@ -101,6 +101,29 @@ export declare type ComparisonPresentationSpec = {
 
 export declare type ComparisonUnavailableReason = 'finite_current_window_required' | 'current_window_not_started' | 'temporal_binding_missing' | 'temporal_binding_ambiguous' | 'temporal_binding_invalid' | 'unsupported_output_shape' | 'unsupported_raw_sql' | 'insufficient_history' | 'invalid_comparison_spec' | 'comparison_execution_failed';
 
+export declare type DashboardDateComparisonDefinitionIneligibility = 'invalid_input' | 'non_date_filter' | 'card_inline_filter' | 'custom_filter' | 'multi_target_filter' | 'incomplete_field_identity' | 'divergent_field_identity' | 'incomplete_source_identity' | 'divergent_source_identity';
+
+export declare type DashboardDateComparisonDefinitionResolution = {
+    status: 'eligible';
+    kind: 'global_date';
+} | {
+    status: 'eligible';
+    kind: 'field_date';
+    qualifiedFieldName: string;
+    source: SemaphorSourceRef;
+} | {
+    status: 'ineligible';
+    reason: DashboardDateComparisonDefinitionIneligibility;
+};
+
+export declare type DashboardDateComparisonOwner = {
+    kind: 'global_date';
+} | {
+    kind: 'field_date';
+    filterId: string;
+    label: string;
+};
+
 export declare const DEFAULT_METRIC_COMPARISON_POLARITY: "higher_is_better";
 
 export declare function evaluateMetricComparison(input: {
@@ -134,6 +157,7 @@ export declare function getSemaphorConnectionCapabilities(connectionType: string
 export declare type GlobalDateComparisonContext = {
     selection: GlobalDateComparisonSelection;
     inheritGlobalComparison?: false;
+    owner?: DashboardDateComparisonOwner;
     /** Fixed execution clock carried by authoritative dashboard replay snapshots. */
     referenceTime?: string;
 };
@@ -161,6 +185,8 @@ export declare function isAnalyticsMetricIdentifierField(field: AnalyticsCatalog
 
 export declare function isAnalyticsTechnicalIdentifierField(field: AnalyticsCatalogField): boolean;
 
+export declare function isComparisonCapableDashboardDateInputDefinition(input: unknown): boolean;
+
 export declare function isSemaphorAnalyzeResultFieldName(value: string): value is SemaphorAnalyzeResultFieldName;
 
 export declare function isSemaphorDataAppCodegenSummary(value: unknown): value is SemaphorDataAppCodegenSummary;
@@ -604,6 +630,10 @@ export declare function preferSemaphorFieldRefMetadata(current: SemaphorFieldRef
 
 export declare function preferSemaphorSourceMetadata(current: SemaphorSourceRef, next: SemaphorSourceRef): SemaphorSourceRef;
 
+export declare function resolveDashboardDateComparisonFilterDefinition(filter: unknown): DashboardDateComparisonDefinitionResolution;
+
+export declare function resolveDashboardDateComparisonInputDefinition(input: unknown): DashboardDateComparisonDefinitionResolution;
+
 export declare type ResolvedDateWindow = {
     startInclusive: string;
     endExclusive: string;
@@ -616,6 +646,7 @@ export declare type ResolvedMetricComparisonRequest = {
 } | {
     source: 'inherited';
     spec: ViewerPeriodComparisonSpec;
+    owner?: DashboardDateComparisonOwner;
 };
 
 export declare type ResolvedTemporalContext = {
@@ -635,8 +666,7 @@ export declare type ResolvedTemporalContext = {
 export declare function resolveMetricComparisonRequest(input: {
     metricComparison?: MetricComparisonConfig;
     inheritGlobalComparison?: false;
-    globalSelection?: GlobalDateComparisonSelection;
-    isGlobalDateApplicable: boolean;
+    globalDateComparison?: GlobalDateComparisonContext;
 }): ResolvedMetricComparisonRequest | undefined;
 
 /** Stable result-instance identity shared by query producers and consumers. */
@@ -651,6 +681,14 @@ export declare type ResolveTemporalContextInput = {
     querySources?: SemaphorSourceRef[];
 };
 
+export declare function semanticDatasetMatchesFieldCoordinates(dataset: {
+    id?: unknown;
+    name?: unknown;
+}, field: {
+    entityId?: unknown;
+    entityName?: unknown;
+}): boolean;
+
 export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
     revenueKpi: {
         version: 1;

package/dist/types/dashboard.d.ts

@@ -1744,6 +1744,14 @@ export declare type LoadingProps = {
 
 declare type LogicalOperator = 'AND' | 'OR';
 
+/**
+ * A comparison input proven to be present in the card's executed filter set.
+ * Ownership and UI coverage must consume this stage, never source inputs.
+ */
+export declare type MaterializedDashboardDateComparisonInput = ResolvedDashboardDateComparisonInput & {
+    effectiveFilterValue: TFilterValue;
+};
+
 declare interface MetricColumn extends BaseColumn {
     role: 'metric';
     aggregate: AggregateFunction;
@@ -1946,6 +1954,20 @@ declare type RelativeDateFilter = {
     to: number;
 };
 
+export declare type ResolvedDashboardDateComparisonInput = {
+    inputId: string;
+    filterId: string;
+    label: string;
+    filter: TFilter;
+    /**
+     * The active value before execution-only canonicalization. Comparison
+     * ownership uses this value as provenance evidence and must fail closed
+     * when its filter or field identity does not match the definition.
+     */
+    filterValue?: TFilterValue;
+    selection: GlobalDateComparisonSelection;
+};
+
 export declare type ResolvedDashboardInput = {
     id: string;
     kind: 'filter' | 'control';
@@ -1974,6 +1996,7 @@ export declare type ResolvedDashboardInputContext = {
     controlValues: Record<string, unknown>;
     variablesByName: Record<string, ResolvedDashboardInput>;
     globalDateComparisonSelection?: GlobalDateComparisonSelection;
+    dateComparisonInputs?: ResolvedDashboardDateComparisonInput[];
     variablesById: Record<string, ResolvedDashboardInput>;
     missingRequiredInputs: ResolvedDashboardInput[];
 };
@@ -1998,6 +2021,8 @@ declare type ResolvedPrimaryDateField = {
     entityName: string;
     entityType: string;
     dataType: string;
+    /** Canonical dataset coordinates stamped by the temporal grounding boundary. */
+    source?: SemaphorSourceRef;
     dateFormat?: string;
     customFormat?: string;
     defaultGranularity?: TimeGranularity;

package/dist/types/main.d.ts

@@ -45,7 +45,6 @@ declare type Actions_2 = {
     removeDashboardInput: (inputId: string) => void;
     setDefaultDashboardInputValues: (values: DashboardInputValues | undefined) => void;
     setDashboardInputValues: (values: DashboardInputValues) => void;
-    setDashboardInputValuesAreAuthoritative: (isAuthoritative: boolean) => void;
     setDashboardInputSlot: (input: Pick<DashboardInput, 'id' | 'runtimeScope'>, target: DashboardInputRuntimeTarget, slot: DashboardInputSlot) => void;
     setDashboardInputComparisonSelection: (input: Pick<DashboardInput, 'id' | 'runtimeScope'>, target: DashboardInputRuntimeTarget, selection: GlobalDateComparisonSelection) => void;
     resetDashboardInputComparisonSelection: (input: Pick<DashboardInput, 'id' | 'runtimeScope'>, target: DashboardInputRuntimeTarget) => void;
@@ -73,14 +72,12 @@ declare type Actions_2 = {
     setDashboard: (dashboard: TDashboard, options?: {
         semanticExecutionPayload?: SemanticExecutionPayload;
         dashboardInputValues?: DashboardInputValues;
-        dashboardInputValuesAreAuthoritative?: boolean;
         dashboardInputReferenceTime?: string;
     }) => void;
     setDashboardWithFilterValues: (dashboard: TDashboard, filterValues: TFilterValue[], runtimeOverrides?: Record<string, unknown>, options?: {
         selectedSheetId?: string | null;
         semanticExecutionPayload?: SemanticExecutionPayload;
         dashboardInputValues?: DashboardInputValues;
-        dashboardInputValuesAreAuthoritative?: boolean;
         dashboardInputReferenceTime?: string;
     }) => void;
     hydrateRuntimeControlValues: (dashboard: TDashboard, runtimeOverrides?: Record<string, unknown>) => void;
@@ -1932,6 +1929,14 @@ export declare interface DashboardCreateDialogBaseProps {
     initialDomainId?: string;
 }
 
+declare type DashboardDateComparisonOwner = {
+    kind: 'global_date';
+} | {
+    kind: 'field_date';
+    filterId: string;
+    label: string;
+};
+
 export declare type DashboardEventHandlers = {
     onExportData?: (payload: ExportDataPayload) => void;
 };
@@ -2354,8 +2359,6 @@ export declare type DashboardStore = {
     cardControlValuesMap: Record<string, Record<string, unknown>>;
     /** Runtime-only dashboard input values keyed by input runtime scope. */
     dashboardInputValues: DashboardInputValues;
-    /** True when dashboardInputValues came from a strict execution snapshot. */
-    dashboardInputValuesAreAuthoritative: boolean;
     /** Fixed execution clock from a strict dashboard input replay snapshot. */
     dashboardInputReferenceTime?: string;
     semanticExecutionPayload: SemanticExecutionPayload;
@@ -3689,6 +3692,7 @@ export declare function getSql(config: SqlGen, schemaName: string, tableName: st
 declare type GlobalDateComparisonContext = {
     selection: GlobalDateComparisonSelection;
     inheritGlobalComparison?: false;
+    owner?: DashboardDateComparisonOwner;
     /** Fixed execution clock carried by authoritative dashboard replay snapshots. */
     referenceTime?: string;
 };
@@ -4018,6 +4022,14 @@ declare type ManagementStore = {
     actions: Actions;
 };
 
+/**
+ * A comparison input proven to be present in the card's executed filter set.
+ * Ownership and UI coverage must consume this stage, never source inputs.
+ */
+export declare type MaterializedDashboardDateComparisonInput = ResolvedDashboardDateComparisonInput & {
+    effectiveFilterValue: TFilterValue;
+};
+
 declare type MatrixAxisLevelDescriptor = {
     instanceId: string;
     fieldKey: string;
@@ -4813,6 +4825,20 @@ export declare function resolveDatamodelName(datamodelName: string): string;
 
 export declare const resolveDataType: (value: any) => string;
 
+export declare type ResolvedDashboardDateComparisonInput = {
+    inputId: string;
+    filterId: string;
+    label: string;
+    filter: TFilter;
+    /**
+     * The active value before execution-only canonicalization. Comparison
+     * ownership uses this value as provenance evidence and must fail closed
+     * when its filter or field identity does not match the definition.
+     */
+    filterValue?: TFilterValue;
+    selection: GlobalDateComparisonSelection;
+};
+
 export declare type ResolvedDashboardInput = {
     id: string;
     kind: 'filter' | 'control';
@@ -4841,6 +4867,7 @@ export declare type ResolvedDashboardInputContext = {
     controlValues: Record<string, unknown>;
     variablesByName: Record<string, ResolvedDashboardInput>;
     globalDateComparisonSelection?: GlobalDateComparisonSelection;
+    dateComparisonInputs?: ResolvedDashboardDateComparisonInput[];
     variablesById: Record<string, ResolvedDashboardInput>;
     missingRequiredInputs: ResolvedDashboardInput[];
 };
@@ -4867,6 +4894,7 @@ declare type ResolvedMetricComparisonRequest = {
 } | {
     source: 'inherited';
     spec: ViewerPeriodComparisonSpec;
+    owner?: DashboardDateComparisonOwner;
 };
 
 declare type ResolvedPrimaryDateField = {
@@ -4879,6 +4907,8 @@ declare type ResolvedPrimaryDateField = {
     entityName: string;
     entityType: string;
     dataType: string;
+    /** Canonical dataset coordinates stamped by the temporal grounding boundary. */
+    source?: SemaphorSourceRef;
     dateFormat?: string;
     customFormat?: string;
     defaultGranularity?: TimeGranularity;

package/dist/types/surfboard.d.ts

@@ -1755,6 +1755,14 @@ export declare type LoadingProps = {
 
 declare type LogicalOperator = 'AND' | 'OR';
 
+/**
+ * A comparison input proven to be present in the card's executed filter set.
+ * Ownership and UI coverage must consume this stage, never source inputs.
+ */
+export declare type MaterializedDashboardDateComparisonInput = ResolvedDashboardDateComparisonInput & {
+    effectiveFilterValue: TFilterValue;
+};
+
 declare interface MetricColumn extends BaseColumn {
     role: 'metric';
     aggregate: AggregateFunction;
@@ -1957,6 +1965,20 @@ declare type RelativeDateFilter = {
     to: number;
 };
 
+export declare type ResolvedDashboardDateComparisonInput = {
+    inputId: string;
+    filterId: string;
+    label: string;
+    filter: TFilter;
+    /**
+     * The active value before execution-only canonicalization. Comparison
+     * ownership uses this value as provenance evidence and must fail closed
+     * when its filter or field identity does not match the definition.
+     */
+    filterValue?: TFilterValue;
+    selection: GlobalDateComparisonSelection;
+};
+
 export declare type ResolvedDashboardInput = {
     id: string;
     kind: 'filter' | 'control';
@@ -1985,6 +2007,7 @@ export declare type ResolvedDashboardInputContext = {
     controlValues: Record<string, unknown>;
     variablesByName: Record<string, ResolvedDashboardInput>;
     globalDateComparisonSelection?: GlobalDateComparisonSelection;
+    dateComparisonInputs?: ResolvedDashboardDateComparisonInput[];
     variablesById: Record<string, ResolvedDashboardInput>;
     missingRequiredInputs: ResolvedDashboardInput[];
 };
@@ -2009,6 +2032,8 @@ declare type ResolvedPrimaryDateField = {
     entityName: string;
     entityType: string;
     dataType: string;
+    /** Canonical dataset coordinates stamped by the temporal grounding boundary. */
+    source?: SemaphorSourceRef;
     dateFormat?: string;
     customFormat?: string;
     defaultGranularity?: TimeGranularity;

package/dist/types/types.d.ts

@@ -2350,6 +2350,14 @@ export declare type LoadingProps = {
 
 export declare type LogicalOperator = 'AND' | 'OR';
 
+/**
+ * A comparison input proven to be present in the card's executed filter set.
+ * Ownership and UI coverage must consume this stage, never source inputs.
+ */
+export declare type MaterializedDashboardDateComparisonInput = ResolvedDashboardDateComparisonInput & {
+    effectiveFilterValue: TFilterValue;
+};
+
 declare type MatrixAxisLevelDescriptor = {
     instanceId: string;
     fieldKey: string;
@@ -2889,6 +2897,20 @@ export declare type RelativeDateFilter = {
 
 export declare type RelativeDateUnit = DateUnit | SubDayDateUnit;
 
+export declare type ResolvedDashboardDateComparisonInput = {
+    inputId: string;
+    filterId: string;
+    label: string;
+    filter: TFilter;
+    /**
+     * The active value before execution-only canonicalization. Comparison
+     * ownership uses this value as provenance evidence and must fail closed
+     * when its filter or field identity does not match the definition.
+     */
+    filterValue?: TFilterValue;
+    selection: GlobalDateComparisonSelection;
+};
+
 export declare type ResolvedDashboardInput = {
     id: string;
     kind: 'filter' | 'control';
@@ -2917,6 +2939,7 @@ export declare type ResolvedDashboardInputContext = {
     controlValues: Record<string, unknown>;
     variablesByName: Record<string, ResolvedDashboardInput>;
     globalDateComparisonSelection?: GlobalDateComparisonSelection;
+    dateComparisonInputs?: ResolvedDashboardDateComparisonInput[];
     variablesById: Record<string, ResolvedDashboardInput>;
     missingRequiredInputs: ResolvedDashboardInput[];
 };
@@ -2941,6 +2964,8 @@ declare type ResolvedPrimaryDateField = {
     entityName: string;
     entityType: string;
     dataType: string;
+    /** Canonical dataset coordinates stamped by the temporal grounding boundary. */
+    source?: SemaphorSourceRef;
     dateFormat?: string;
     customFormat?: string;
     defaultGranularity?: TimeGranularity;

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.425",
+  "version": "0.1.426",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",