@gooddata/sdk-ui-filters 11.50.0-alpha.2 → 11.50.0-alpha.4

package/esm/AttributeFilter/hooks/useElementsFilterController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useElementsFilterController.d.ts","sourceRoot":"","sources":["../../../src/AttributeFilter/hooks/useElementsFilterController.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AACxG,OAAO,EACH,KAAK,qCAAqC,EAC1C,KAAK,mBAAmB,EAExB,KAAK,iBAAiB,EAEtB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,MAAM,EAed,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AAG7E,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAYlF,OAAO,EAEH,KAAK,wBAAwB,EAEhC,MAAM,YAAY,CAAC;AA06BpB;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC3C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB,CAAC,EAAE,6BAA6B,EAAE,GAAG,IAAI,CAAC;IAClE,mBAAmB,CAAC,EAAE,CAAC,mBAAmB,GAAG,mBAAmB,CAAC,EAAE,GAAG,IAAI,CAAC;IAC3E,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAChG,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACrC,eAAe,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,aAAa,EAAE,qCAAqC,CAAC;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qDAAqD,CAAC,EAAE,OAAO,CAAC;IAChE,wCAAwC,EAAE,OAAO,CAAC;IAClD,mCAAmC,EAAE,OAAO,CAAC;IAC7C,+BAA+B,EAAE,OAAO,CAAC;IACzC,oCAAoC,EAAE,OAAO,CAAC;IAC9C,4BAA4B,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACjE,oGAAoG;IACpG,oBAAoB,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1C,+GAA+G;IAC/G,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,8BAA8B,GAAG,wBAAwB,CA4M3G"}
+{"version":3,"file":"useElementsFilterController.d.ts","sourceRoot":"","sources":["../../../src/AttributeFilter/hooks/useElementsFilterController.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AACxG,OAAO,EACH,KAAK,qCAAqC,EAC1C,KAAK,mBAAmB,EAExB,KAAK,iBAAiB,EAEtB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,MAAM,EAed,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AAG7E,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAYlF,OAAO,EAEH,KAAK,wBAAwB,EAEhC,MAAM,YAAY,CAAC;AAw7BpB;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC3C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB,CAAC,EAAE,6BAA6B,EAAE,GAAG,IAAI,CAAC;IAClE,mBAAmB,CAAC,EAAE,CAAC,mBAAmB,GAAG,mBAAmB,CAAC,EAAE,GAAG,IAAI,CAAC;IAC3E,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,iBAAiB,CAAC,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAChG,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACrC,eAAe,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,aAAa,EAAE,qCAAqC,CAAC;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qDAAqD,CAAC,EAAE,OAAO,CAAC;IAChE,wCAAwC,EAAE,OAAO,CAAC;IAClD,mCAAmC,EAAE,OAAO,CAAC;IAC7C,+BAA+B,EAAE,OAAO,CAAC;IACzC,oCAAoC,EAAE,OAAO,CAAC;IAC9C,4BAA4B,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACjE,oGAAoG;IACpG,oBAAoB,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1C,+GAA+G;IAC/G,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,8BAA8B,GAAG,wBAAwB,CA4M3G"}

package/esm/AttributeFilter/hooks/useElementsFilterController.js

@@ -285,8 +285,17 @@ function useInitOrReload(handler, props, supportsKeepingDependentFiltersSelectio
             !isEqual(limitingAttributeFilters, handler.getLimitingAttributeFilters());
         const limitingDateFiltersChanged = shouldIncludeLimitingFilters && !isEqual(limitingDateFilters, handler.getLimitingDateFilters());
         const getFilterChanged = (filter, handler) => {
+            // When the handler migrated the filter internally to a different label (displayAs
+            // handling of filters saved directly with a secondary label), the handler's filter
+            // never equals the label-based prop again. A prop that is still identical to the
+            // filter the handler was initialized from is then not an external change — without
+            // this, a working-selection edit racing the parent's display-form sync re-render is
+            // mistaken for an external update and resets the in-progress selection.
+            const isMigratedToOtherLabel = !areObjRefsEqual(filterObjRef(filter), filterObjRef(handler.getFilter()));
+            const isUnchangedOriginalOfMigrated = isMigratedToOtherLabel && areFiltersEqual(filter, handler.getOriginalFilter());
             return (!areFiltersEqual(filter, handler.getFilter()) &&
-                !areFiltersEqual(filter, handler.getFilterToDisplay()));
+                !areFiltersEqual(filter, handler.getFilterToDisplay()) &&
+                !isUnchangedOriginalOfMigrated);
         };
         // When text→elements mode switch happens, resetForModeSwitch already committed the target
         // selection (restored List selection or "All") to the handler. Suppress filterChanged so we

package/esm/DateFilter/utils/DateFilterConfigConversions.d.ts

@@ -0,0 +1,15 @@
+import { type IDateFilterConfig } from "@gooddata/sdk-model";
+import { type IDateFilterOptionsByType } from "../interfaces/index.js";
+/**
+ * Converts a workspace date filter config — as stored on the backend — into the date filter options
+ * the {@link DateFilter} component consumes (its `filterOptions` prop).
+ *
+ * @remarks
+ * Extracted from sdk-ui-dashboard so non-dashboard hosts (e.g. conditional formatting's date
+ * condition picker) consume the same workspace preset catalog; dashboards re-export it.
+ *
+ * @param config - date filter config from backend
+ * @alpha
+ */
+export declare function convertDateFilterConfigToDateFilterOptions(config: IDateFilterConfig): IDateFilterOptionsByType;
+//# sourceMappingURL=DateFilterConfigConversions.d.ts.map

package/esm/DateFilter/utils/DateFilterConfigConversions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateFilterConfigConversions.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/utils/DateFilterConfigConversions.ts"],"names":[],"mappings":"AAKA,OAAO,EAIH,KAAK,iBAAiB,EAIzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAGH,KAAK,wBAAwB,EAIhC,MAAM,wBAAwB,CAAC;AAOhC;;;;;;;;;;GAUG;AACH,wBAAgB,0CAA0C,CACtD,MAAM,EAAE,iBAAiB,GAC1B,wBAAwB,CAgB1B"}

package/esm/DateFilter/utils/DateFilterConfigConversions.js

@@ -0,0 +1,86 @@
+// (C) 2019-2026 GoodData Corporation
+import { endOfDay, format, startOfDay, subMonths } from "date-fns";
+import { groupBy, max, min } from "lodash-es";
+import { removeEmptyKeysFromDateFilterOptions } from "./OptionUtils.js";
+// date-fns tokens of the platform date-time format (Platform.ts holds the moment spelling).
+const PLATFORM_DATE_FORMAT = "yyyy-MM-dd HH:mm";
+/**
+ * Converts a workspace date filter config — as stored on the backend — into the date filter options
+ * the {@link DateFilter} component consumes (its `filterOptions` prop).
+ *
+ * @remarks
+ * Extracted from sdk-ui-dashboard so non-dashboard hosts (e.g. conditional formatting's date
+ * condition picker) consume the same workspace preset catalog; dashboards re-export it.
+ *
+ * @param config - date filter config from backend
+ * @alpha
+ */
+export function convertDateFilterConfigToDateFilterOptions(config) {
+    const allTime = convertAllTime(config.allTime);
+    const emptyValues = convertEmptyValues(config.emptyValues);
+    const absoluteForm = convertAbsoluteForm(config.absoluteForm);
+    const relativeForm = convertRelativeForm(config.relativeForm);
+    const absolutePreset = convertAbsolutePresets(config.absolutePresets);
+    const relativePreset = convertRelativePresets(config.relativePresets);
+    return removeEmptyKeysFromDateFilterOptions({
+        allTime,
+        emptyValues,
+        absoluteForm,
+        absolutePreset,
+        relativeForm,
+        relativePreset,
+    });
+}
+function convertAllTime(filter) {
+    return (filter && {
+        ...filter,
+        type: "allTime",
+    });
+}
+function convertEmptyValues(filter) {
+    return (filter && {
+        ...filter,
+        type: "emptyValues",
+    });
+}
+function convertAbsoluteForm(filter) {
+    const now = new Date();
+    return (filter && {
+        ...filter,
+        from: format(startOfDay(subMonths(now, 1)), PLATFORM_DATE_FORMAT),
+        to: format(endOfDay(now), PLATFORM_DATE_FORMAT),
+        type: "absoluteForm",
+    });
+}
+function convertRelativeForm(filter) {
+    return (filter && {
+        from: undefined,
+        // we order the granularities anyway, this lets the user to config the default
+        granularity: filter.availableGranularities[0],
+        localIdentifier: filter.localIdentifier,
+        name: filter.name,
+        to: undefined,
+        type: "relativeForm",
+        visible: filter.visible,
+    });
+}
+function convertAbsolutePresets(filters) {
+    return filters?.map((preset) => sanitizeDateFilterOption({
+        ...preset,
+        type: "absolutePreset",
+    }));
+}
+function convertRelativePresets(filters) {
+    return (filters &&
+        groupBy(filters.map((preset) => sanitizeDateFilterOption({
+            ...preset,
+            type: "relativePreset",
+        })), (preset) => preset.granularity));
+}
+function sanitizeDateFilterOption(option) {
+    return {
+        ...option,
+        from: min([option.from, option.to]),
+        to: max([option.from, option.to]),
+    };
+}

package/esm/DateFilter/utils/DateFilterOptionMapping.d.ts

@@ -0,0 +1,46 @@
+import { type IDashboardDateFilter } from "@gooddata/sdk-model";
+import { type DateFilterOption, type IDateFilterOptionsByType } from "../interfaces/index.js";
+/**
+ * A matched date filter option together with the reconstructed exclude-current-period state.
+ *
+ * @alpha
+ */
+export interface IDateFilterOptionInfo {
+    dateFilterOption: DateFilterOption;
+    excludeCurrentPeriod: boolean;
+}
+/**
+ * Tries to match a preset or a form with the provided value. Prioritizes the provided option if possible.
+ *
+ * @remarks
+ * This is to handle cases when user picked a form and filled values that match an existing preset.
+ * In those cases we want to show the form as picked even though a preset would otherwise be preferred.
+ *
+ * @param dateFilter - value to match against
+ * @param availableOptions - date options available
+ * @param preferredOptionId - id of the option that should be matched first if possible
+ * @alpha
+ */
+export declare function matchDateFilterToDateFilterOptionWithPreference(dateFilter: IDashboardDateFilter | undefined, availableOptions: IDateFilterOptionsByType, preferredOptionId: string | undefined): IDateFilterOptionInfo;
+/**
+ * Tries to match a preset or a form with the provided value. Prioritizes presets over forms.
+ * @param dateFilterValue - value to match against
+ * @param availableOptions - date options available
+ * @alpha
+ */
+export declare function matchDateFilterToDateFilterOption(dateFilter: IDashboardDateFilter | undefined, availableOptions: IDateFilterOptionsByType): IDateFilterOptionInfo;
+/**
+ * Flattens the provided date filter options. The flattening maintains a stable, predefined order in which
+ * the options should be rendered by the date filter component.
+ *
+ * @param dateFilterOptions - available options to flatten
+ * @alpha
+ */
+export declare function flattenDateFilterOptions(dateFilterOptions: IDateFilterOptionsByType): DateFilterOption[];
+/**
+ * Finds the date filter option whose stored value equals the provided filter's value.
+ *
+ * @alpha
+ */
+export declare function findDateFilterOptionByValue(dateFilter: IDashboardDateFilter, dateFilterOptions: IDateFilterOptionsByType): DateFilterOption | undefined;
+//# sourceMappingURL=DateFilterOptionMapping.d.ts.map

package/esm/DateFilter/utils/DateFilterOptionMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateFilterOptionMapping.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/utils/DateFilterOptionMapping.ts"],"names":[],"mappings":"AAIA,OAAO,EAIH,KAAK,oBAAoB,EAK5B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAKhC,MAAM,wBAAwB,CAAC;AAYhC;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAClC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,oBAAoB,EAAE,OAAO,CAAC;CACjC;AAaD;;;;;;;;;;;GAWG;AACH,wBAAgB,+CAA+C,CAC3D,UAAU,EAAE,oBAAoB,GAAG,SAAS,EAC5C,gBAAgB,EAAE,wBAAwB,EAC1C,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACtC,qBAAqB,CAmBvB;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC7C,UAAU,EAAE,oBAAoB,GAAG,SAAS,EAC5C,gBAAgB,EAAE,wBAAwB,GAC3C,qBAAqB,CA6EvB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,iBAAiB,EAAE,wBAAwB,GAAG,gBAAgB,EAAE,CAcxG;AAsDD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACvC,UAAU,EAAE,oBAAoB,EAChC,iBAAiB,EAAE,wBAAwB,gCAG9C"}

package/esm/DateFilter/utils/DateFilterOptionMapping.js

@@ -0,0 +1,279 @@
+// (C) 2021-2026 GoodData Corporation
+import { compact } from "lodash-es";
+import { isAllTimeDashboardDateFilter, isLowerBound, isUpperBound, } from "@gooddata/sdk-model";
+import { isAbsoluteDateFilterOption, isRelativeDateFilterOption, } from "../interfaces/index.js";
+import { revertExcludedCurrentPeriodRange } from "./PeriodExclusion.js";
+const VIRTUAL_PRESET_IDENTIFIER = "GDC__VIRTUAL_PRESET";
+const virtualPresetBase = {
+    localIdentifier: VIRTUAL_PRESET_IDENTIFIER,
+    name: "",
+    visible: false,
+};
+const isAllTimeDateFilter = (dateFilter) => dateFilter && isAllTimeDashboardDateFilter(dateFilter);
+function applyEmptyValueHandling(dateFilterOption, dateFilter) {
+    const emptyValueHandling = dateFilter?.dateFilter.emptyValueHandling;
+    return emptyValueHandling ? { ...dateFilterOption, emptyValueHandling } : dateFilterOption;
+}
+/**
+ * Tries to match a preset or a form with the provided value. Prioritizes the provided option if possible.
+ *
+ * @remarks
+ * This is to handle cases when user picked a form and filled values that match an existing preset.
+ * In those cases we want to show the form as picked even though a preset would otherwise be preferred.
+ *
+ * @param dateFilter - value to match against
+ * @param availableOptions - date options available
+ * @param preferredOptionId - id of the option that should be matched first if possible
+ * @alpha
+ */
+export function matchDateFilterToDateFilterOptionWithPreference(dateFilter, availableOptions, preferredOptionId) {
+    const preferredOption = preferredOptionId
+        ? findDateFilterOptionById(preferredOptionId, availableOptions)
+        : undefined;
+    const isAllTime = isAllTimeDateFilter(dateFilter);
+    // we only really need to handle the cases when the selected option is a form
+    // other cases are correctly handled by the unbiased matching function
+    if (dateFilter &&
+        !isAllTime &&
+        (preferredOption?.type === "absoluteForm" || preferredOption?.type === "relativeForm") &&
+        canReconstructFormForStoredFilter(availableOptions, dateFilter)) {
+        return reconstructFormForStoredFilter(availableOptions, dateFilter);
+    }
+    return matchDateFilterToDateFilterOption(dateFilter, availableOptions);
+}
+/**
+ * Tries to match a preset or a form with the provided value. Prioritizes presets over forms.
+ * @param dateFilterValue - value to match against
+ * @param availableOptions - date options available
+ * @alpha
+ */
+export function matchDateFilterToDateFilterOption(dateFilter, availableOptions) {
+    // no value means common All Time, try matching against All time (if it is available) or create virtual preset for it
+    const isAllTime = isAllTimeDateFilter(dateFilter);
+    if (!dateFilter || isAllTime) {
+        const emptyValueHandling = dateFilter?.dateFilter.emptyValueHandling;
+        if (emptyValueHandling === "only") {
+            const { emptyValues: emptyValuesOption } = availableOptions;
+            if (emptyValuesOption?.visible) {
+                return {
+                    dateFilterOption: { ...emptyValuesOption, emptyValueHandling: "only" },
+                    excludeCurrentPeriod: false,
+                };
+            }
+        }
+        const { allTime } = availableOptions;
+        if (allTime) {
+            return {
+                dateFilterOption: applyEmptyValueHandling(allTime, dateFilter),
+                excludeCurrentPeriod: false,
+            };
+        }
+        const virtual = createVirtualPresetForStoredFilter(undefined);
+        return {
+            ...virtual,
+            dateFilterOption: applyEmptyValueHandling(virtual.dateFilterOption, dateFilter),
+        };
+    }
+    // try matching the filter as is
+    const matchingFilter = findDateFilterOptionByValue(dateFilter, availableOptions);
+    if (matchingFilter) {
+        return {
+            dateFilterOption: applyEmptyValueHandling(matchingFilter, dateFilter),
+            excludeCurrentPeriod: false,
+        };
+    }
+    // try matching the filter with excludeCurrentPeriod === true, but only for relativeFormPresets.
+    // Entry is gated on `revertExcludedCurrentPeriodRange` being the EXACT inverse of the filter bar's
+    // forward exclusion — so a genuine exclusion output (to === -1, from < -1) reconstructs its preset,
+    // but a plain "previous period" range (e.g. from === to === -1) is no longer force-matched as
+    // current+exclude the way the earlier `to === -1`-only check did.
+    if (dateFilter.dateFilter.type === "relative") {
+        const storedFrom = Number.parseInt(dateFilter.dateFilter.from?.toString() ?? "", 10);
+        const storedTo = Number.parseInt(dateFilter.dateFilter.to?.toString() ?? "", 10);
+        const unshifted = Number.isNaN(storedFrom) || Number.isNaN(storedTo)
+            ? undefined
+            : revertExcludedCurrentPeriodRange({ from: storedFrom, to: storedTo });
+        if (unshifted) {
+            const filterToMatch = {
+                dateFilter: { ...dateFilter.dateFilter, ...unshifted },
+            };
+            const matchingFilter = findDateFilterOptionByValueAndType(filterToMatch, availableOptions, "relativePreset");
+            if (matchingFilter) {
+                return {
+                    dateFilterOption: applyEmptyValueHandling(matchingFilter, dateFilter),
+                    excludeCurrentPeriod: true,
+                };
+            }
+        }
+    }
+    // the stored filter must be a form with custom values
+    if (canReconstructFormForStoredFilter(availableOptions, dateFilter)) {
+        return reconstructFormForStoredFilter(availableOptions, dateFilter);
+    }
+    // we cannot use the form because it is disabled or otherwise incompatible
+    // -> we must create a virtual hidden preset
+    const virtual = createVirtualPresetForStoredFilter(dateFilter);
+    return { ...virtual, dateFilterOption: applyEmptyValueHandling(virtual.dateFilterOption, dateFilter) };
+}
+/**
+ * Flattens the provided date filter options. The flattening maintains a stable, predefined order in which
+ * the options should be rendered by the date filter component.
+ *
+ * @param dateFilterOptions - available options to flatten
+ * @alpha
+ */
+export function flattenDateFilterOptions(dateFilterOptions) {
+    // relativePreset is optional — guard it, or option sets without it (e.g. a static-only picker)
+    // crash the whole matching path on Object.values(undefined).
+    const relativePresets = compact(Object.values(dateFilterOptions.relativePreset ?? {})).flat();
+    // the order is significant here
+    // the first visible filter is selected for new dashboards if none is specified in config
+    return compact([
+        dateFilterOptions.allTime,
+        dateFilterOptions.emptyValues,
+        ...(dateFilterOptions.absolutePreset || []),
+        ...relativePresets,
+        dateFilterOptions.absoluteForm,
+        dateFilterOptions.relativeForm,
+    ]);
+}
+function canReconstructFormForStoredFilter(options, dateFilter) {
+    switch (dateFilter.dateFilter.type) {
+        case "absolute":
+            return isDateFilterOptionVisible(options.absoluteForm);
+        case "relative":
+            return isDateFilterOptionVisible(options.relativeForm);
+        default:
+            throw new Error("Unknown dateFilterValue type");
+    }
+}
+function reconstructFormForStoredFilter(options, dateFilter) {
+    if (dateFilter.dateFilter.type === "absolute") {
+        const dateFilterOption = {
+            ...options.absoluteForm,
+            from: dateFilter.dateFilter.from.toString(),
+            to: dateFilter.dateFilter.to.toString(),
+            type: "absoluteForm",
+            ...(dateFilter.dateFilter.emptyValueHandling
+                ? { emptyValueHandling: dateFilter.dateFilter.emptyValueHandling }
+                : {}),
+        };
+        return { dateFilterOption, excludeCurrentPeriod: false };
+    }
+    else {
+        const dateFilterOption = {
+            ...options.relativeForm,
+            from: Number.parseInt(dateFilter.dateFilter.from.toString(), 10),
+            to: Number.parseInt(dateFilter.dateFilter.to.toString(), 10),
+            granularity: dateFilter.dateFilter.granularity,
+            type: "relativeForm",
+            ...(dateFilter.dateFilter.emptyValueHandling
+                ? { emptyValueHandling: dateFilter.dateFilter.emptyValueHandling }
+                : {}),
+        };
+        return { dateFilterOption, excludeCurrentPeriod: false };
+    }
+}
+function isDateFilterOptionVisible(option) {
+    return !!option?.visible;
+}
+function findDateFilterOptionById(id, dateFilterOptions) {
+    return flattenDateFilterOptions(dateFilterOptions).find((option) => option.localIdentifier === id);
+}
+/**
+ * Finds the date filter option whose stored value equals the provided filter's value.
+ *
+ * @alpha
+ */
+export function findDateFilterOptionByValue(dateFilter, dateFilterOptions) {
+    return flattenDateFilterOptions(dateFilterOptions).find(filterMatchesData(dateFilter));
+}
+function findDateFilterOptionByValueAndType(dateFilter, dateFilterOptions, type) {
+    return flattenDateFilterOptions(dateFilterOptions)
+        .filter((option) => option.type === type)
+        .find(filterMatchesData(dateFilter));
+}
+const filterMatchesData = (dateFilter) => (filter) => {
+    if (!filter) {
+        return false;
+    }
+    const data = dateFilter.dateFilter;
+    if (isAbsoluteDateFilterOption(filter)) {
+        return data.type === "absolute" && filter.from === data.from && filter.to === data.to;
+    }
+    if (isRelativeDateFilterOption(filter)) {
+        // Check if boundedFilter properties match exactly
+        const boundedFiltersMatch = (() => {
+            // If both don't have boundedFilter, they match
+            if (!filter.boundedFilter && !data.boundedFilter) {
+                return true;
+            }
+            // If only one has boundedFilter, they don't match
+            if (!filter.boundedFilter || !data.boundedFilter) {
+                return false;
+            }
+            // Both have boundedFilter - check granularity first
+            if (filter.boundedFilter.granularity !== data.boundedFilter.granularity) {
+                return false;
+            }
+            // Both must be the same type (both lower or both upper)
+            if (isLowerBound(filter.boundedFilter) && isLowerBound(data.boundedFilter)) {
+                return filter.boundedFilter.from === data.boundedFilter.from;
+            }
+            else if (isUpperBound(filter.boundedFilter) && isUpperBound(data.boundedFilter)) {
+                return filter.boundedFilter.to === data.boundedFilter.to;
+            }
+            // Different bound types don't match
+            return false;
+        })();
+        return (data.type === "relative" &&
+            filter.from?.toString() === data.from?.toString() &&
+            filter.to?.toString() === data.to?.toString() &&
+            filter.granularity === data.granularity &&
+            boundedFiltersMatch);
+    }
+    return false;
+};
+/**
+ * Creates a virtual preset with values corresponding to a provided server-side value.
+ * This is used in situations when a dashboard was saved with setting
+ * that can no longer be reproduced by the available options (e.g. relativeForm was used and later, was disabled)
+ */
+function createVirtualPresetForStoredFilter(dateFilter) {
+    if (!dateFilter) {
+        const dateFilterOption = {
+            ...virtualPresetBase,
+            type: "allTime",
+        };
+        return { dateFilterOption, excludeCurrentPeriod: false };
+    }
+    const { type, from, to, granularity } = dateFilter.dateFilter;
+    if (type === "absolute") {
+        const dateFilterOption = {
+            ...virtualPresetBase,
+            from: from.toString(),
+            to: to.toString(),
+            type: "absolutePreset",
+            ...(dateFilter.dateFilter.emptyValueHandling
+                ? { emptyValueHandling: dateFilter.dateFilter.emptyValueHandling }
+                : {}),
+        };
+        return { dateFilterOption, excludeCurrentPeriod: false };
+    }
+    else {
+        const dateFilterOption = {
+            ...virtualPresetBase,
+            from: Number.parseInt(from.toString(), 10),
+            to: Number.parseInt(to.toString(), 10),
+            granularity,
+            type: "relativePreset",
+            ...(dateFilter.dateFilter.boundedFilter
+                ? { boundedFilter: dateFilter.dateFilter.boundedFilter }
+                : {}),
+            ...(dateFilter.dateFilter.emptyValueHandling
+                ? { emptyValueHandling: dateFilter.dateFilter.emptyValueHandling }
+                : {}),
+        };
+        return { dateFilterOption, excludeCurrentPeriod: false };
+    }
+}

package/esm/DateFilter/utils/DefaultDateFilterConfig.d.ts

@@ -0,0 +1,22 @@
+import { type IDateFilterConfig } from "@gooddata/sdk-model";
+/**
+ * Default date filter preset for standard calendar.
+ *
+ * @alpha
+ */
+export declare const DEFAULT_DATE_FILTER_PRESET = "THIS_MONTH";
+/**
+ * Default date filter preset for fiscal calendar.
+ * Used when fiscal calendar is set as the default calendar type.
+ *
+ * @alpha
+ */
+export declare const DEFAULT_FISCAL_DATE_FILTER_PRESET = "THIS_FISCAL_MONTH";
+/**
+ * The date filter configuration used when a workspace defines no (valid) custom one — the same
+ * catalog the dashboard date filter falls back to.
+ *
+ * @alpha
+ */
+export declare const defaultDateFilterConfig: IDateFilterConfig;
+//# sourceMappingURL=DefaultDateFilterConfig.d.ts.map

package/esm/DateFilter/utils/DefaultDateFilterConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultDateFilterConfig.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/utils/DefaultDateFilterConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,iBAAiB,EAAS,MAAM,qBAAqB,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,eAAe,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,sBAAsB,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,iBAyarC,CAAC"}