@gooddata/sdk-ui-filters 11.15.0-alpha.0 → 11.15.0-alpha.2

package/esm/sdk-ui-filters.d.ts

@@ -489,6 +489,12 @@ export declare function AttributeFilterSimpleDropdownButtonWithSelection({ isOpe
  */
 export declare function AttributeFilterStatusBar({ attributeTitle, isFilteredByParentFilters, parentFilterTitles, totalElementsCountWithCurrentSettings, getItemTitle, isInverted, selectedItems, selectedItemsLimit, enableShowingFilteredElements, onShowFilteredElements, irrelevantSelection, onClearIrrelevantSelection, isFilteredByLimitingValidationItems, isFilteredByDependentDateFilters, withoutApply, }: IAttributeFilterStatusBarProps): JSX.Element;
 
+/**
+ * Type representing the calendar tab selection.
+ * @alpha
+ */
+export declare type CalendarTabType = "standard" | "fiscal";
+
 /**
  * @public
  */
@@ -540,13 +546,16 @@ export declare class DateFilter extends PureComponent<IDateFilterProps, IDateFil
  */
 export declare const DateFilterHelpers: {
     validateFilterOption: (filterOption: DateFilterOption) => IExtendedDateFilterErrors;
-    getDateFilterTitleUsingTranslator: (filter: DateFilterOption, translator: IDateAndMessageTranslator, dateFormat?: string) => string;
-    getDateFilterRepresentation: (filter: DateFilterOption, locale: ILocale, messages: ITranslations, dateFormat?: string) => string;
+    getDateFilterTitleUsingTranslator: (filter: DateFilterOption, translator: IDateAndMessageTranslator, dateFormat?: string, labelMode?: DateFilterLabelMode) => string;
+    getDateFilterRepresentation: (filter: DateFilterOption, locale: ILocale, messages: ITranslations, dateFormat?: string, labelMode?: DateFilterLabelMode) => string;
     granularityIntlCodes: {
         "GDC.time.year": GranularityIntlKey;
+        "GDC.time.fiscal_year": GranularityIntlKey;
         "GDC.time.week_us": GranularityIntlKey;
         "GDC.time.quarter": GranularityIntlKey;
+        "GDC.time.fiscal_quarter": GranularityIntlKey;
         "GDC.time.month": GranularityIntlKey;
+        "GDC.time.fiscal_month": GranularityIntlKey;
         "GDC.time.date": GranularityIntlKey;
         "GDC.time.hour": GranularityIntlKey;
         "GDC.time.minute": GranularityIntlKey;
@@ -556,10 +565,18 @@ export declare const DateFilterHelpers: {
     canExcludeCurrentPeriod: (dateFilterOption: DateFilterOption) => boolean;
     mapOptionToAfm: (value: DateFilterOption, dateDataSet: ObjRef, excludeCurrentPeriod: boolean) => IDateFilter | null;
     formatAbsoluteDateRange: (from: Date | string, to: Date | string, dateFormat: string, splitter?: string) => string;
-    formatRelativeDateRange: (from: number, to: number, granularity: DateFilterGranularity, translator: IDateAndMessageTranslator, boundedFilter?: IUpperBoundedFilter | ILowerBoundedFilter) => string;
+    formatRelativeDateRange: (from: number, to: number, granularity: DateFilterGranularity, translator: IDateAndMessageTranslator, boundedFilter?: IUpperBoundedFilter | ILowerBoundedFilter, labelMode?: DateFilterLabelMode) => string;
     filterVisibleDateFilterOptions: typeof filterVisibleDateFilterOptions;
 };
 
+/**
+ * Label mode for date filter display.
+ * - "short": Abbreviated labels suitable for list context (group heading provides granularity info)
+ * - "full": Complete labels suitable for standalone display (button, selected value)
+ * @beta
+ */
+export declare type DateFilterLabelMode = "short" | "full";
+
 /**
  * Represents any option in the date filter dropdown
  * @public
@@ -598,6 +615,51 @@ export declare type DimensionalityItemType = "attribute" | "chronologicalDate" |
  */
 export declare function EmptyElementsSearchBar(_props: IAttributeFilterElementsSearchBarProps): JSX.Element;
 
+/**
+ * Ensures the granularity in a relative filter option is compatible with the available granularities.
+ * If the current granularity is not available, maps it to an equivalent or picks the first available.
+ * @param filterOption - The filter option to check/correct
+ * @param availableGranularities - List of available granularities
+ * @param fiscalFirst - Whether to prefer fiscal granularities when mapping
+ * @returns The filter option with a compatible granularity
+ * @internal
+ */
+export declare function ensureCompatibleGranularity<T extends IUiRelativeDateFilterFormLike>(filterOption: T, availableGranularities: DateFilterGranularity[], fiscalFirst: boolean): T;
+
+/**
+ * Filter granularities for the fiscal tab view.
+ * Includes fiscal granularities and shared granularities (week, day, hour, minute).
+ * @param granularities - Available granularities to filter
+ * @returns Granularities suitable for fiscal tab
+ * @internal
+ */
+export declare function filterFiscalGranularities(granularities: DateFilterGranularity[]): DateFilterGranularity[];
+
+/**
+ * Filter presets for the Fiscal tab.
+ * @param presets - The relative presets option group to filter
+ * @returns Filtered presets containing fiscal granularities and shared granularities (week, day, hour, minute)
+ * @alpha
+ */
+export declare function filterFiscalPresets(presets: DateFilterRelativeOptionGroup): DateFilterRelativeOptionGroup;
+
+/**
+ * Filter granularities for the standard tab view.
+ * Excludes all fiscal granularities.
+ * @param granularities - Available granularities to filter
+ * @returns Granularities suitable for standard tab
+ * @internal
+ */
+export declare function filterStandardGranularities(granularities: DateFilterGranularity[]): DateFilterGranularity[];
+
+/**
+ * Filter presets for the Standard tab.
+ * @param presets - The relative presets option group to filter
+ * @returns Filtered presets containing only standard granularities
+ * @alpha
+ */
+export declare function filterStandardPresets(presets: DateFilterRelativeOptionGroup): DateFilterRelativeOptionGroup;
+
 /**
  * Returns dateFilterOptions with only items that have visible set to true.
  *
@@ -611,6 +673,14 @@ export declare function filterVisibleDateFilterOptions(dateFilterOptions: IDateF
  */
 export declare function getAttributeFilterSubtitle(isCommittedSelectionInverted: boolean, committedSelectionElements: IAttributeElement[], intl: IntlShape): string;
 
+/**
+ * Get fiscal tabs configuration based on available presets.
+ * @param presets - The relative presets option group to check, or undefined
+ * @returns Configuration object with hasFiscal, hasStandard, and showTabs flags
+ * @alpha
+ */
+export declare function getFiscalTabsConfig(presets: DateFilterRelativeOptionGroup | undefined): IFiscalTabsConfig;
+
 /**
  * Returns localized date format pattern for DAY granularity according to ICU. Unsupported locales default to en-US.
  *
@@ -621,10 +691,35 @@ export declare function getAttributeFilterSubtitle(isCommittedSelectionInverted:
 export declare const getLocalizedIcuDateFormatPattern: (locale: string) => string;
 
 /**
+ * Determine which tab should be selected based on the selected preset's granularity.
+ * @param preset - The currently selected date filter option
+ * @returns "fiscal" if the preset uses a fiscal granularity, otherwise "standard"
+ * @alpha
+ */
+export declare function getTabForPreset(preset: DateFilterOption): CalendarTabType;
+
+/**
+ * Short-form intl keys for granularities.
  * @beta
  */
 export declare type GranularityIntlKey = "day" | "minute" | "hour" | "week" | "month" | "quarter" | "year";
 
+/**
+ * Check if the presets contain any fiscal granularities.
+ * @param presets - The relative presets option group to check
+ * @returns true if any fiscal granularities are present
+ * @alpha
+ */
+export declare function hasFiscalPresets(presets: DateFilterRelativeOptionGroup): boolean;
+
+/**
+ * Check if the presets contain any standard granularities.
+ * @param presets - The relative presets option group to check
+ * @returns true if any standard granularities are present
+ * @alpha
+ */
+export declare function hasStandardPresets(presets: DateFilterRelativeOptionGroup): boolean;
+
 /**
  * @internal
  */
@@ -2699,6 +2794,29 @@ export declare interface IDimensionalityItem {
      * Defaults to "attribute" if not specified.
      */
     type: DimensionalityItemType;
+    /**
+     * Optional object reference for the item (typically the attribute/date display form reference).
+     *
+     * This is useful when the item `identifier` is a LocalIdRef (bucket item),
+     * but we still want to compare/deduplicate it against catalog candidates that are referenced by ObjRef.
+     *
+     * @beta
+     */
+    ref?: ObjRef;
+    /**
+     * Optional dataset information for grouping catalog items.
+     * Present for catalog items, undefined for bucket items.
+     */
+    dataset?: {
+        /**
+         * Dataset identifier.
+         */
+        identifier: ObjRef;
+        /**
+         * Human-readable dataset title.
+         */
+        title: string;
+    };
 }
 
 /**
@@ -2759,6 +2877,16 @@ export declare interface IFilterConfigurationProps {
     onCancelButtonClick: () => void;
 }
 
+/**
+ * Configuration for fiscal calendar tabs.
+ * @alpha
+ */
+export declare interface IFiscalTabsConfig {
+    hasFiscal: boolean;
+    hasStandard: boolean;
+    showTabs: boolean;
+}
+
 /**
  * Handles the selection that can be inverted.
  *
@@ -2866,6 +2994,20 @@ export declare interface IMeasureValueFilterCommonProps {
     dimensionality?: IDimensionalityItem[];
     insightDimensionality?: IDimensionalityItem[];
     isDimensionalityEnabled?: boolean;
+    /**
+     * Catalog items available for dimensionality
+     */
+    catalogDimensionality?: IDimensionalityItem[];
+    /**
+     * Callback triggered when dimensionality changes.
+     * Used to revalidate catalog items after selection changes.
+     */
+    onDimensionalityChange?: (dimensionality: ObjRefInScope[]) => void;
+    /**
+     * Whether catalog dimensionality is currently being loaded.
+     * If true, the attribute picker can show a small loading indicator.
+     */
+    isLoadingCatalogDimensionality?: boolean;
 }
 
 /**
@@ -3017,6 +3159,14 @@ export declare interface IRankingFilterProps {
  */
 export declare const isAbsoluteDateFilterOption: (obj: unknown) => obj is AbsoluteDateFilterOption;
 
+/**
+ * Check if a granularity is a fiscal granularity.
+ * @param granularity - The granularity to check
+ * @returns true if the granularity is fiscal (fiscal_year, fiscal_quarter, or fiscal_month)
+ * @alpha
+ */
+export declare function isFiscalGranularity(granularity: DateFilterGranularity): boolean;
+
 /**
  * Core API for attribute filter components, that allows you to implement custom attribute filter components.
  *
@@ -3217,6 +3367,15 @@ export declare interface IUiRelativeDateFilterForm extends Omit<IRelativeDateFil
     boundedFilter?: IUpperBoundedFilter | ILowerBoundedFilter;
 }
 
+/**
+ * @internal
+ */
+export declare interface IUiRelativeDateFilterFormLike {
+    granularity?: DateFilterGranularity;
+    from?: number;
+    to?: number;
+}
+
 /**
  * Properties of {@link useAttributeFilterController}
  * @public

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-ui-filters",
-  "version": "11.15.0-alpha.0",
+  "version": "11.15.0-alpha.2",
   "description": "GoodData.UI SDK - Filter Components",
   "repository": {
     "type": "git",
@@ -47,11 +47,11 @@
     "ts-invariant": "^0.7.5",
     "tslib": "2.8.1",
     "uuid": "^11.1.0",
-    "@gooddata/sdk-backend-spi": "11.15.0-alpha.0",
-    "@gooddata/sdk-ui": "11.15.0-alpha.0",
-    "@gooddata/sdk-ui-kit": "11.15.0-alpha.0",
-    "@gooddata/util": "11.15.0-alpha.0",
-    "@gooddata/sdk-model": "11.15.0-alpha.0"
+    "@gooddata/sdk-backend-spi": "11.15.0-alpha.2",
+    "@gooddata/sdk-model": "11.15.0-alpha.2",
+    "@gooddata/sdk-ui": "11.15.0-alpha.2",
+    "@gooddata/sdk-ui-kit": "11.15.0-alpha.2",
+    "@gooddata/util": "11.15.0-alpha.2"
   },
   "devDependencies": {
     "@gooddata/stylelint-config": "^5.0.0",
@@ -94,10 +94,10 @@
     "typescript": "5.8.3",
     "vitest": "3.2.4",
     "vitest-dom": "0.1.1",
-    "@gooddata/eslint-config": "11.15.0-alpha.0",
-    "@gooddata/reference-workspace": "11.15.0-alpha.0",
-    "@gooddata/sdk-backend-mockingbird": "11.15.0-alpha.0",
-    "@gooddata/sdk-ui-theme-provider": "11.15.0-alpha.0"
+    "@gooddata/eslint-config": "11.15.0-alpha.2",
+    "@gooddata/reference-workspace": "11.15.0-alpha.2",
+    "@gooddata/sdk-backend-mockingbird": "11.15.0-alpha.2",
+    "@gooddata/sdk-ui-theme-provider": "11.15.0-alpha.2"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/styles/css/main.css

@@ -8074,6 +8074,16 @@ div.gd-empty-item-bubble {
   width: 100%;
 }
 
+.gd-mvf-operator-dropdown {
+  display: flex;
+  flex-direction: column;
+}
+
+.gd-mvf-operator-dropdown-label {
+  font-size: 12px;
+  color: var(--gd-palette-complementary-7, #6d7680);
+}
+
 .gd-mvf-operator-dropdown-body {
   width: 230px;
   padding: 5px 0;
@@ -8106,6 +8116,12 @@ div.gd-empty-item-bubble {
   display: none;
 }
 
+.s-mvf-comparison-value-input .gd-input-field,
+.s-mvf-range-from-input .gd-input-field,
+.s-mvf-range-to-input .gd-input-field {
+  text-align: right;
+}
+
 .gd-mvf-dimensionality-header {
   display: flex;
   justify-content: space-between;
@@ -8113,6 +8129,8 @@ div.gd-empty-item-bubble {
 }
 .gd-mvf-dimensionality-header label {
   font-size: 12px;
+  line-height: 20px;
+  color: var(--gd-palette-complementary-7, #6d7680);
 }
 
 .gd-mvf-dimensionality-items {
@@ -8120,6 +8138,14 @@ div.gd-empty-item-bubble {
   flex-wrap: wrap;
   align-items: center;
   gap: 5px;
+  max-height: 350px;
+  overflow-y: auto;
+}
+
+.gd-mvf-dimensionality-tag-wrapper {
+  max-width: 180px;
+  min-width: 0;
+  display: flex;
 }
 
 .gd-mvf-dimensionality-add-wrapper {
@@ -8134,6 +8160,15 @@ div.gd-empty-item-bubble {
   height: inherit;
   font-size: 12px;
 }
+.gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-item .gd-ui-kit-icon {
+  flex-shrink: 0;
+}
+.gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-item .gd-ui-kit-listbox__item-title {
+  flex: 1 1 auto;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
 .gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-header {
   display: flex;
   align-items: center;
@@ -8152,6 +8187,10 @@ div.gd-empty-item-bubble {
   font-size: 11px;
   font-weight: bold;
 }
+.gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-loading-spinner {
+  display: inline-flex;
+  align-items: center;
+}
 .gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-search-bar {
   display: flex;
   flex-shrink: 0;
@@ -8168,23 +8207,67 @@ div.gd-empty-item-bubble {
 .gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-content {
   flex: 1 1 auto;
 }
+.gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-loading-row {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 10px;
+}
 .gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-list-header {
   text-transform: uppercase;
   color: var(--gd-palette-complementary-6, #94a1ad);
   font-size: 10px;
+  padding: 10px 10px 0;
+  line-height: 16px;
+}
+.gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-divider {
+  height: 10px;
   padding: 0 10px;
 }
+.gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-divider::before {
+  content: "";
+  display: block;
+  position: relative;
+  top: 50%;
+  border-top: 1px solid var(--gd-palette-complementary-3, #dde4eb);
+}
 .gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-no-results {
   padding: 10px;
   color: var(--gd-palette-complementary-6, #94a1ad);
   text-align: center;
 }
-.gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-footer {
-  flex: 0 0 auto;
-  margin: 0 10px;
-  padding: 10px 0;
-  border-top: 1px solid var(--gd-palette-complementary-3, #dde4eb);
-  text-align: right;
+.gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-date-dataset {
+  padding: 5px 10px 10px;
+}
+.gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-date-dataset-label {
+  color: var(--gd-palette-complementary-6, #94a1ad);
+  font-size: 12px;
+  line-height: 20px;
+  margin-bottom: 5px;
+}
+.gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-date-dataset-control {
+  position: relative;
+}
+.gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-date-dataset-control .gd-ui-kit-button {
+  width: 100%;
+  justify-content: space-between;
+}
+.gd-mvf-attribute-picker-body .gd-mvf-attribute-picker-date-dataset-dropdown {
+  position: absolute;
+  left: 0;
+  right: 0;
+  top: calc(100% + 4px);
+  background: var(--gd-palette-complementary-0, #fff);
+  border: 1px solid var(--gd-palette-complementary-3, #dde4eb);
+  border-radius: 3px;
+  box-shadow: 0 2px 10px rgba(0, 0, 0, 0.1);
+  z-index: 2;
+  overflow: hidden;
+}
+.gd-mvf-attribute-picker-body .gd-ui-kit-listbox {
+  padding: 0;
+  min-width: 0;
+  max-height: 200px;
 }
 
 .gd-mvf-preview {
@@ -8196,6 +8279,13 @@ div.gd-empty-item-bubble {
   padding-top: 10px;
 }
 
+.gd-mvf-backward-compatibility-message {
+  margin-top: 10px;
+}
+.gd-mvf-backward-compatibility-message .gd-message-text {
+  font-size: 12px;
+}
+
 .gd-numeric-input {
   display: flex;
 }