react-semaphor 0.1.425 → 0.1.427

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-ogxedhSY.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-DuGX1NPV.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-DSxho2LN.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-DE4tk3t3.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

@@ -44,8 +44,8 @@ declare type Actions_2 = {
     upsertDashboardInput: (input: DashboardInput) => void;
     removeDashboardInput: (inputId: string) => void;
     setDefaultDashboardInputValues: (values: DashboardInputValues | undefined) => void;
+    setDefaultDashboardInputComparisonSelection: (input: Pick<DashboardInput, 'id' | 'runtimeScope'>, target: DashboardInputRuntimeTarget, selection: GlobalDateComparisonSelection | 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 +73,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 +1930,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 +2360,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 +3693,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 +4023,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 +4826,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 +4868,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 +4895,7 @@ declare type ResolvedMetricComparisonRequest = {
 } | {
     source: 'inherited';
     spec: ViewerPeriodComparisonSpec;
+    owner?: DashboardDateComparisonOwner;
 };
 
 declare type ResolvedPrimaryDateField = {
@@ -4879,6 +4908,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;
@@ -6950,6 +6981,24 @@ export declare type UIConfig = {
      * If unset, runtime falls back to `showBriefings`; if both are unset, briefings are visible.
      */
     showBriefings?: boolean;
+    /**
+     * Controls visibility of the Dashboard Hub navigation control.
+     * Defaults to true unless explicitly disabled. This does not grant access
+     * to the dashboard hub when the token identity cannot navigate there.
+     */
+    showDashboardHub?: boolean;
+    /**
+     * Controls visibility of dashboard sharing controls.
+     * Defaults to true unless explicitly disabled. This does not grant sharing
+     * permissions when the current user cannot share the dashboard.
+     */
+    showDashboardSharing?: boolean;
+    /**
+     * Controls visibility of group-management controls.
+     * Defaults to true unless explicitly disabled. This does not grant group
+     * management permissions to the current user.
+     */
+    showGroupManagement?: boolean;
     /**
      * Effective project-level feature visibility projected by semaphor-app.
      * Project policy can disable features for every token; embed config can only

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;
@@ -4669,6 +4694,24 @@ export declare type UIConfig = {
      * If unset, runtime falls back to `showBriefings`; if both are unset, briefings are visible.
      */
     showBriefings?: boolean;
+    /**
+     * Controls visibility of the Dashboard Hub navigation control.
+     * Defaults to true unless explicitly disabled. This does not grant access
+     * to the dashboard hub when the token identity cannot navigate there.
+     */
+    showDashboardHub?: boolean;
+    /**
+     * Controls visibility of dashboard sharing controls.
+     * Defaults to true unless explicitly disabled. This does not grant sharing
+     * permissions when the current user cannot share the dashboard.
+     */
+    showDashboardSharing?: boolean;
+    /**
+     * Controls visibility of group-management controls.
+     * Defaults to true unless explicitly disabled. This does not grant group
+     * management permissions to the current user.
+     */
+    showGroupManagement?: boolean;
     /**
      * Effective project-level feature visibility projected by semaphor-app.
      * Project policy can disable features for every token; embed config can only

package/package.json

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