@gooddata/sdk-ui-dashboard 11.40.0-alpha.0 → 11.40.0-alpha.2

package/esm/model/events/index.d.ts

@@ -15,7 +15,7 @@ import { type IDashboardRenderModeChanged } from "./renderMode.js";
 import { type IDashboardRichTextWidgetContentChanged, type IDashboardRichTextWidgetFilterSettingsChanged } from "./richText.js";
 import { type IDashboardAutomationsRefreshed, type IDashboardScheduledEmailCreated, type IDashboardScheduledEmailSaved } from "./scheduledEmail.js";
 import { type IShowWidgetAsTableSet } from "./showWidgetAsTable.js";
-import { type IDashboardTabConvertedFromDefault, type IDashboardTabCreated, type IDashboardTabDeleted, type IDashboardTabRenamed, type IDashboardTabRenamingCanceled, type IDashboardTabRenamingStarted, type IDashboardTabSwitched } from "./tabs.js";
+import { type IDashboardTabCreated, type IDashboardTabDeleted, type IDashboardTabRenamed, type IDashboardTabRenamingCanceled, type IDashboardTabRenamingStarted, type IDashboardTabSwitched } from "./tabs.js";
 import { type IDashboardUserInteractionTriggered } from "./userInteraction.js";
 import { type IDashboardVisualizationSwitcherWidgetVisualizationAdded, type IDashboardVisualizationSwitcherWidgetVisualizationsUpdated } from "./visualizationSwitcher.js";
 import { type IDashboardWidgetExecutionFailed, type IDashboardWidgetExecutionStarted, type IDashboardWidgetExecutionSucceeded } from "./widget.js";
