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

package/esm/DateFilter/DateFilterButtonLocalized/DateFilterButtonLocalized.d.ts

@@ -1,4 +1,5 @@
 import { type ComponentType, type MutableRefObject } from "react";
+import { type WeekStart } from "@gooddata/sdk-model";
 import { type IFilterButtonCustomIcon } from "../../shared/interfaces/index.js";
 import { type IDateFilterButtonProps } from "../DateFilterButton/DateFilterButton.js";
 import { type DateFilterOption } from "../interfaces/index.js";
@@ -14,6 +15,7 @@ export interface IDateFilterButtonLocalizedProps {
     dropdownId?: string;
     onClick?: () => void;
     ButtonComponent?: ComponentType<IDateFilterButtonProps>;
+    weekStart?: WeekStart;
 }
-export declare function DateFilterButtonLocalized({ dateFilterOption, dateFormat, isOpen, isMobile, customFilterName, disabled, customIcon, buttonRef, dropdownId, onClick, ButtonComponent, }: IDateFilterButtonLocalizedProps): import("react/jsx-runtime").JSX.Element;
+export declare function DateFilterButtonLocalized({ dateFilterOption, dateFormat, isOpen, isMobile, customFilterName, disabled, customIcon, buttonRef, dropdownId, onClick, ButtonComponent, weekStart, }: IDateFilterButtonLocalizedProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=DateFilterButtonLocalized.d.ts.map

package/esm/DateFilter/DateFilterButtonLocalized/DateFilterButtonLocalized.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DateFilterButtonLocalized.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/DateFilterButtonLocalized/DateFilterButtonLocalized.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAMlE,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAKxG,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAU/D,MAAM,WAAW,+BAA+B;IAC5C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,SAAS,CAAC,EAAE,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,eAAe,CAAC,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;CAC3D;AAED,wBAAgB,yBAAyB,CAAC,EACtC,gBAAgB,EAChB,UAAU,EACV,MAAc,EACd,QAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,OAAO,EACP,eAAe,GAClB,EAAE,+BAA+B,2CAsCjC"}
+{"version":3,"file":"DateFilterButtonLocalized.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/DateFilterButtonLocalized/DateFilterButtonLocalized.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAIlE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAKxG,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAU/D,MAAM,WAAW,+BAA+B;IAC5C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,SAAS,CAAC,EAAE,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,eAAe,CAAC,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,SAAS,CAAC;CACzB;AAED,wBAAgB,yBAAyB,CAAC,EACtC,gBAAgB,EAChB,UAAU,EACV,MAAc,EACd,QAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,OAAO,EACP,eAAe,EACf,SAAS,GACZ,EAAE,+BAA+B,2CA4CjC"}

package/esm/DateFilter/DateFilterButtonLocalized/DateFilterButtonLocalized.js

@@ -9,12 +9,17 @@ const ALIGN_POINT = [
     { align: "bl tr", offset: { x: -2, y: -8 } },
 ];
 const TOOLTIP_ALIGN_POINT = [{ align: "bc tc", offset: { x: 0, y: -2 } }];
-export function DateFilterButtonLocalized({ dateFilterOption, dateFormat, isOpen = false, isMobile = true, customFilterName, disabled, customIcon, buttonRef, dropdownId, onClick, ButtonComponent, }) {
+export function DateFilterButtonLocalized({ dateFilterOption, dateFormat, isOpen = false, isMobile = true, customFilterName, disabled, customIcon, buttonRef, dropdownId, onClick, ButtonComponent, weekStart, }) {
     const intl = useIntl();
     const defaultTitle = intl.formatMessage({ id: "dateFilterDropdown.title" });
     const textTitle = customFilterName ?? defaultTitle;
     const title = customFilterName ? (_jsx(ShortenedText, { tooltipAlignPoints: ALIGN_POINT, children: customFilterName })) : (_jsx(_Fragment, { children: textTitle }));
-    const textSubtitle = useDateFilterText({ filter: dateFilterOption, dateFormat, labelMode: "full" });
+    const textSubtitle = useDateFilterText({
+        filter: dateFilterOption,
+        dateFormat,
+        labelMode: "full",
+        weekStart,
+    });
     const Component = ButtonComponent ?? DateFilterButton;
-    return (_jsx(Component, { title: title, isOpen: isOpen, isMobile: isMobile, disabled: disabled, customIcon: customIcon, customFilterName: customFilterName, onClick: onClick, textTitle: textTitle, textSubtitle: textSubtitle, buttonRef: buttonRef, dropdownId: dropdownId, children: _jsx("span", { className: "s-button-text", children: _jsx(DateFilterTextLocalized, { filter: dateFilterOption, dateFormat: dateFormat, labelMode: "full", shortened: true, tooltipAlignPoints: TOOLTIP_ALIGN_POINT }) }) }));
+    return (_jsx(Component, { title: title, isOpen: isOpen, isMobile: isMobile, disabled: disabled, customIcon: customIcon, customFilterName: customFilterName, onClick: onClick, textTitle: textTitle, textSubtitle: textSubtitle, buttonRef: buttonRef, dropdownId: dropdownId, children: _jsx("span", { className: "s-button-text", children: _jsx(DateFilterTextLocalized, { filter: dateFilterOption, dateFormat: dateFormat, labelMode: "full", shortened: true, tooltipAlignPoints: TOOLTIP_ALIGN_POINT, weekStart: weekStart }) }) }));
 }

package/esm/DateFilter/DateFilterCore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DateFilterCore.d.ts","sourceRoot":"","sources":["../../src/DateFilter/DateFilterCore.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"DateFilterCore.d.ts","sourceRoot":"","sources":["../../src/DateFilter/DateFilterCore.tsx"],"names":[],"mappings":"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"}

package/esm/DateFilter/DateFilterCore.js

@@ -90,7 +90,7 @@ export function DateFilterCore({ originalSelectedFilterOption, originalExcludeCu
                             ? lastValidSelectedFilterOption
                             : originalSelectedFilterOption, withoutApply
                             ? (lastValidExcludeCurrentPeriod ?? false)
-                            : originalExcludeCurrentPeriod), dateFormat: adjustDateFormatForDisplay(verifiedDateFormat, isTimeForAbsoluteRangeEnabled, isSecondsForAbsoluteRangeEnabled), customFilterName: customFilterName, customIcon: customIcon, onClick: toggleDropdown, ButtonComponent: ButtonComponent, buttonRef: buttonRef ?? undefined, dropdownId: dropdownId }));
+                            : originalExcludeCurrentPeriod), dateFormat: adjustDateFormatForDisplay(verifiedDateFormat, isTimeForAbsoluteRangeEnabled, isSecondsForAbsoluteRangeEnabled), weekStart: weekStart, customFilterName: customFilterName, customIcon: customIcon, onClick: toggleDropdown, ButtonComponent: ButtonComponent, buttonRef: buttonRef ?? undefined, dropdownId: dropdownId }));
                     return (_jsx(Dropdown, { openOnInit: openOnInit, closeOnParentScroll: true, closeOnMouseDrag: true, closeOnOutsideClick: true, enableEventPropagation: true, autofocusOnOpen: true, initialFocus: initialFocus, alignPoints: [
                             { align: "bl tl" },
                             { align: "tr tl" },

package/esm/DateFilter/DateFilterTextLocalized/DateFilterTextLocalized.d.ts

@@ -1,3 +1,4 @@
+import { type WeekStart } from "@gooddata/sdk-model";
 import { type IAlignPoint } from "@gooddata/sdk-ui-kit";
 import { type DateFilterLabelMode } from "../constants/i18n.js";
 import { type DateFilterOption } from "../interfaces/index.js";
@@ -7,9 +8,10 @@ interface IDateFilterTextLocalizedProps {
     labelMode?: DateFilterLabelMode;
     shortened?: boolean;
     tooltipAlignPoints?: IAlignPoint[];
+    weekStart?: WeekStart;
 }
-export declare function DateFilterTextLocalized({ dateFormat, filter, labelMode, shortened, tooltipAlignPoints, }: IDateFilterTextLocalizedProps): import("react/jsx-runtime").JSX.Element;
-export declare const useDateFilterText: ({ filter, dateFormat, labelMode, }: {
+export declare function DateFilterTextLocalized({ dateFormat, filter, labelMode, shortened, tooltipAlignPoints, weekStart, }: IDateFilterTextLocalizedProps): import("react/jsx-runtime").JSX.Element;
+export declare const useDateFilterText: ({ filter, dateFormat, labelMode, weekStart, }: {
     filter?: DateFilterOption;
     dateFormat: string;
     /**
@@ -18,6 +20,11 @@ export declare const useDateFilterText: ({ filter, dateFormat, labelMode, }: {
      * - "full": Complete labels suitable for standalone display (buttons, selected values)
      */
     labelMode?: DateFilterLabelMode;
+    /**
+     * Which day a week starts on; decides the week number shown for a week-granularity absolute range.
+     * Defaults to "Sunday".
+     */
+    weekStart?: WeekStart;
 }) => string;
 export {};
 //# sourceMappingURL=DateFilterTextLocalized.d.ts.map

package/esm/DateFilter/DateFilterTextLocalized/DateFilterTextLocalized.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DateFilterTextLocalized.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/DateFilterTextLocalized/DateFilterTextLocalized.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,UAAU,6BAA6B;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,WAAW,EAAE,CAAC;CACtC;AAED,wBAAgB,uBAAuB,CAAC,EACpC,UAAU,EACV,MAAM,EACN,SAAmB,EACnB,SAAiB,EACjB,kBAAkB,GACrB,EAAE,6BAA6B,2CAM/B;AAED,eAAO,MAAM,iBAAiB,uCAI3B;IACC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACnC,WAGA,CAAC"}
+{"version":3,"file":"DateFilterTextLocalized.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/DateFilterTextLocalized/DateFilterTextLocalized.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,UAAU,6BAA6B;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,WAAW,EAAE,CAAC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;CACzB;AAED,wBAAgB,uBAAuB,CAAC,EACpC,UAAU,EACV,MAAM,EACN,SAAmB,EACnB,SAAiB,EACjB,kBAAkB,EAClB,SAAS,GACZ,EAAE,6BAA6B,2CAM/B;AAED,eAAO,MAAM,iBAAiB,kDAK3B;IACC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACzB,WAGA,CAAC"}

package/esm/DateFilter/DateFilterTextLocalized/DateFilterTextLocalized.js

@@ -3,14 +3,14 @@ import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import { useIntl } from "react-intl";
 import { ShortenedText } from "@gooddata/sdk-ui-kit";
 import { getDateFilterTitleUsingTranslator } from "../utils/Translations/DateFilterTitle.js";
-export function DateFilterTextLocalized({ dateFormat, filter, labelMode = "short", shortened = false, tooltipAlignPoints, }) {
-    const dateFilterText = useDateFilterText({ filter, dateFormat, labelMode });
+export function DateFilterTextLocalized({ dateFormat, filter, labelMode = "short", shortened = false, tooltipAlignPoints, weekStart, }) {
+    const dateFilterText = useDateFilterText({ filter, dateFormat, labelMode, weekStart });
     if (shortened) {
         return _jsx(ShortenedText, { tooltipAlignPoints: tooltipAlignPoints, children: dateFilterText });
     }
     return _jsx(_Fragment, { children: dateFilterText });
 }
-export const useDateFilterText = ({ filter, dateFormat, labelMode = "short", }) => {
+export const useDateFilterText = ({ filter, dateFormat, labelMode = "short", weekStart, }) => {
     const intl = useIntl();
-    return filter ? getDateFilterTitleUsingTranslator(filter, intl, labelMode, dateFormat) : "";
+    return filter ? getDateFilterTitleUsingTranslator(filter, intl, labelMode, dateFormat, weekStart) : "";
 };

package/esm/DateFilter/PeriodRangePicker/AccessibleFieldInput.d.ts

@@ -3,16 +3,19 @@ interface IAccessibleFieldInputProps extends InputHTMLAttributes<HTMLInputElemen
     "date-range"?: "start" | "end";
 }
 /**
- * A drop-in replacement for the plain `<input>` rc-picker renders for each half of the date range,
- * used only to layer on the accessibility attributes our a11y model needs - a label, an invalid
- * state, and a description pointing at either a format hint or an error message. Typing, masking,
- * and focus behavior all still belong to rc-picker; this component just decorates the props it's handed.
+ * Replaces the plain `<input>` rc-picker renders for each half of the date range, adding the accessibility
+ * attributes our a11y model needs - a label, an invalid state, and a description pointing at a format hint
+ * or an error - plus that field's own leading calendar icon. Typing, masking and focus stay with rc-picker.
  *
  * @remarks
- * rc-picker exposes two facts only this component can observe directly: whether the typed text failed to
- * parse (as this input's own invalid state) and whether the field is currently blank (its own live displayed
- * text, which updates on every keystroke including a clear). Both are reported upward, raw and unresolved, via
- * an effect - the surrounding picker owns everything else needed to turn them into an error kind or message.
+ * The icon is rendered here because rc-picker's own icon props render once for the whole range control,
+ * not once per field. Returning a fragment is safe: rc-picker reaches the input through `ref`.
+ * The icon is inert - `aria-hidden` plus `pointer-events: none` - so it adds no tab stop, and it is
+ * positioned over the input rather than beside it, so a click on it activates this field.
+ *
+ * Two facts are only observable here: whether the typed text failed to parse, and whether the field is
+ * currently blank. Both are reported upward raw, via an effect; the surrounding picker turns them into an
+ * error kind or message.
  */
 export declare const AccessibleFieldInput: import("react").ForwardRefExoticComponent<IAccessibleFieldInputProps & import("react").RefAttributes<HTMLInputElement>>;
 export {};

package/esm/DateFilter/PeriodRangePicker/AccessibleFieldInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccessibleFieldInput.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/PeriodRangePicker/AccessibleFieldInput.tsx"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,mBAAmB,EAM3B,MAAM,OAAO,CAAC;AAMf,UAAU,0BAA2B,SAAQ,mBAAmB,CAAC,gBAAgB,CAAC;IAC9E,YAAY,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,yHAgG/B,CAAC"}
+{"version":3,"file":"AccessibleFieldInput.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/PeriodRangePicker/AccessibleFieldInput.tsx"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,mBAAmB,EAM3B,MAAM,OAAO,CAAC;AAMf,UAAU,0BAA2B,SAAQ,mBAAmB,CAAC,gBAAgB,CAAC;IAC9E,YAAY,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;CAClC;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,yHAmG/B,CAAC"}

package/esm/DateFilter/PeriodRangePicker/AccessibleFieldInput.js

@@ -1,19 +1,22 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // (C) 2026 GoodData Corporation
 import { forwardRef, useCallback, useContext, useEffect, } from "react";
 import { isArrowDownKey, isArrowKey } from "@gooddata/sdk-ui-kit";
 import { PeriodRangeAccessibilityContext } from "./periodRangePickerAccessibility.js";
 /**
- * A drop-in replacement for the plain `<input>` rc-picker renders for each half of the date range,
- * used only to layer on the accessibility attributes our a11y model needs - a label, an invalid
- * state, and a description pointing at either a format hint or an error message. Typing, masking,
- * and focus behavior all still belong to rc-picker; this component just decorates the props it's handed.
+ * Replaces the plain `<input>` rc-picker renders for each half of the date range, adding the accessibility
+ * attributes our a11y model needs - a label, an invalid state, and a description pointing at a format hint
+ * or an error - plus that field's own leading calendar icon. Typing, masking and focus stay with rc-picker.
  *
  * @remarks
- * rc-picker exposes two facts only this component can observe directly: whether the typed text failed to
- * parse (as this input's own invalid state) and whether the field is currently blank (its own live displayed
- * text, which updates on every keystroke including a clear). Both are reported upward, raw and unresolved, via
- * an effect - the surrounding picker owns everything else needed to turn them into an error kind or message.
+ * The icon is rendered here because rc-picker's own icon props render once for the whole range control,
+ * not once per field. Returning a fragment is safe: rc-picker reaches the input through `ref`.
+ * The icon is inert - `aria-hidden` plus `pointer-events: none` - so it adds no tab stop, and it is
+ * positioned over the input rather than beside it, so a click on it activates this field.
+ *
+ * Two facts are only observable here: whether the typed text failed to parse, and whether the field is
+ * currently blank. Both are reported upward raw, via an effect; the surrounding picker turns them into an
+ * error kind or message.
  */
 export const AccessibleFieldInput = forwardRef((props, ref) => {
     const { "date-range": side, "aria-invalid": rcPickerInvalid, onKeyDown, ...restProps } = props;
@@ -86,6 +89,6 @@ export const AccessibleFieldInput = forwardRef((props, ref) => {
             onRequestOpen?.();
         }
     }, [onKeyDown, isCalendarOpen, onRequestOpen, enterCommitRef, onEnterCommit, ignoreEnter]);
-    return (_jsx("input", { ref: ref, ...restProps, "date-range": side, onKeyDown: handleKeyDown, "aria-label": field?.ariaLabel, "aria-invalid": field ? hasParseError || field.errorKind !== undefined : rcPickerInvalid, "aria-describedby": field ? (field.errorKind === undefined ? field.hintId : field.errorId) : undefined }));
+    return (_jsxs(_Fragment, { children: [_jsx("span", { className: "gd-icon-calendar", "aria-hidden": "true" }), _jsx("input", { ref: ref, ...restProps, "date-range": side, onKeyDown: handleKeyDown, "aria-label": field?.ariaLabel, "aria-invalid": field ? hasParseError || field.errorKind !== undefined : rcPickerInvalid, "aria-describedby": field ? (field.errorKind === undefined ? field.hintId : field.errorId) : undefined })] }));
 });
 AccessibleFieldInput.displayName = "AccessibleFieldInput";

package/esm/DateFilter/PeriodRangePicker/PeriodRangePickerImpl.d.ts

@@ -2,9 +2,9 @@ import { type PeriodRangeSide } from "./periodRangePickerAccessibility.js";
 import { type IPeriodRange, type IPeriodRangePickerProps, type PeriodRangePickerGranularity } from "./types.js";
 export declare const DATE_FNS_PICKER_FORMATS: {
     readonly fieldDateFormat: "yyyy-MM-dd";
-    readonly fieldWeekFormat: "Y-ww";
-    readonly fieldMonthFormat: "yyyy-MM";
-    readonly fieldQuarterFormat: "yyyy-QQQ";
+    readonly fieldWeekFormat: "w/YYYY";
+    readonly fieldMonthFormat: "M/yyyy";
+    readonly fieldQuarterFormat: "QQQ/yyyy";
     readonly fieldYearFormat: "yyyy";
     readonly fieldDateTimeFormat: "yyyy-MM-dd HH:mm";
     readonly fieldTimeFormat: "HH:mm";
@@ -15,6 +15,7 @@ export declare const DATE_FNS_PICKER_FORMATS: {
     readonly dayFormat: "d";
     readonly cellMeridiemFormat: "a";
 };
+export declare const PREVIEW_ANNOUNCEMENT_DELAY = 1000;
 /**
  * Resolves the picker's raw selected [start, end] into the exact day-level range this component reports.
  *

package/esm/DateFilter/PeriodRangePicker/PeriodRangePickerImpl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PeriodRangePickerImpl.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/PeriodRangePicker/PeriodRangePickerImpl.tsx"],"names":[],"mappings":"AAgDA,OAAO,EAKH,KAAK,eAAe,EAGvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACH,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACpC,MAAM,YAAY,CAAC;AAgBpB,eAAO,MAAM,uBAAuB;aAChC,eAAe,EAAE,YAAY;aAI7B,eAAe,EAAE,MAAM;aACvB,gBAAgB,EAAE,SAAS;aAC3B,kBAAkB,EAAE,UAAU;aAC9B,eAAe,EAAE,MAAM;aAEvB,mBAAmB,EAAE,kBAAkB;aACvC,eAAe,EAAE,OAAO;aACxB,UAAU,EAAE,MAAM;aAClB,cAAc,EAAE,MAAM;aACtB,iBAAiB,EAAE,KAAK;aACxB,cAAc,EAAE,GAAG;aACnB,SAAS,EAAE,GAAG;aACd,kBAAkB,EAAE,GAAG;CACjB,CAAC;AAkHX;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAChC,WAAW,EAAE,4BAA4B,EACzC,KAAK,EAAE,IAAI,EACX,GAAG,EAAE,IAAI,EACT,SAAS,EAAE,WAAW,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,GAC7D,YAAY,CAOd;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACnC,WAAW,EAAE,4BAA4B,EACzC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,WAAW,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,GAC7D,MAAM,CAER;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,EAClC,WAAW,EACX,KAAK,EACL,aAAa,EACb,QAAQ,EACR,SAAoB,EACpB,YAAoB,EACpB,UAAU,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,GACnB,EAAE,uBAAuB,2CAiXzB"}
+{"version":3,"file":"PeriodRangePickerImpl.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/PeriodRangePicker/PeriodRangePickerImpl.tsx"],"names":[],"mappings":"AAkDA,OAAO,EAKH,KAAK,eAAe,EAGvB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACH,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACpC,MAAM,YAAY,CAAC;AAepB,eAAO,MAAM,uBAAuB;aAChC,eAAe,EAAE,YAAY;aAK7B,eAAe,EAAE,QAAQ;aACzB,gBAAgB,EAAE,QAAQ;aAC1B,kBAAkB,EAAE,UAAU;aAC9B,eAAe,EAAE,MAAM;aAEvB,mBAAmB,EAAE,kBAAkB;aACvC,eAAe,EAAE,OAAO;aACxB,UAAU,EAAE,MAAM;aAClB,cAAc,EAAE,MAAM;aACtB,iBAAiB,EAAE,KAAK;aACxB,cAAc,EAAE,GAAG;aACnB,SAAS,EAAE,GAAG;aACd,kBAAkB,EAAE,GAAG;CACjB,CAAC;AA2CX,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAsG/C;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAChC,WAAW,EAAE,4BAA4B,EACzC,KAAK,EAAE,IAAI,EACX,GAAG,EAAE,IAAI,EACT,SAAS,EAAE,WAAW,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,GAC7D,YAAY,CAOd;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACnC,WAAW,EAAE,4BAA4B,EACzC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,WAAW,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,GAC7D,MAAM,CAER;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,EAClC,WAAW,EACX,KAAK,EACL,aAAa,EACb,QAAQ,EACR,SAAoB,EACpB,YAAoB,EACpB,UAAU,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,GACnB,EAAE,uBAAuB,2CAyazB"}

package/esm/DateFilter/PeriodRangePicker/PeriodRangePickerImpl.js

@@ -27,15 +27,17 @@ import * as rcZhTW from "@rc-component/picker/locale/zh_TW";
 import { format, isValid, parse } from "date-fns";
 import { defaultImport } from "default-import";
 import { defineMessages, useIntl } from "react-intl";
-import { useDebounce } from "@gooddata/sdk-ui";
+import { useDebounce, useDebouncedState } from "@gooddata/sdk-ui";
 import { useIdPrefixed } from "@gooddata/sdk-ui-kit";
-import { platformDateFnsFormat } from "../constants/Platform.js";
+import { DEFAULT_DATE_FORMAT, platformDateFnsFormat } from "../constants/Platform.js";
 import { InputErrorMessage } from "../DateRangePicker/InputErrorMessage.js";
+import { formatAbsoluteDateRange } from "../utils/FormattingUtils.js";
 import { resolvePeriodBoundaries, resolvePeriodBoundary } from "../utils/StaticPeriodConversions.js";
+import { getWeekStartDateFnsLocale, resolveWeekStartLocale } from "../utils/weekStartDateFnsLocale.js";
 import { AccessibleFieldInput } from "./AccessibleFieldInput.js";
 import { DateFnsRangePicker } from "./dateFnsRangePicker.js";
 import { ERROR_MESSAGE_IDS, PeriodRangeAccessibilityContext, isBlockingFieldError, resolveFieldErrorKind, } from "./periodRangePickerAccessibility.js";
-import { getWeekStartDateFnsLocale, resolveWeekStartLocale } from "./weekStartDateFnsLocale.js";
+import { PreviewAnnouncer } from "./PreviewAnnouncer.js";
 // rc-picker is date-library agnostic and keeps its own field/header/cell format defaults in moment
 // notation (see its `fillLocale`, mirrored in the comment on the guard test in
 // tests/PeriodRangePicker.test.tsx). Since some tokens (e.g. "D", "Y") are legal in both moment and
@@ -49,12 +51,13 @@ import { getWeekStartDateFnsLocale, resolveWeekStartLocale } from "./weekStartDa
 // everywhere beats per-locale chrome, at the cost of the year-panel suffix and French zero-padding.
 export const DATE_FNS_PICKER_FORMATS = {
     fieldDateFormat: "yyyy-MM-dd",
-    // Week-numbering year, unpadded, rather than calendar year: date-fns's own `parse` rejects combining
-    // calendar year with a week-of-year token in one format string (they can disagree right at a year
-    // boundary). `useAdditionalWeekYearTokens: true` (dateFnsRangePicker.tsx) is required for this token.
-    fieldWeekFormat: "Y-ww",
-    fieldMonthFormat: "yyyy-MM",
-    fieldQuarterFormat: "yyyy-QQQ",
+    // Week-numbering year, not the calendar "yyyy": date-fns throws when a week-of-year token is
+    // combined with the calendar year, and needs its additional week-year tokens enabled for this one.
+    // The year, not the period, is what stays zero-padded: a half-typed year would otherwise parse and get
+    // re-spelled under the caret.
+    fieldWeekFormat: "w/YYYY",
+    fieldMonthFormat: "M/yyyy",
+    fieldQuarterFormat: "QQQ/yyyy",
     fieldYearFormat: "yyyy",
     // Never rendered (no time picker mode) but pinned anyway for a clean sweep - see the guard test.
     fieldDateTimeFormat: "yyyy-MM-dd HH:mm",
@@ -66,16 +69,42 @@ export const DATE_FNS_PICKER_FORMATS = {
     dayFormat: "d",
     cellMeridiemFormat: "a",
 };
-// The field's actual format token string for granularities where it isn't a user-configurable `dateFormat`
-// (that only applies to "GDC.time.date") - reused both for the hint panel and the "invalid" error message.
-const GRANULARITY_TO_FIELD_FORMAT = {
-    "GDC.time.week_us": DATE_FNS_PICKER_FORMATS.fieldWeekFormat,
+// What each period field accepts when typed, handed to rc-picker as its `format` prop, which takes a
+// list and outranks the locale's own per-granularity format. Only entry [0] is ever displayed - it is
+// how a committed value is spelled and what the field snaps back to; the rest are parse-only
+// alternates, tried in order.
+//
+// The displayed spelling is unpadded, the same way the backend spells these periods, so a field and a chart
+// axis never name the same period differently. The alternates keep the padded spelling from being rejected
+// outright; Quarter's runs the other way, accepting the bare quarter number. Quarter gets no "QQ/yyyy"
+// alternate, so that a month typed into a quarter field errors instead of committing a different range.
+//
+// No alternate may pair a week-of-year token with a calendar year: date-fns throws on that combination
+// and the parse loop has no try/catch, so one such entry would break parsing for that granularity's field.
+const GRANULARITY_TO_FIELD_FORMATS = {
+    "GDC.time.week_us": [DATE_FNS_PICKER_FORMATS.fieldWeekFormat, "ww/YYYY"],
+    "GDC.time.month": [DATE_FNS_PICKER_FORMATS.fieldMonthFormat, "MM/yyyy"],
+    "GDC.time.quarter": [DATE_FNS_PICKER_FORMATS.fieldQuarterFormat, "Q/yyyy"],
+    "GDC.time.year": [DATE_FNS_PICKER_FORMATS.fieldYearFormat],
+};
+// The format shown to the user, in the hint panel and in the "invalid" error message, for granularities
+// that have no user-configurable date format.
+//
+// Week deliberately does not reuse what its field actually parses: the field needs the week-numbering
+// year, but spelling it that way here would read as a typo next to the other granularities, so all
+// hints show the same year format. Do not collapse the two into one source - Week will stop parsing.
+// The difference is invisible except in the week straddling a year boundary, where the two spellings
+// pick different years and the hint names a value the field rejects - a rejection, never a wrong range.
+const GRANULARITY_TO_HINT_FORMAT = {
+    "GDC.time.week_us": "w/yyyy",
     "GDC.time.month": DATE_FNS_PICKER_FORMATS.fieldMonthFormat,
     "GDC.time.quarter": DATE_FNS_PICKER_FORMATS.fieldQuarterFormat,
     "GDC.time.year": DATE_FNS_PICKER_FORMATS.fieldYearFormat,
 };
 // A fixed sample date for the format hint's worked example
 const HINT_EXAMPLE_DATE = new Date(2026, 2, 25);
+// How long typing has to stop before the resolved range is announced.
+export const PREVIEW_ANNOUNCEMENT_DELAY = 1000;
 const messages = defineMessages({
     dateFormatHint: { id: "filters.staticPeriod.dateFormatHint" },
     dateFormatHintWithExample: { id: "filters.staticPeriod.dateFormatHintWithExample" },
@@ -334,20 +363,53 @@ export function PeriodRangePickerImpl({ granularity, range, onRangeChange, isMob
     // When no per-workspace dateFormat is set, fall back to the same format the picker itself uses by
     // default, so the hint text always matches what the picker actually expects. Once time granularity is
     // supported, this fallback will need to switch too.
-    const fieldFormat = granularity === "GDC.time.date"
+    const hintFormat = granularity === "GDC.time.date"
         ? (dateFormat ?? DATE_FNS_PICKER_FORMATS.fieldDateFormat)
-        : GRANULARITY_TO_FIELD_FORMAT[granularity];
+        : GRANULARITY_TO_HINT_FORMAT[granularity];
+    // Day is left to the locale, which already carries the account's own date format.
+    const fieldFormats = granularity === "GDC.time.date" ? undefined : GRANULARITY_TO_FIELD_FORMATS[granularity];
     // Independent of the `locale` useMemo below - also needed to render the format hint's worked example,
     // which is computed for every non-Day granularity while `locale` only resolves this for Day/Week.
     const weekStartLocaleKey = useMemo(() => getWeekStartDateFnsLocale(intl.locale, weekStart), [intl.locale, weekStart]);
-    // A worked example alongside the format token pattern (e.g. "yyyy-MM (e.g. 2026-03)"), so a caller who
+    // A worked example alongside the format token pattern (e.g. "M/yyyy (e.g. 3/2026)"), so a caller who
     // doesn't recognize date-fns tokens can still tell what to type.
     const hintExample = useMemo(() => granularity === "GDC.time.date"
         ? undefined
-        : format(HINT_EXAMPLE_DATE, fieldFormat, {
+        : format(HINT_EXAMPLE_DATE, hintFormat, {
             locale: resolveWeekStartLocale(weekStartLocaleKey),
             useAdditionalWeekYearTokens: true,
-        }), [granularity, fieldFormat, weekStartLocaleKey]);
+        }), [granularity, hintFormat, weekStartLocaleKey]);
+    // Day fields already spell out exact days, so a preview there would just repeat the inputs. Every other
+    // granularity shows a period token that hides which days the filter will actually cover.
+    const showRangePreview = granularity !== "GDC.time.date";
+    // Derived from `liveValue`, not from the committed `range` prop: after the first calendar cell click the
+    // committed range is still the previous one while the field already shows the new period, so a preview
+    // sourced from it would contradict the fields on screen. It carries period anchors, hence the same
+    // per-side boundary expansion the blur commit does.
+    //
+    // Undefined when there is no range to show; the en dash the row falls back to keeps it - and so the
+    // dialog height - stable, and is the character a formatted range joins its ends with.
+    //
+    // `liveValue` only holds the last successfully parsed dates, so a blank or unparsable field leaves stale
+    // ones behind. Without the validity guard the preview would contradict the error shown right above it;
+    // reversed ends are excluded for the same reason, since that range can never be applied.
+    const previewRange = useMemo(() => {
+        const [start, end] = liveValue;
+        if (!isRangeValid || isDateOrderError || !start || !end) {
+            return undefined;
+        }
+        return formatAbsoluteDateRange(resolveSelectedBoundary(granularity, start, "start", weekStart), resolveSelectedBoundary(granularity, end, "end", weekStart), 
+        // Formatted like the filter button's own title, so it falls back to the same format that does.
+        dateFormat ?? DEFAULT_DATE_FORMAT);
+    }, [isRangeValid, isDateOrderError, liveValue, granularity, weekStart, dateFormat]);
+    // Announced from its own region rather than from the preview, which changes on every keystroke and would
+    // be read over the characters still being typed. Debouncing holds the announcement until typing stops.
+    const [, setPreviewAnnouncement, previewAnnouncement] = useDebouncedState(null, PREVIEW_ANNOUNCEMENT_DELAY);
+    useEffect(() => {
+        setPreviewAnnouncement(showRangePreview && previewRange !== undefined
+            ? intl.formatMessage({ id: "filters.staticPeriod.rangePreview" }, { range: previewRange })
+            : null);
+    }, [showRangePreview, previewRange, intl, setPreviewAnnouncement]);
     // Enter applies the whole range immediately in INDIVIDUAL mode, mirroring the classic picker's
     // `onSubmitValue(true)`. It cannot hang off handleChange: rc-picker's onChange is a per-round event,
     // so an Enter in the start field - before the end field has participated in the round - never
@@ -408,10 +470,10 @@ export function PeriodRangePickerImpl({ granularity, range, onRangeChange, isMob
             return undefined;
         }
         if (kind === "invalid" && hintExample !== undefined) {
-            return intl.formatMessage({ id: INVALID_MESSAGE_IDS_WITH_EXAMPLE[side] }, { format: fieldFormat, example: hintExample });
+            return intl.formatMessage({ id: INVALID_MESSAGE_IDS_WITH_EXAMPLE[side] }, { format: hintFormat, example: hintExample });
         }
         const id = ERROR_MESSAGE_IDS[kind][side];
-        return intl.formatMessage({ id }, kind === "invalid" ? { format: fieldFormat } : undefined);
+        return intl.formatMessage({ id }, kind === "invalid" ? { format: hintFormat } : undefined);
     };
     // weekStart and dateFormat are workspace settings independent of display language, so Week/Day override the
     // locale's own defaults for them (see weekStartDateFnsLocale.ts); Month/Quarter/Year need no override.
@@ -443,15 +505,15 @@ export function PeriodRangePickerImpl({ granularity, range, onRangeChange, isMob
     const getPopupContainer = useCallback(() => wrapperRef.current ?? document.body, []);
     return (_jsxs("div", { className: isMobile
             ? "gd-period-range-picker gd-period-range-picker-mobile s-period-range-picker"
-            : "gd-period-range-picker s-period-range-picker", ref: wrapperRef, children: [_jsx(PeriodRangeAccessibilityContext.Provider, { value: accessibility, children: _jsx(DateFnsRangePicker, { picker: pickerMode, value: value, onChange: handleChange, onCalendarChange: handleCalendarChange, onBlur: handleFieldBlur, open: open, onOpenChange: handleOpenChange, onClick: openCalendar, getPopupContainer: getPopupContainer, locale: locale, allowClear: false, order: false, allowEmpty: [true, true], 
+            : "gd-period-range-picker s-period-range-picker", ref: wrapperRef, children: [_jsx(PeriodRangeAccessibilityContext.Provider, { value: accessibility, children: _jsx(DateFnsRangePicker, { picker: pickerMode, value: value, onChange: handleChange, onCalendarChange: handleCalendarChange, onBlur: handleFieldBlur, open: open, onOpenChange: handleOpenChange, onClick: openCalendar, getPopupContainer: getPopupContainer, locale: locale, format: fieldFormats, allowClear: false, order: false, allowEmpty: [true, true], 
                     // Without this the picker overwrites a field's text with the
                     // formatted committed value the moment the field goes inactive - so text that
                     // failed to parse vanishes on blur and its "invalid format" error is replaced by
                     // "empty".
-                    preserveInvalidOnBlur: true, suffixIcon: _jsx("span", { className: "gd-icon-calendar", "aria-hidden": "true" }), components: { input: AccessibleFieldInput } }) }), _jsxs("div", { id: hintId, className: "gd-period-range-picker__hint", children: [hintExample === undefined
-                        ? intl.formatMessage(messages.dateFormatHint, { format: fieldFormat })
+                    preserveInvalidOnBlur: true, components: { input: AccessibleFieldInput } }) }), _jsxs("div", { id: hintId, className: "gd-period-range-picker__hint", children: [hintExample === undefined
+                        ? intl.formatMessage(messages.dateFormatHint, { format: hintFormat })
                         : intl.formatMessage(messages.dateFormatHintWithExample, {
-                            format: fieldFormat,
+                            format: hintFormat,
                             example: hintExample,
-                        }), customRangeHint] }), _jsx(InputErrorMessage, { descriptionId: startErrorId, errorText: getFieldErrorMessage("start") }), _jsx(InputErrorMessage, { descriptionId: endErrorId, errorText: getFieldErrorMessage("end") })] }));
+                        }), customRangeHint] }), _jsx(InputErrorMessage, { descriptionId: startErrorId, errorText: getFieldErrorMessage("start") }), _jsx(InputErrorMessage, { descriptionId: endErrorId, errorText: getFieldErrorMessage("end") }), showRangePreview ? (_jsx("div", { className: "gd-period-range-picker__preview s-period-range-picker-preview", children: intl.formatMessage({ id: "filters.staticPeriod.rangePreview" }, { range: previewRange ?? "\u2013" }) })) : null, _jsx(PreviewAnnouncer, { message: previewAnnouncement })] }));
 }

package/esm/DateFilter/PeriodRangePicker/PreviewAnnouncer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * How long a spent announcement lingers in the region before it is removed.
+ *
+ * @remarks
+ * It only has to be long enough that the removal cannot be mistaken for the replacement of a message that
+ * is still being announced - a screen reader takes its copy of the text when the DOM changes, so removing
+ * the node afterwards does not cut the speech short.
+ */
+export declare const ANNOUNCEMENT_LIFETIME = 3000;
+interface IPreviewAnnouncerProps {
+    /**
+     * The message to announce. A new value is announced once; `null` announces nothing and leaves whatever
+     * is still pending to expire on its own.
+     */
+    message: string | null;
+}
+/**
+ * A visually hidden live region that announces each message once and then empties itself.
+ */
+export declare function PreviewAnnouncer({ message }: IPreviewAnnouncerProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=PreviewAnnouncer.d.ts.map

package/esm/DateFilter/PeriodRangePicker/PreviewAnnouncer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewAnnouncer.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/PeriodRangePicker/PreviewAnnouncer.tsx"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAO1C,UAAU,sBAAsB;IAC5B;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,OAAO,EAAE,EAAE,sBAAsB,2CAmCnE"}

package/esm/DateFilter/PeriodRangePicker/PreviewAnnouncer.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// (C) 2026 GoodData Corporation
+import { useEffect, useRef, useState } from "react";
+/**
+ * How long a spent announcement lingers in the region before it is removed.
+ *
+ * @remarks
+ * It only has to be long enough that the removal cannot be mistaken for the replacement of a message that
+ * is still being announced - a screen reader takes its copy of the text when the DOM changes, so removing
+ * the node afterwards does not cut the speech short.
+ */
+export const ANNOUNCEMENT_LIFETIME = 3000;
+/**
+ * A visually hidden live region that announces each message once and then empties itself.
+ */
+export function PreviewAnnouncer({ message }) {
+    const [announcements, setAnnouncements] = useState([]);
+    const nextIdRef = useRef(0);
+    const timeoutsRef = useRef(new Set());
+    useEffect(() => {
+        if (!message) {
+            return;
+        }
+        const id = nextIdRef.current++;
+        setAnnouncements((current) => [...current, { id, text: message }]);
+        const timeout = window.setTimeout(() => {
+            timeoutsRef.current.delete(timeout);
+            setAnnouncements((current) => current.filter((announcement) => announcement.id !== id));
+        }, ANNOUNCEMENT_LIFETIME);
+        timeoutsRef.current.add(timeout);
+    }, [message]);
+    useEffect(() => {
+        const timeouts = timeoutsRef.current;
+        return () => {
+            timeouts.forEach((timeout) => window.clearTimeout(timeout));
+            timeouts.clear();
+        };
+    }, []);
+    return (_jsx("div", { className: "sr-only", role: "status", "aria-live": "polite", "aria-atomic": "true", children: announcements.map(({ id, text }) => (_jsx("div", { children: text }, id))) }));
+}

package/esm/DateFilter/PeriodRangePicker/dateFnsRangePicker.js

@@ -5,7 +5,7 @@ import * as dateFnsGenerateConfigModule from "@rc-component/picker/generate/date
 import { format as formatDate, getWeek, isValid, parse as parseDate, startOfWeek, } from "date-fns";
 import * as dateFnsLocales from "date-fns/locale";
 import { defaultImport } from "default-import";
-import { resolveWeekStartLocale } from "./weekStartDateFnsLocale.js";
+import { resolveWeekStartLocale } from "../utils/weekStartDateFnsLocale.js";
 const baseGenerateConfig = defaultImport(dateFnsGenerateConfigModule);
 // Mirrors the same (unexported) locale-key guessing logic the upstream generate config uses internally,
 // so rc-picker's own locale bundles - keyed like "en_US" - keep resolving to a date-fns locale exactly as

package/esm/DateFilter/PeriodRangePicker/types.d.ts

@@ -25,7 +25,10 @@ export interface IPeriodRangePickerProps {
     weekStart?: WeekStart;
     withoutApply?: boolean;
     submitForm: () => void;
-    /** Date format (date-fns tokens) for the "GDC.time.date" granularity; other granularities ignore it. */
+    /**
+     * Date format (date-fns tokens). Formats the input fields for the "GDC.time.date" granularity, and the
+     * day-level range preview for all the others.
+     */
     dateFormat?: string;
     /** Extra content rendered after the built-in format hint. */
     customRangeHint?: ReactNode;

package/esm/DateFilter/PeriodRangePicker/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/PeriodRangePicker/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAElG;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAC9C,qBAAqB,EACrB,eAAe,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,eAAe,CACjG,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,EAAE,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,WAAW,EAAE,4BAA4B,CAAC;IAC1C,KAAK,EAAE,YAAY,CAAC;IACpB,aAAa,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,uIAAuI;IACvI,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,wGAAwG;IACxG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/PeriodRangePicker/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAElG;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAC9C,qBAAqB,EACrB,eAAe,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,eAAe,CACjG,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,EAAE,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,WAAW,EAAE,4BAA4B,CAAC;IAC1C,KAAK,EAAE,YAAY,CAAC;IACpB,aAAa,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,QAAQ,EAAE,OAAO,CAAC;IAClB,uIAAuI;IACvI,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD"}

package/esm/DateFilter/index.d.ts

@@ -1,7 +1,8 @@
 import { mapOptionToAfm } from "./utils/AFMConversions.js";
+import { formatAbsoluteDateRange } from "./utils/FormattingUtils.js";
 import { filterVisibleDateFilterOptions } from "./utils/OptionUtils.js";
 import { applyExcludeCurrentPeriod, canExcludeCurrentPeriod } from "./utils/PeriodExclusion.js";
-import { formatAbsoluteDateRange, formatRelativeDateRange, getDateFilterRepresentation, getDateFilterTitleUsingTranslator } from "./utils/Translations/DateFilterTitle.js";
+import { formatRelativeDateRange, getDateFilterRepresentation, getDateFilterTitleUsingTranslator } from "./utils/Translations/DateFilterTitle.js";
 import { validateFilterOption } from "./validation/OptionValidation.js";
 /**
  * @beta

package/esm/DateFilter/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/DateFilter/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,EACH,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,iCAAiC,EACpC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;CAY7B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/DateFilter/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,EACH,uBAAuB,EACvB,2BAA2B,EAC3B,iCAAiC,EACpC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;CAY7B,CAAC"}

package/esm/DateFilter/index.js

@@ -2,9 +2,10 @@
 import { defaultDateFilterOptions } from "./constants/config.js";
 import { granularityIntlCodes } from "./constants/i18n.js";
 import { mapOptionToAfm } from "./utils/AFMConversions.js";
+import { formatAbsoluteDateRange } from "./utils/FormattingUtils.js";
 import { filterVisibleDateFilterOptions } from "./utils/OptionUtils.js";
 import { applyExcludeCurrentPeriod, canExcludeCurrentPeriod } from "./utils/PeriodExclusion.js";
-import { formatAbsoluteDateRange, formatRelativeDateRange, getDateFilterRepresentation, getDateFilterTitleUsingTranslator, } from "./utils/Translations/DateFilterTitle.js";
+import { formatRelativeDateRange, getDateFilterRepresentation, getDateFilterTitleUsingTranslator, } from "./utils/Translations/DateFilterTitle.js";
 import { validateFilterOption } from "./validation/OptionValidation.js";
 /**
  * @beta

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

@@ -15,4 +15,8 @@ export declare const localizedIcuDateFormatPatterns: Record<string, string>;
  * @internal
  */
 export declare const getLocalizedIcuDateFormatPattern: (locale: string) => string;
+/**
+ * @beta
+ */
+export declare const formatAbsoluteDateRange: (from: Date | string, to: Date | string, dateFormat: string, splitter?: string) => string;
 //# sourceMappingURL=FormattingUtils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FormattingUtils.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/utils/FormattingUtils.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,sBAAsB,WAAY,MAAM,KAAG,GAIvD,CAAC;AAEF,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2BjE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,WAAY,MAAM,WAC6B,CAAC"}
+{"version":3,"file":"FormattingUtils.d.ts","sourceRoot":"","sources":["../../../src/DateFilter/utils/FormattingUtils.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,sBAAsB,WAAY,MAAM,KAAG,GAIvD,CAAC;AAEF,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2BjE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,WAAY,MAAM,WAC6B,CAAC;AAkC7F;;GAEG;AACH,eAAO,MAAM,uBAAuB,SAC1B,IAAI,GAAG,MAAM,MACf,IAAI,GAAG,MAAM,cACL,MAAM,wBAEnB,MAgCF,CAAC"}