react-semaphor 0.1.477 → 0.1.479

package/dist/types/dashboard.d.ts

@@ -702,6 +702,16 @@ declare type DashboardAIContext = AIContext & {
 
 declare type DashboardAIContextMode = 'auto' | 'fixed';
 
+/** Instance references applied to the latest linked library definition. */
+export declare type DashboardCardReferenceRemapping = {
+    cardIds?: Record<string, string>;
+    sheetIds?: Record<string, string>;
+    inputIds?: Record<string, string>;
+    controlIds?: Record<string, string>;
+    filterIds?: Record<string, string>;
+    inputAliases?: Record<string, DashboardInputVariableRef>;
+};
+
 export declare type DashboardEventHandlers = {
     onExportData?: (payload: ExportDataPayload) => void;
 };
@@ -1492,7 +1502,7 @@ export declare type EmailSettings = {
     senderTitle: string;
 };
 
-export declare type EmbeddedFilterDashboardInput = DashboardInputBase & {
+export declare type EmbeddedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter: TFilter;
     filterReference?: never;
@@ -1620,6 +1630,12 @@ declare interface FilterCondition {
 
 export declare type FilterDashboardInput = EmbeddedFilterDashboardInput | ReferencedFilterDashboardInput;
 
+/** Filter-only lifecycle policy, independent of requiredAtExecution. */
+declare type FilterDashboardInputBase = DashboardInputBase & {
+    /** Empty selections restore the authored default; viewers may replace it. */
+    forceSelection?: boolean;
+};
+
 /**
  * Display mode for individual filters
  * - 'canvas': Filter displayed as a draggable card on the dashboard canvas
@@ -2140,7 +2156,7 @@ declare type NoneOptions = {};
 export declare type NormalizedDashboardInput = NormalizedFilterDashboardInput | ControlDashboardInput;
 
 /** Runtime form after dashboard-filter references are resolved once. */
-export declare type NormalizedFilterDashboardInput = DashboardInputBase & {
+export declare type NormalizedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter: TFilter;
     optionSource?: DashboardFilterOptionSource;
@@ -2307,7 +2323,7 @@ declare type RawTemporalPresentationTarget = {
     columnKey: string;
 };
 
-export declare type ReferencedFilterDashboardInput = DashboardInputBase & {
+export declare type ReferencedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter?: never;
     filterReference: {
@@ -3225,6 +3241,7 @@ export declare type TCard = {
     config?: CardConfig;
     interactionConfig?: CardInteractionConfig;
     linkedSourceCardId?: string;
+    linkedReferenceOverrides?: DashboardCardReferenceRemapping;
     linkedInteractionTargetOverrides?: Record<string, InteractionTargetOverride>;
     paginationConfig?: PaginationConfig;
     queryConfig?: QueryConfig;

package/dist/types/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/common-types-C1IM7gao.cjs"),t=require("../chunks/token-types-CoHsSJ4E.cjs"),E=require("../chunks/pivot-result-identity-DRUlTWUq.cjs"),l=require("../chunks/report-runtime-context-RFiWq4wK.cjs");exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.LEGACY_CALCULATED_FIELD_ENTITY_MARKER=e.LEGACY_CALCULATED_FIELD_ENTITY_MARKER;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.hasSyntheticCalculatedFieldOwner=e.hasSyntheticCalculatedFieldOwner;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=t.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=E.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=E.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=l.DEFAULT_CALENDAR_CONTEXT;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/common-types-BCSbPclk.cjs"),t=require("../chunks/token-types-D9eN35rf.cjs"),E=require("../chunks/pivot-result-identity-BVnhG2rR.cjs"),l=require("../chunks/report-runtime-context-BfW4qiMJ.cjs");exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.LEGACY_CALCULATED_FIELD_ENTITY_MARKER=e.LEGACY_CALCULATED_FIELD_ENTITY_MARKER;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.hasSyntheticCalculatedFieldOwner=e.hasSyntheticCalculatedFieldOwner;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=t.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=E.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=E.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=l.DEFAULT_CALENDAR_CONTEXT;

package/dist/types/index.js

@@ -1,7 +1,7 @@
-import { a as s, C as E, D as C, E as l, L as r, P as A, g as t, d as _, h as T, e as o, b as u, c as L, i } from "../chunks/common-types-BLPy5_E0.js";
-import { D as n } from "../chunks/token-types-DfDtCqlw.js";
-import { r as d, a as F } from "../chunks/pivot-result-identity-CIZXsI53.js";
-import { D as c } from "../chunks/report-runtime-context-DNbgCsko.js";
+import { a as s, C as E, D as C, E as l, L as r, P as A, g as t, d as _, h as T, e as o, b as u, c as L, i } from "../chunks/common-types-D3r4PILe.js";
+import { D as n } from "../chunks/token-types-Dvomvqw0.js";
+import { r as d, a as F } from "../chunks/pivot-result-identity-BIeP9v8I.js";
+import { D as c } from "../chunks/report-runtime-context-B_pAmqxl.js";
 export {
   s as CALCULATED_FIELD_ENTITY_MARKER,
   E as CONTROL_CARD_DEFAULT_VALUE,

package/dist/types/main.d.ts

@@ -46,10 +46,12 @@ declare type Actions_2 = {
     updateFilterDashboardInputDefinition: (inputId: string, filter: TFilter, metadata?: {
         variableName?: string;
         label?: string;
+        forceSelection?: boolean;
+        exports?: DashboardInput['exports'];
     }) => void;
-    acceptDashboardFilterOptionSource: (updatedFilter: TFilter, optionSource: DashboardFilterOptionSource, settings?: DashboardFilterAuthoringSettingsUpdate, inputMetadata?: {
+    acceptDashboardFilterInput: (updatedFilter: TFilter, optionSource: DashboardFilterOptionSource | undefined, settings?: DashboardFilterAuthoringSettingsUpdate, inputMetadata?: {
         variableName?: string;
-    }) => DashboardFilterOptionSourceAcceptanceResult;
+    }) => DashboardFilterInputAcceptanceResult;
     acceptDashboardFilterMapping: (request: DashboardFilterMappingAuthoringRequest, updatedFilter?: TFilter, settings?: DashboardFilterAuthoringSettingsUpdate) => DashboardFilterMappingAcceptanceResult;
     disableDashboardFilterMapping: (filterId: string, updatedFilter?: TFilter, settings?: DashboardFilterAuthoringSettingsUpdate) => DashboardFilterMappingDisableResult;
     removeDashboardInput: (inputId: string) => void;
@@ -101,6 +103,7 @@ declare type Actions_2 = {
     setDashboardDescription: (description: string) => void;
     setSheets: (sheets: TSheet[]) => void;
     addSheet: (sheet: TSheet) => void;
+    duplicateSheet: (sheetId: string) => string | null;
     deleteSheet: (sheetId: string) => void;
     setSheetTitle: (sheetId: string, title: string) => void;
     updateSheetDocument: (sheetId: string, updater: (document: DocumentDefinition) => DocumentDefinition) => void;
@@ -1985,6 +1988,16 @@ export declare type DashboardBriefingLauncherProps = {
     client?: Partial<DashboardBriefingLauncherClient>;
 };
 
+/** Instance references applied to the latest linked library definition. */
+export declare type DashboardCardReferenceRemapping = {
+    cardIds?: Record<string, string>;
+    sheetIds?: Record<string, string>;
+    inputIds?: Record<string, string>;
+    controlIds?: Record<string, string>;
+    filterIds?: Record<string, string>;
+    inputAliases?: Record<string, DashboardInputVariableRef>;
+};
+
 declare type DashboardCardSizeIntent = 'kpi' | 'chart' | 'table' | 'text';
 
 declare type DashboardControlsModelOptions = {
@@ -2063,11 +2076,12 @@ export declare type DashboardFilterApplication = {
 };
 
 declare type DashboardFilterAuthoringSettingsUpdate = {
-    defaultValueChanged: boolean;
-    defaultFilterValue?: TFilterValue;
-    defaultComparisonChanged: boolean;
+    forceSelection?: boolean;
+    /** Explicit reset of a persisted default slot that may lack a backing default. */
+    defaultValueChanged?: boolean;
+    defaultComparisonChanged?: boolean;
     defaultComparisonSelection?: GlobalDateComparisonSelection;
-    target: DashboardInputRuntimeTarget;
+    target?: DashboardInputRuntimeTarget;
     optionSourceChanged?: boolean;
     optionSource?: DashboardFilterOptionSource;
     /** Raw selection identity changed; the previous runtime value is invalid. */
@@ -2149,6 +2163,15 @@ export declare type DashboardFilterExcludedCardApplication = {
     cardId: string;
 };
 
+declare type DashboardFilterInputAcceptanceResult = {
+    ok: true;
+    input: ReferencedFilterDashboardInput;
+    created: boolean;
+} | {
+    ok: false;
+    issues: DashboardFilterMappingAuthoringIssue[];
+};
+
 declare type DashboardFilterMappingAcceptanceResult = {
     ok: true;
     draft: DashboardFilterMappingDraft;
@@ -2244,15 +2267,6 @@ declare type DashboardFilterMappingDraftStatus = 'pendingSource' | 'automatic' |
 /** Persisted label/value option definition for a mapped dashboard filter. */
 export declare type DashboardFilterOptionSource = SemaphorInputOptionSource;
 
-declare type DashboardFilterOptionSourceAcceptanceResult = {
-    ok: true;
-    input: ReferencedFilterDashboardInput;
-    created: boolean;
-} | {
-    ok: false;
-    issues: DashboardFilterMappingAuthoringIssue[];
-};
-
 export declare type DashboardFilterTarget = {
     kind: 'field';
     field: DashboardFilterTargetField;
@@ -3452,7 +3466,7 @@ export declare type EmailSettings = {
     senderTitle: string;
 };
 
-export declare type EmbeddedFilterDashboardInput = DashboardInputBase & {
+export declare type EmbeddedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter: TFilter;
     filterReference?: never;
@@ -3753,6 +3767,12 @@ export declare interface FilterCondition {
 
 export declare type FilterDashboardInput = EmbeddedFilterDashboardInput | ReferencedFilterDashboardInput;
 
+/** Filter-only lifecycle policy, independent of requiredAtExecution. */
+declare type FilterDashboardInputBase = DashboardInputBase & {
+    /** Empty selections restore the authored default; viewers may replace it. */
+    forceSelection?: boolean;
+};
+
 /**
  * Display mode for individual filters
  * - 'canvas': Filter displayed as a draggable card on the dashboard canvas
@@ -4930,7 +4950,7 @@ export declare function normalizeDashboardForDirtyCheck(dashboard: TDashboard |
 export declare type NormalizedDashboardInput = NormalizedFilterDashboardInput | ControlDashboardInput;
 
 /** Runtime form after dashboard-filter references are resolved once. */
-export declare type NormalizedFilterDashboardInput = DashboardInputBase & {
+export declare type NormalizedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter: TFilter;
     optionSource?: DashboardFilterOptionSource;
@@ -5266,7 +5286,7 @@ declare type RawTemporalValueMetadata = {
     valueKind: RawTemporalValueKind;
 };
 
-export declare type ReferencedFilterDashboardInput = DashboardInputBase & {
+export declare type ReferencedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter?: never;
     filterReference: {
@@ -6713,6 +6733,7 @@ export declare type TCard = {
     config?: CardConfig;
     interactionConfig?: CardInteractionConfig;
     linkedSourceCardId?: string;
+    linkedReferenceOverrides?: DashboardCardReferenceRemapping;
     linkedInteractionTargetOverrides?: Record<string, InteractionTargetOverride>;
     paginationConfig?: PaginationConfig;
     queryConfig?: QueryConfig;

package/dist/types/shared.d.ts

@@ -561,6 +561,16 @@ declare type DashboardAIContext = AIContext & {
 
 declare type DashboardAIContextMode = 'auto' | 'fixed';
 
+/** Instance references applied to the latest linked library definition. */
+declare type DashboardCardReferenceRemapping = {
+    cardIds?: Record<string, string>;
+    sheetIds?: Record<string, string>;
+    inputIds?: Record<string, string>;
+    controlIds?: Record<string, string>;
+    filterIds?: Record<string, string>;
+    inputAliases?: Record<string, DashboardInputVariableRef>;
+};
+
 declare type DashboardFilterApplication = {
     kind: 'cardMappings';
     /**
@@ -1146,7 +1156,7 @@ declare type EmailSettings = {
     senderTitle: string;
 };
 
-declare type EmbeddedFilterDashboardInput = DashboardInputBase & {
+declare type EmbeddedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter: TFilter;
     filterReference?: never;
@@ -1261,6 +1271,12 @@ declare interface FilterCondition {
 
 declare type FilterDashboardInput = EmbeddedFilterDashboardInput | ReferencedFilterDashboardInput;
 
+/** Filter-only lifecycle policy, independent of requiredAtExecution. */
+declare type FilterDashboardInputBase = DashboardInputBase & {
+    /** Empty selections restore the authored default; viewers may replace it. */
+    forceSelection?: boolean;
+};
+
 /**
  * Display mode for individual filters
  * - 'canvas': Filter displayed as a draggable card on the dashboard canvas
@@ -1772,7 +1788,7 @@ declare type RangeValue = {
     gt?: string | number;
 };
 
-declare type ReferencedFilterDashboardInput = DashboardInputBase & {
+declare type ReferencedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter?: never;
     filterReference: {
@@ -2448,6 +2464,7 @@ declare type TCard = {
     config?: CardConfig;
     interactionConfig?: CardInteractionConfig;
     linkedSourceCardId?: string;
+    linkedReferenceOverrides?: DashboardCardReferenceRemapping;
     linkedInteractionTargetOverrides?: Record<string, InteractionTargetOverride>;
     paginationConfig?: PaginationConfig;
     queryConfig?: QueryConfig;

package/dist/types/surfboard.d.ts

@@ -700,6 +700,16 @@ declare type DashboardAIContext = AIContext & {
 
 declare type DashboardAIContextMode = 'auto' | 'fixed';
 
+/** Instance references applied to the latest linked library definition. */
+export declare type DashboardCardReferenceRemapping = {
+    cardIds?: Record<string, string>;
+    sheetIds?: Record<string, string>;
+    inputIds?: Record<string, string>;
+    controlIds?: Record<string, string>;
+    filterIds?: Record<string, string>;
+    inputAliases?: Record<string, DashboardInputVariableRef>;
+};
+
 export declare type DashboardEventHandlers = {
     onExportData?: (payload: ExportDataPayload) => void;
 };
@@ -1505,7 +1515,7 @@ export declare type EmailSettings = {
     senderTitle: string;
 };
 
-export declare type EmbeddedFilterDashboardInput = DashboardInputBase & {
+export declare type EmbeddedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter: TFilter;
     filterReference?: never;
@@ -1633,6 +1643,12 @@ declare interface FilterCondition {
 
 export declare type FilterDashboardInput = EmbeddedFilterDashboardInput | ReferencedFilterDashboardInput;
 
+/** Filter-only lifecycle policy, independent of requiredAtExecution. */
+declare type FilterDashboardInputBase = DashboardInputBase & {
+    /** Empty selections restore the authored default; viewers may replace it. */
+    forceSelection?: boolean;
+};
+
 /**
  * Display mode for individual filters
  * - 'canvas': Filter displayed as a draggable card on the dashboard canvas
@@ -2153,7 +2169,7 @@ declare type NoneOptions = {};
 export declare type NormalizedDashboardInput = NormalizedFilterDashboardInput | ControlDashboardInput;
 
 /** Runtime form after dashboard-filter references are resolved once. */
-export declare type NormalizedFilterDashboardInput = DashboardInputBase & {
+export declare type NormalizedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter: TFilter;
     optionSource?: DashboardFilterOptionSource;
@@ -2320,7 +2336,7 @@ declare type RawTemporalPresentationTarget = {
     columnKey: string;
 };
 
-export declare type ReferencedFilterDashboardInput = DashboardInputBase & {
+export declare type ReferencedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter?: never;
     filterReference: {
@@ -3247,6 +3263,7 @@ export declare type TCard = {
     config?: CardConfig;
     interactionConfig?: CardInteractionConfig;
     linkedSourceCardId?: string;
+    linkedReferenceOverrides?: DashboardCardReferenceRemapping;
     linkedInteractionTargetOverrides?: Record<string, InteractionTargetOverride>;
     paginationConfig?: PaginationConfig;
     queryConfig?: QueryConfig;

package/dist/types/types.d.ts

@@ -1210,6 +1210,16 @@ declare type DashboardAIContext = AIContext & {
 
 declare type DashboardAIContextMode = 'auto' | 'fixed';
 
+/** Instance references applied to the latest linked library definition. */
+export declare type DashboardCardReferenceRemapping = {
+    cardIds?: Record<string, string>;
+    sheetIds?: Record<string, string>;
+    inputIds?: Record<string, string>;
+    controlIds?: Record<string, string>;
+    filterIds?: Record<string, string>;
+    inputAliases?: Record<string, DashboardInputVariableRef>;
+};
+
 export declare type DashboardEventHandlers = {
     onExportData?: (payload: ExportDataPayload) => void;
 };
@@ -2077,7 +2087,7 @@ export declare type EmailSettings = {
     senderTitle: string;
 };
 
-export declare type EmbeddedFilterDashboardInput = DashboardInputBase & {
+export declare type EmbeddedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter: TFilter;
     filterReference?: never;
@@ -2215,6 +2225,12 @@ export declare interface FilterCondition {
 
 export declare type FilterDashboardInput = EmbeddedFilterDashboardInput | ReferencedFilterDashboardInput;
 
+/** Filter-only lifecycle policy, independent of requiredAtExecution. */
+declare type FilterDashboardInputBase = DashboardInputBase & {
+    /** Empty selections restore the authored default; viewers may replace it. */
+    forceSelection?: boolean;
+};
+
 /**
  * Display mode for individual filters
  * - 'canvas': Filter displayed as a draggable card on the dashboard canvas
@@ -3042,7 +3058,7 @@ declare type NoneOptions = {};
 export declare type NormalizedDashboardInput = NormalizedFilterDashboardInput | ControlDashboardInput;
 
 /** Runtime form after dashboard-filter references are resolved once. */
-export declare type NormalizedFilterDashboardInput = DashboardInputBase & {
+export declare type NormalizedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter: TFilter;
     optionSource?: DashboardFilterOptionSource;
@@ -3348,7 +3364,7 @@ declare type RawTemporalValueMetadata = {
     valueKind: RawTemporalValueKind;
 };
 
-export declare type ReferencedFilterDashboardInput = DashboardInputBase & {
+export declare type ReferencedFilterDashboardInput = FilterDashboardInputBase & {
     kind: 'filter';
     filter?: never;
     filterReference: {
@@ -4437,6 +4453,7 @@ export declare type TCard = {
     config?: CardConfig;
     interactionConfig?: CardInteractionConfig;
     linkedSourceCardId?: string;
+    linkedReferenceOverrides?: DashboardCardReferenceRemapping;
     linkedInteractionTargetOverrides?: Record<string, InteractionTargetOverride>;
     paginationConfig?: PaginationConfig;
     queryConfig?: QueryConfig;

package/package.json

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