@@ -29,7 +29,7 @@ import { type IDashboardWidgetExecutionFailed, type IDashboardWidgetExecutionSta
  *
  * @public
  */
-export type DashboardEvents = DashboardInitialized | DashboardDeinitialized | DateFilterValidationFailed | DashboardSaved | DashboardCopySaved | DashboardRenderRequested | DashboardAsyncRenderRequested | DashboardAsyncRenderResolved | DashboardRenderResolved | DashboardSharingChanged | IDashboardRenderModeChanged | IDashboardCommandStarted<any> | IDashboardCommandFailed<any> | IDashboardCommandRejected | IDashboardQueryFailed | IDashboardQueryRejected | IDashboardQueryStarted | IDashboardQueryCompleted<any, any> | IDashboardRenamed | IDashboardWasReset | IDashboardExportToPdfRequested | IDashboardExportToPdfResolved | IDashboardExportToExcelRequested | IDashboardExportToExcelResolved | IDashboardExportToPdfPresentationRequested | IDashboardExportToPdfPresentationResolved | IDashboardExportToPptPresentationResolved | IDashboardExportToPptPresentationRequested | IDashboardExportToImageRequested | IDashboardExportToImageResolved | IDashboardUserInteractionTriggered | DashboardDateFilterSelectionChanged | IDashboardAttributeFilterAdded | IDashboardAttributeFilterRemoved | IDashboardAttributeFilterMoved | DashboardAttributeFilterSelectionChanged | DashboardAttributeFilterItemSelectionReplaced | IDashboardAttributeTitleChanged | IDashboardAttributeSelectionModeChanged | IDashboardAttributeFilterParentChanged | IDashboardMeasureValueFilterAdded | IDashboardMeasureValueFilterMoved | IDashboardMeasureValueFilterRemoved | IDashboardMeasureValueFilterConditionChanged | IDashboardMeasureValueFilterDimensionalityChanged | IDashboardMeasureValueFilterTitleChanged | IDashboardMeasureValueFilterConfigModeChanged | DashboardFilterContextChanged | IDashboardLayoutSectionAdded | IDashboardLayoutSectionMoved | IDashboardLayoutSectionRemoved | IDashboardLayoutSectionHeaderChanged | IDashboardLayoutSectionItemsAdded | IDashboardLayoutSectionItemReplaced | IDashboardLayoutSectionItemMoved | IDashboardLayoutSectionItemRemoved | IDashboardLayoutSectionItemMovedToNewSection | IDashboardLayoutChanged | IDashboardKpiWidgetHeaderChanged | IDashboardKpiWidgetDescriptionChanged | IDashboardKpiWidgetConfigurationChanged | IDashboardKpiWidgetMeasureChanged | IDashboardKpiWidgetFilterSettingsChanged | IDashboardKpiWidgetComparisonChanged | IDashboardKpiWidgetDrillRemoved | IDashboardKpiWidgetDrillSet | IDashboardKpiWidgetChanged | IDashboardInsightWidgetHeaderChanged | IDashboardInsightWidgetDescriptionChanged | IDashboardInsightWidgetFilterSettingsChanged | IDashboardInsightWidgetVisPropertiesChanged | IDashboardInsightWidgetVisConfigurationChanged | IDashboardInsightWidgetInsightSwitched | IDashboardInsightWidgetDrillsModified | IDashboardInsightWidgetDrillsRemoved | IDashboardInsightWidgetChanged | IDashboardInsightWidgetExportRequested | IDashboardInsightWidgetExportResolved | IDashboardInsightWidgetRefreshed | IDashboardRichTextWidgetContentChanged | IDashboardRichTextWidgetFilterSettingsChanged | IDashboardVisualizationSwitcherWidgetVisualizationAdded | IDashboardVisualizationSwitcherWidgetVisualizationsUpdated | IDashboardWidgetExecutionStarted | IDashboardWidgetExecutionSucceeded | IDashboardWidgetExecutionFailed | IDashboardAlertCreated | IDashboardAlertSaved | IDashboardScheduledEmailCreated | IDashboardScheduledEmailSaved | IDashboardAutomationsRefreshed | IShowWidgetAsTableSet | IDashboardDrillDownResolved | IDashboardDrillToAttributeUrlResolved | IDashboardDrillToCustomUrlResolved | IDashboardDrillToDashboardResolved | IDashboardDrillToInsightResolved | IDashboardDrillToLegacyDashboardResolved | IDashboardKeyDriverAnalysisResolved | IDashboardKeyDriverAnalysisRequested | IDashboardDrillResolved | IDashboardDrillDownRequested | IDashboardDrillToAttributeUrlRequested | IDashboardDrillToCustomUrlRequested | IDashboardDrillToDashboardRequested | IDashboardDrillToInsightRequested | IDashboardDrillToLegacyDashboardRequested | IDashboardDrillRequested | IDashboardDrillableItemsChanged | IDashboardIgnoreExecutionTimestampChanged | IDashboardTabSwitched | IDashboardTabConvertedFromDefault | IDashboardTabCreated | IDashboardTabDeleted | IDashboardTabRenamingStarted | IDashboardTabRenamingCanceled | IDashboardTabRenamed | IDashboardParametersSelectionReset | ICreateInsightRequested | ICreateAttributeHierarchyRequested | IDeleteAttributeHierarchyRequested;
+export type DashboardEvents = DashboardInitialized | DashboardDeinitialized | DateFilterValidationFailed | DashboardSaved | DashboardCopySaved | DashboardRenderRequested | DashboardAsyncRenderRequested | DashboardAsyncRenderResolved | DashboardRenderResolved | DashboardSharingChanged | IDashboardRenderModeChanged | IDashboardCommandStarted<any> | IDashboardCommandFailed<any> | IDashboardCommandRejected | IDashboardQueryFailed | IDashboardQueryRejected | IDashboardQueryStarted | IDashboardQueryCompleted<any, any> | IDashboardRenamed | IDashboardWasReset | IDashboardExportToPdfRequested | IDashboardExportToPdfResolved | IDashboardExportToExcelRequested | IDashboardExportToExcelResolved | IDashboardExportToPdfPresentationRequested | IDashboardExportToPdfPresentationResolved | IDashboardExportToPptPresentationResolved | IDashboardExportToPptPresentationRequested | IDashboardExportToImageRequested | IDashboardExportToImageResolved | IDashboardUserInteractionTriggered | DashboardDateFilterSelectionChanged | IDashboardAttributeFilterAdded | IDashboardAttributeFilterRemoved | IDashboardAttributeFilterMoved | DashboardAttributeFilterSelectionChanged | DashboardAttributeFilterItemSelectionReplaced | IDashboardAttributeTitleChanged | IDashboardAttributeSelectionModeChanged | IDashboardAttributeFilterParentChanged | IDashboardMeasureValueFilterAdded | IDashboardMeasureValueFilterMoved | IDashboardMeasureValueFilterRemoved | IDashboardMeasureValueFilterConditionChanged | IDashboardMeasureValueFilterDimensionalityChanged | IDashboardMeasureValueFilterTitleChanged | IDashboardMeasureValueFilterConfigModeChanged | DashboardFilterContextChanged | IDashboardLayoutSectionAdded | IDashboardLayoutSectionMoved | IDashboardLayoutSectionRemoved | IDashboardLayoutSectionHeaderChanged | IDashboardLayoutSectionItemsAdded | IDashboardLayoutSectionItemReplaced | IDashboardLayoutSectionItemMoved | IDashboardLayoutSectionItemRemoved | IDashboardLayoutSectionItemMovedToNewSection | IDashboardLayoutChanged | IDashboardKpiWidgetHeaderChanged | IDashboardKpiWidgetDescriptionChanged | IDashboardKpiWidgetConfigurationChanged | IDashboardKpiWidgetMeasureChanged | IDashboardKpiWidgetFilterSettingsChanged | IDashboardKpiWidgetComparisonChanged | IDashboardKpiWidgetDrillRemoved | IDashboardKpiWidgetDrillSet | IDashboardKpiWidgetChanged | IDashboardInsightWidgetHeaderChanged | IDashboardInsightWidgetDescriptionChanged | IDashboardInsightWidgetFilterSettingsChanged | IDashboardInsightWidgetVisPropertiesChanged | IDashboardInsightWidgetVisConfigurationChanged | IDashboardInsightWidgetInsightSwitched | IDashboardInsightWidgetDrillsModified | IDashboardInsightWidgetDrillsRemoved | IDashboardInsightWidgetChanged | IDashboardInsightWidgetExportRequested | IDashboardInsightWidgetExportResolved | IDashboardInsightWidgetRefreshed | IDashboardRichTextWidgetContentChanged | IDashboardRichTextWidgetFilterSettingsChanged | IDashboardVisualizationSwitcherWidgetVisualizationAdded | IDashboardVisualizationSwitcherWidgetVisualizationsUpdated | IDashboardWidgetExecutionStarted | IDashboardWidgetExecutionSucceeded | IDashboardWidgetExecutionFailed | IDashboardAlertCreated | IDashboardAlertSaved | IDashboardScheduledEmailCreated | IDashboardScheduledEmailSaved | IDashboardAutomationsRefreshed | IShowWidgetAsTableSet | IDashboardDrillDownResolved | IDashboardDrillToAttributeUrlResolved | IDashboardDrillToCustomUrlResolved | IDashboardDrillToDashboardResolved | IDashboardDrillToInsightResolved | IDashboardDrillToLegacyDashboardResolved | IDashboardKeyDriverAnalysisResolved | IDashboardKeyDriverAnalysisRequested | IDashboardDrillResolved | IDashboardDrillDownRequested | IDashboardDrillToAttributeUrlRequested | IDashboardDrillToCustomUrlRequested | IDashboardDrillToDashboardRequested | IDashboardDrillToInsightRequested | IDashboardDrillToLegacyDashboardRequested | IDashboardDrillRequested | IDashboardDrillableItemsChanged | IDashboardIgnoreExecutionTimestampChanged | IDashboardTabSwitched | IDashboardTabCreated | IDashboardTabDeleted | IDashboardTabRenamingStarted | IDashboardTabRenamingCanceled | IDashboardTabRenamed | IDashboardParametersSelectionReset | ICreateInsightRequested | ICreateAttributeHierarchyRequested | IDeleteAttributeHierarchyRequested;
 /**
  * Creates DashboardEvent predicate that test whether the provided event matches it.
  *

package/esm/model/events/tabs.d.ts

@@ -129,50 +129,6 @@ export declare function dashboardTabCreated(ctx: DashboardContext, newTabId: str
  * @alpha
  */
 export declare const isDashboardTabCreated: (event: any) => event is IDashboardTabCreated;
-/**
- * Payload of the {@link IDashboardTabConvertedFromDefault} event.
- * @alpha
- */
-export interface IDashboardTabConvertedFromDefaultPayload {
-    /**
-     * Identifier of the newly created tab.
-     */
-    readonly newTabId: string;
-    /**
-     * Index at which the new tab was inserted.
-     */
-    readonly index: number;
-}
-/**
- * This event is emitted when a default dashboard tab is converted to a regular tab.
- *
- * @alpha
- */
-export interface IDashboardTabConvertedFromDefault extends IDashboardEvent {
-    readonly type: "GDC.DASH/EVT.TAB.CONVERTED_FROM_DEFAULT";
-    readonly payload: IDashboardTabConvertedFromDefaultPayload;
-}
-/**
- * Creates the DashboardTabConvertedFromDefault event.
- *
- * @param ctx - dashboard context
- * @param newTabId - identifier of the newly created tab
- * @param index - index at which the new tab was inserted
- * @param correlationId - correlation id to use for this event
- * @returns dashboard tab converted from default event
- *
- * @alpha
- */
-export declare function dashboardTabConvertedFromDefault(ctx: DashboardContext, newTabId: string, index: number, correlationId?: string): IDashboardTabConvertedFromDefault;
-/**
- * Type guard that checks if an event is a DashboardTabConvertedFromDefault event.
- *
- * @param event - event to check
- * @returns true if the event is a DashboardTabConvertedFromDefault event
- *
- * @alpha
- */
-export declare const isDashboardTabConvertedFromDefault: (event: any) => event is IDashboardTabConvertedFromDefault;
 /**
  * Payload of the {@link IDashboardTabDeleted} event.
  * @alpha

package/esm/model/events/tabs.js

@@ -89,34 +89,6 @@ export function dashboardTabCreated(ctx, newTabId, index, correlationId) {
  * @alpha
  */
 export const isDashboardTabCreated = (event) => event.type === "GDC.DASH/EVT.TAB.CREATED";
-/**
- * Creates the DashboardTabConvertedFromDefault event.
- *
- * @param ctx - dashboard context
- * @param newTabId - identifier of the newly created tab
- * @param index - index at which the new tab was inserted
- * @param correlationId - correlation id to use for this event
- * @returns dashboard tab converted from default event
- *
- * @alpha
- */
-export function dashboardTabConvertedFromDefault(ctx, newTabId, index, correlationId) {
-    return {
-        type: "GDC.DASH/EVT.TAB.CONVERTED_FROM_DEFAULT",
-        ctx,
-        correlationId,
-        payload: { newTabId, index },
-    };
-}
-/**
- * Type guard that checks if an event is a DashboardTabConvertedFromDefault event.
- *
- * @param event - event to check
- * @returns true if the event is a DashboardTabConvertedFromDefault event
- *
- * @alpha
- */
-export const isDashboardTabConvertedFromDefault = (event) => event.type === "GDC.DASH/EVT.TAB.CONVERTED_FROM_DEFAULT";
 /**
  * Creates the DashboardTabDeleted event.
  *

package/esm/model/react/useDashboardCommand.d.ts

@@ -156,7 +156,6 @@ export declare const useDashboardCommand: <TCommand extends DashboardCommands, T
     "GDC.DASH/EVT.SCHEDULED_EMAIL.SAVED"?: ((event: import("../events/scheduledEmail.js").IDashboardScheduledEmailSaved) => void) | undefined;
     "GDC.DASH/EVT.SHARING.CHANGED"?: ((event: import("../events/dashboard.js").DashboardSharingChanged) => void) | undefined;
     "GDC.DASH/EVT.SHOW_WIDGET_AS_TABLE.SET"?: ((event: import("../events/showWidgetAsTable.js").IShowWidgetAsTableSet) => void) | undefined;
-    "GDC.DASH/EVT.TAB.CONVERTED_FROM_DEFAULT"?: ((event: import("../events/tabs.js").IDashboardTabConvertedFromDefault) => void) | undefined;
     "GDC.DASH/EVT.TAB.CREATED"?: ((event: import("../events/tabs.js").IDashboardTabCreated) => void) | undefined;
     "GDC.DASH/EVT.TAB.DELETED"?: ((event: import("../events/tabs.js").IDashboardTabDeleted) => void) | undefined;
     "GDC.DASH/EVT.TAB.RENAMED"?: ((event: import("../events/tabs.js").IDashboardTabRenamed) => void) | undefined;

package/esm/model/react/useDashboardCommandProcessing.d.ts

@@ -193,8 +193,6 @@ export declare const useDashboardCommandProcessing: <TCommand extends DashboardC
         type: TSuccessEventType;
     }> | Extract<import("../events/scheduledEmail.js").IDashboardScheduledEmailSaved, {
         type: TSuccessEventType;
-    }> | Extract<import("../events/tabs.js").IDashboardTabConvertedFromDefault, {
-        type: TSuccessEventType;
     }> | Extract<import("../events/tabs.js").IDashboardTabCreated, {
         type: TSuccessEventType;
     }> | Extract<import("../events/tabs.js").IDashboardTabDeleted, {
@@ -436,8 +434,6 @@ export declare const useDashboardCommandProcessing: <TCommand extends DashboardC
         type: TErrorEventType;
     }> | Extract<import("../events/scheduledEmail.js").IDashboardScheduledEmailSaved, {
         type: TErrorEventType;
-    }> | Extract<import("../events/tabs.js").IDashboardTabConvertedFromDefault, {
-        type: TErrorEventType;
     }> | Extract<import("../events/tabs.js").IDashboardTabCreated, {
         type: TErrorEventType;
     }> | Extract<import("../events/tabs.js").IDashboardTabDeleted, {

package/esm/model/store/tabs/index.d.ts

@@ -40,6 +40,12 @@ export declare const tabsActions: import("@reduxjs/toolkit").CaseReducerActions<
         };
         type: string;
     }>;
+    readonly resolveDefaultTab: import("./tabsReducers.js").TabsReducer<{
+        payload: {
+            newLocalIdentifier: string;
+        };
+        type: string;
+    }>;
     readonly changeAttributeFilterConfigMode: (state: import("immer").WritableDraft<import("./tabsState.js").ITabsState>, action: {
         payload: import("../../commands/dashboard.js").ISetDashboardAttributeFilterConfigModePayload;
         type: string;

package/esm/model/store/tabs/layout/layoutSelectors.d.ts

@@ -1,10 +1,11 @@
-import { type DrillDefinition, type IDashboardLayout, type IDrillDownReference, type IDrillToLegacyDashboard, type IKpiWidget, type IWidget, type InsightDrillDefinition, type ObjRef, type ScreenSize } from "@gooddata/sdk-model";
+import { type DrillDefinition, type IDashboardLayout, type IDrillDownReference, type IDrillToLegacyDashboard, type IInsightWidget, type IKpiWidget, type IWidget, type InsightDrillDefinition, type ObjRef, type ScreenSize } from "@gooddata/sdk-model";
 import { type ObjRefMap } from "../../../../_staging/metadata/objRefMap.js";
 import { type IDashboardFilter, type ILayoutCoordinates, type ILayoutItemPath } from "../../../../types.js";
 import { type DashboardLayoutCommands } from "../../../commands/layout.js";
 import { type ExtendedDashboardWidget, type ICustomWidget } from "../../../types/layoutTypes.js";
 import { type IUndoableCommand } from "../../_infra/undoEnhancer.js";
 import { type DashboardSelector } from "../../types.js";
+import { type ITabState } from "../tabsState.js";
 import { type LayoutStash } from "./layoutState.js";
 /**
  * Returns layout keyed by tab identifier.
@@ -248,6 +249,45 @@ export declare const selectKpiWidgetPlaceholderCoordinates: DashboardSelector<IL
  * @alpha
  */
 export declare const selectWidgetIgnoreCrossFiltering: (ref: ObjRef) => DashboardSelector<boolean>;
+/**
+ * Per-tab widget contexts. Each entry pairs a widget with its owning tab; nested layout widgets
+ * and visualization switcher children are flattened in. Used by cross-tab widget lookups.
+ *
+ * @internal
+ */
+export interface IWidgetTabContext {
+    tab: ITabState;
+    widget: ExtendedDashboardWidget;
+}
+/**
+ * `IWidgetTabContext` narrowed to its insight-widget shape.
+ *
+ * @internal
+ */
+export interface IInsightWidgetTabContext extends IWidgetTabContext {
+    widget: IInsightWidget;
+}
+/**
+ * Cross-tab widget contexts. Walks every tab's layout (including nested layouts and visualization
+ * switcher children) once and pairs each widget with its owning tab. Consumers needing to resolve
+ * a widget's owning tab by ref or identifier should `.find()` against this array.
+ *
+ * @internal
+ */
+export declare const selectAllTabsWidgetContexts: DashboardSelector<IWidgetTabContext[]>;
+/**
+ * `selectAllTabsWidgetContexts` pre-filtered to insight-widget contexts so consumers can `.find()`
+ * against an already-narrowed array.
+ *
+ * @internal
+ */
+export declare const selectAllTabsInsightWidgetContexts: DashboardSelector<IInsightWidgetTabContext[]>;
+/**
+ * Type guard for narrowing an `IWidgetTabContext` to `IInsightWidgetTabContext`.
+ *
+ * @internal
+ */
+export declare function isInsightWidgetTabContext(context: IWidgetTabContext): context is IInsightWidgetTabContext;
 /**
  * Selects the local identifier of the tab that contains the specified widget.
  * Returns undefined if the widget is not found in any tab.

package/esm/model/store/tabs/layout/layoutSelectors.js

@@ -452,6 +452,44 @@ export const selectKpiWidgetPlaceholderCoordinates = createSelector(selectKpiWid
 export const selectWidgetIgnoreCrossFiltering = createMemoizedSelector((ref) => createSelector(selectAnalyticalWidgetByRef(ref), (widget) => {
     return widget?.ignoreCrossFiltering ?? false;
 }));
+/**
+ * Cross-tab widget contexts. Walks every tab's layout (including nested layouts and visualization
+ * switcher children) once and pairs each widget with its owning tab. Consumers needing to resolve
+ * a widget's owning tab by ref or identifier should `.find()` against this array.
+ *
+ * @internal
+ */
+export const selectAllTabsWidgetContexts = createSelector(selectTabs, (tabs) => {
+    if (!tabs) {
+        return [];
+    }
+    const result = [];
+    for (const tab of tabs) {
+        const layout = tab.layout?.layout;
+        if (!layout) {
+            continue;
+        }
+        for (const widget of getLayoutWidgets(layout)) {
+            result.push({ tab, widget });
+        }
+    }
+    return result;
+});
+/**
+ * `selectAllTabsWidgetContexts` pre-filtered to insight-widget contexts so consumers can `.find()`
+ * against an already-narrowed array.
+ *
+ * @internal
+ */
+export const selectAllTabsInsightWidgetContexts = createSelector(selectAllTabsWidgetContexts, (contexts) => contexts.filter(isInsightWidgetTabContext));
+/**
+ * Type guard for narrowing an `IWidgetTabContext` to `IInsightWidgetTabContext`.
+ *
+ * @internal
+ */
+export function isInsightWidgetTabContext(context) {
+    return isInsightWidget(context.widget);
+}
 /**
  * Selects the local identifier of the tab that contains the specified widget.
  * Returns undefined if the widget is not found in any tab.

package/esm/model/store/tabs/parameters/parametersHelpers.d.ts

@@ -0,0 +1,86 @@
+import { type IDashboardParameterValueOverride } from "@gooddata/sdk-backend-spi";
+import { type IDashboardParameter, type IDashboardTab, type IInsight, type IInsightDefinition, type IParameterMetadataObject, type IdentifierRef } from "@gooddata/sdk-model";
+import { type ObjRefMap } from "../../../../_staging/metadata/objRefMap.js";
+import { type IInsightWidgetTabContext } from "../layout/layoutSelectors.js";
+import { type ITabState } from "../tabsState.js";
+import { type IDashboardParameterEntry } from "./parametersState.js";
+/**
+ * @internal
+ */
+export declare const EMPTY_EXPORT_PARAMETERS: Record<string, IDashboardParameterValueOverride[]>;
+/**
+ * Walks the insight's metric buckets and returns the parameter refs they reference,
+ * deduped by ref string. The order matches the first occurrence in the measure traversal.
+ *
+ * @internal
+ */
+export declare function collectReferencedParameterRefs(insight: IInsightDefinition, measureParameters: Record<string, IdentifierRef[]>): IdentifierRef[];
+/**
+ * Resolves a single parameter entry to the export wire shape. Returns `undefined` for entries with
+ * no `runtimeOverride` — the dashboard's persisted parameter state and the workspace default are
+ * applied by the backend on its own, and insight-level `insight.parameters` are applied per-insight
+ * by the backend; sending a row in those cases would override the backend's resolution with a stale
+ * FE snapshot (matches the live-render path in `selectEffectiveParameterValuesForWidget`).
+ *
+ * Title precedence (when a row is emitted): `parameter.label` → workspace title → `ref.identifier`.
+ *
+ * @internal
+ */
+export declare function formatDashboardParameter(entry: IDashboardParameterEntry, workspaceParameter: IParameterMetadataObject | undefined): IDashboardParameterValueOverride | undefined;
+/**
+ * Resolves the persisted shape of a parameter entry against its workspace catalog parameter.
+ * Drops `value` when it equals the workspace default; drops `label` when it equals the workspace title.
+ *
+ * @internal
+ */
+export declare function smartPersistResolvedEntry(entry: IDashboardParameterEntry, workspaceParameter: IParameterMetadataObject): IDashboardParameter;
+/**
+ * Builds the persisted-parameter lookup keyed by tab and then by ref string. Honors V1 → per-tab
+ * migration: when no tab in the persisted dashboard carries `parameters`, the persisted root
+ * `parameters` is used as fallback for every tab.
+ *
+ * @internal
+ */
+export declare function buildPersistedByTabAndRef(persistedTabs: ReadonlyArray<IDashboardTab>, rootPersistedParameters: IDashboardParameter[]): Map<string, Map<string, IDashboardParameter>>;
+/**
+ * Returns `undefined` when reset would be a no-op: missing/non-number workspace parameter, or
+ * in edit mode when `parameter.value` is unset / already equals the workspace default.
+ *
+ * @internal
+ */
+export declare function computeParameterResetValue(entry: IDashboardParameterEntry, workspaceParameter: IParameterMetadataObject | undefined, isInEditMode: boolean): number | undefined;
+/**
+ * Only `mode: "active"` entries with a defined `runtimeOverride` are considered resettable;
+ * HIDDEN and READONLY entries are skipped, and entries with `runtimeOverride === undefined`
+ * (chip hidden, execution falls back to `insight.parameters`) are preserved as-is — symmetric
+ * with per-chip behavior in `DashboardParameterFilter`.
+ *
+ * @internal
+ */
+export declare function computeParameterResetTargets(entries: IDashboardParameterEntry[], workspaceParameters: IParameterMetadataObject[], isInEditMode: boolean): {
+    ref: IDashboardParameterEntry["parameter"]["ref"];
+    value: number | undefined;
+}[];
+/**
+ * Folds per-tab ref selections into the wire shape, dropping entries without a
+ * `runtimeOverride`. Each selection pairs a tab with an optional ref restriction:
+ * `allowedRefs === undefined` selects all refs (whole-dashboard scope); a defined set restricts
+ * entries to those refs (widget scope). Tabs that yield no rows are omitted from the result.
+ *
+ * @internal
+ */
+export declare function collectExportOverrides(tabRefSelections: ReadonlyArray<{
+    tab: ITabState;
+    allowedRefs?: Set<string>;
+}>, workspaceByRef: Map<string, IParameterMetadataObject>): Record<string, IDashboardParameterValueOverride[]>;
+/**
+ * Builds per-tab ref selections for a widget-scope export: each widget's owning tab is restricted
+ * to refs referenced by the widget's insight metrics. Multiple widgets on the same tab union their
+ * refs.
+ *
+ * @internal
+ */
+export declare function buildWidgetScopeTabRefSelections(widgetContexts: ReadonlyArray<IInsightWidgetTabContext>, widgetIds: ReadonlyArray<string>, insights: ObjRefMap<IInsight>, measureParameters: Record<string, IdentifierRef[]>): {
+    tab: ITabState;
+    allowedRefs: Set<string>;
+}[];

package/esm/model/store/tabs/parameters/parametersHelpers.js

@@ -0,0 +1,208 @@
+// (C) 2026 GoodData Corporation
+import { DashboardParameterModeValues, insightMeasures, isMeasureDefinition, isNumberParameterDefinition, objRefToString, } from "@gooddata/sdk-model";
+import { parametersInitialState, pickTabParametersSource, } from "./parametersState.js";
+const EMPTY_PARAMETERS = [];
+/**
+ * @internal
+ */
+export const EMPTY_EXPORT_PARAMETERS = {};
+/**
+ * Walks the insight's metric buckets and returns the parameter refs they reference,
+ * deduped by ref string. The order matches the first occurrence in the measure traversal.
+ *
+ * @internal
+ */
+export function collectReferencedParameterRefs(insight, measureParameters) {
+    const seen = new Set();
+    const result = [];
+    for (const measure of insightMeasures(insight)) {
+        const def = measure.measure.definition;
+        if (!isMeasureDefinition(def)) {
+            continue;
+        }
+        const refs = measureParameters[objRefToString(def.measureDefinition.item)] ?? [];
+        for (const ref of refs) {
+            const key = objRefToString(ref);
+            if (seen.has(key)) {
+                continue;
+            }
+            seen.add(key);
+            result.push(ref);
+        }
+    }
+    return result;
+}
+/**
+ * Resolves a single parameter entry to the export wire shape. Returns `undefined` for entries with
+ * no `runtimeOverride` — the dashboard's persisted parameter state and the workspace default are
+ * applied by the backend on its own, and insight-level `insight.parameters` are applied per-insight
+ * by the backend; sending a row in those cases would override the backend's resolution with a stale
+ * FE snapshot (matches the live-render path in `selectEffectiveParameterValuesForWidget`).
+ *
+ * Title precedence (when a row is emitted): `parameter.label` → workspace title → `ref.identifier`.
+ *
+ * @internal
+ */
+export function formatDashboardParameter(entry, workspaceParameter) {
+    if (entry.runtimeOverride === undefined) {
+        return undefined;
+    }
+    const ref = entry.parameter.ref;
+    return {
+        id: ref.identifier,
+        value: String(entry.runtimeOverride),
+        title: entry.parameter.label || workspaceParameter?.title || ref.identifier,
+    };
+}
+/**
+ * Resolves the persisted shape of a parameter entry against its workspace catalog parameter.
+ * Drops `value` when it equals the workspace default; drops `label` when it equals the workspace title.
+ *
+ * @internal
+ */
+export function smartPersistResolvedEntry(entry, workspaceParameter) {
+    const workspaceDefault = isNumberParameterDefinition(workspaceParameter.definition)
+        ? workspaceParameter.definition.defaultValue
+        : undefined;
+    const result = {
+        ref: entry.parameter.ref,
+        parameterType: entry.parameter.parameterType,
+        mode: entry.parameter.mode,
+        ...labelOverride(entry, workspaceParameter),
+    };
+    if (entry.runtimeOverride === undefined || entry.runtimeOverride === workspaceDefault) {
+        return result;
+    }
+    return { ...result, value: entry.runtimeOverride };
+}
+function labelOverride(entry, workspaceParameter) {
+    if (entry.parameter.label && entry.parameter.label !== workspaceParameter.title) {
+        return { label: entry.parameter.label };
+    }
+    return {};
+}
+/**
+ * Builds the persisted-parameter lookup keyed by tab and then by ref string. Honors V1 → per-tab
+ * migration: when no tab in the persisted dashboard carries `parameters`, the persisted root
+ * `parameters` is used as fallback for every tab.
+ *
+ * @internal
+ */
+export function buildPersistedByTabAndRef(persistedTabs, rootPersistedParameters) {
+    const result = new Map();
+    for (const tab of persistedTabs) {
+        const sourceParameters = pickTabParametersSource(tab, persistedTabs, rootPersistedParameters) ?? EMPTY_PARAMETERS;
+        result.set(tab.localIdentifier, new Map(sourceParameters.map((parameter) => [objRefToString(parameter.ref), parameter])));
+    }
+    return result;
+}
+/**
+ * Returns `undefined` when reset would be a no-op: missing/non-number workspace parameter, or
+ * in edit mode when `parameter.value` is unset / already equals the workspace default.
+ *
+ * @internal
+ */
+export function computeParameterResetValue(entry, workspaceParameter, isInEditMode) {
+    if (!workspaceParameter || !isNumberParameterDefinition(workspaceParameter.definition)) {
+        return undefined;
+    }
+    const workspaceDefault = workspaceParameter.definition.defaultValue;
+    const dashboardOverride = entry.parameter.value;
+    if (isInEditMode) {
+        if (dashboardOverride === undefined || dashboardOverride === workspaceDefault) {
+            return undefined;
+        }
+        return workspaceDefault;
+    }
+    return dashboardOverride ?? workspaceDefault;
+}
+/**
+ * Only `mode: "active"` entries with a defined `runtimeOverride` are considered resettable;
+ * HIDDEN and READONLY entries are skipped, and entries with `runtimeOverride === undefined`
+ * (chip hidden, execution falls back to `insight.parameters`) are preserved as-is — symmetric
+ * with per-chip behavior in `DashboardParameterFilter`.
+ *
+ * @internal
+ */
+export function computeParameterResetTargets(entries, workspaceParameters, isInEditMode) {
+    const workspaceByRef = new Map(workspaceParameters.map((wp) => [objRefToString(wp.ref), wp]));
+    const result = [];
+    for (const entry of entries) {
+        if (entry.parameter.mode !== DashboardParameterModeValues.ACTIVE) {
+            continue;
+        }
+        if (entry.runtimeOverride === undefined) {
+            continue;
+        }
+        const workspaceParameter = workspaceByRef.get(objRefToString(entry.parameter.ref));
+        const resetValue = computeParameterResetValue(entry, workspaceParameter, isInEditMode);
+        if (resetValue !== undefined && resetValue !== entry.runtimeOverride) {
+            result.push({ ref: entry.parameter.ref, value: resetValue });
+        }
+    }
+    return result;
+}
+/**
+ * Folds per-tab ref selections into the wire shape, dropping entries without a
+ * `runtimeOverride`. Each selection pairs a tab with an optional ref restriction:
+ * `allowedRefs === undefined` selects all refs (whole-dashboard scope); a defined set restricts
+ * entries to those refs (widget scope). Tabs that yield no rows are omitted from the result.
+ *
+ * @internal
+ */
+export function collectExportOverrides(tabRefSelections, workspaceByRef) {
+    const result = {};
+    for (const { tab, allowedRefs } of tabRefSelections) {
+        const entries = tab.parameters?.parameters ?? parametersInitialState.parameters;
+        const scoped = allowedRefs
+            ? entries.filter((entry) => allowedRefs.has(objRefToString(entry.parameter.ref)))
+            : entries;
+        const rows = formatEntries(scoped, workspaceByRef);
+        if (rows.length > 0) {
+            result[tab.localIdentifier] = rows;
+        }
+    }
+    return Object.keys(result).length === 0 ? EMPTY_EXPORT_PARAMETERS : result;
+}
+/**
+ * Builds per-tab ref selections for a widget-scope export: each widget's owning tab is restricted
+ * to refs referenced by the widget's insight metrics. Multiple widgets on the same tab union their
+ * refs.
+ *
+ * @internal
+ */
+export function buildWidgetScopeTabRefSelections(widgetContexts, widgetIds, insights, measureParameters) {
+    const byTab = new Map();
+    for (const widgetId of widgetIds) {
+        const context = widgetContexts.find((ctx) => ctx.widget.identifier === widgetId);
+        if (!context) {
+            continue;
+        }
+        const insight = insights.get(context.widget.insight);
+        if (!insight) {
+            continue;
+        }
+        const referencedRefs = collectReferencedParameterRefs(insight, measureParameters);
+        if (referencedRefs.length === 0) {
+            continue;
+        }
+        const tabId = context.tab.localIdentifier;
+        const existing = byTab.get(tabId) ?? { tab: context.tab, allowedRefs: new Set() };
+        for (const ref of referencedRefs) {
+            existing.allowedRefs.add(objRefToString(ref));
+        }
+        byTab.set(tabId, existing);
+    }
+    return [...byTab.values()];
+}
+function formatEntries(entries, workspaceByRef) {
+    const rows = [];
+    for (const entry of entries) {
+        const workspaceParameter = workspaceByRef.get(objRefToString(entry.parameter.ref));
+        const row = formatDashboardParameter(entry, workspaceParameter);
+        if (row !== undefined) {
+            rows.push(row);
+        }
+    }
+    return rows;
+}

package/esm/model/store/tabs/parameters/parametersSelectors.d.ts

@@ -1,4 +1,5 @@
-import { type IDashboardParameter, type IInsightParameterValue, type IParameterMetadataObject, type ObjRef } from "@gooddata/sdk-model";
+import { type IDashboardParameterValueOverride } from "@gooddata/sdk-backend-spi";
+import { type IDashboardParameter, type IInsightParameterValue, type ObjRef } from "@gooddata/sdk-model";
 import { type DashboardSelector } from "../../types.js";
 import { type IDashboardParameterEntry } from "./parametersState.js";
 /**
@@ -108,21 +109,25 @@ export declare const selectHasAnyResettableParameterOnActiveTab: DashboardSelect
  */
 export declare const selectEffectiveParameterValuesForWidget: (ref: ObjRef | undefined) => DashboardSelector<IInsightParameterValue[]>;
 /**
- * Returns `undefined` when reset would be a no-op: missing/non-number workspace parameter, or
- * in edit mode when `parameter.value` is unset / already equals the workspace default.
+ * Returns the per-tab parameter overrides to send on dashboard tabular export, keyed by
+ * tab `localIdentifier`. The shape matches the backend's `dashboardTabsParametersOverrides`
+ * field directly.
  *
- * @internal
- */
-export declare function computeParameterResetValue(entry: IDashboardParameterEntry, workspaceParameter: IParameterMetadataObject | undefined, isInEditMode: boolean): number | undefined;
-/**
- * Only `mode: "active"` entries with a defined `runtimeOverride` are considered resettable;
- * HIDDEN and READONLY entries are skipped, and entries with `runtimeOverride === undefined`
- * (chip hidden, execution falls back to `insight.parameters`) are preserved as-is — symmetric
- * with per-chip behavior in `DashboardParameterFilter`.
+ * @remarks
+ * Scope rules:
+ * - When `widgetIds` is empty/undefined (whole-dashboard export), every tab in scope contributes
+ *   parameter entries with a `runtimeOverride`.
+ * - When `widgetIds` is non-empty, each widget's owning tab contributes only entries with a
+ *   `runtimeOverride` whose ref is referenced by the widget's insight metrics via the dashboard-wide
+ *   metric → parameter dependency map. Multi-widget across distinct owning tabs yields one
+ *   map entry per owning tab; entries for the same tab are unioned and deduplicated by ref.
+ *
+ * Returns `{}` (signalling "omit the field on the wire") when:
+ * - `enableParameters` is off,
+ * - the workspace catalog parameters are not loaded,
+ * - (widget scope only) the `measureParameters` dependency map is not loaded,
+ * - or no in-scope parameter has a `runtimeOverride`.
  *
- * @internal
+ * @alpha
  */
-export declare function computeParameterResetTargets(entries: IDashboardParameterEntry[], workspaceParameters: IParameterMetadataObject[], isInEditMode: boolean): {
-    ref: ObjRef;
-    value: number | undefined;
-}[];
+export declare const selectExportEffectiveParameters: (widgetIds: string[] | undefined) => DashboardSelector<Record<string, IDashboardParameterValueOverride[]>>;