@gooddata/sdk-ui-kit 11.51.0-alpha.0 → 11.51.0-alpha.2

package/esm/@ui/hooks/useCloseOnEscape.d.ts

@@ -1,7 +1,10 @@
 /**
  * Hook to trigger a callback when pressing the Escape key.
  *
+ * @param capture - When true, listens in the capture phase and stops propagation, so a nested
+ * overlay can dismiss on Escape without an ancestor (e.g. a Dropdown) also closing.
+ *
  * @internal
  */
-export declare function useCloseOnEscape(isOpen: boolean, onClose: () => void): void;
+export declare function useCloseOnEscape(isOpen: boolean, onClose: () => void, capture?: boolean): void;
 //# sourceMappingURL=useCloseOnEscape.d.ts.map

package/esm/@ui/hooks/useCloseOnEscape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCloseOnEscape.d.ts","sourceRoot":"","sources":["../../../src/@ui/hooks/useCloseOnEscape.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAe3E"}
+{"version":3,"file":"useCloseOnEscape.d.ts","sourceRoot":"","sources":["../../../src/@ui/hooks/useCloseOnEscape.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,EAAE,OAAO,UAAQ,GAAG,IAAI,CAkB5F"}

package/esm/@ui/hooks/useCloseOnEscape.js

@@ -1,21 +1,27 @@
-// (C) 2025 GoodData Corporation
+// (C) 2025-2026 GoodData Corporation
 import { useEffect } from "react";
 /**
  * Hook to trigger a callback when pressing the Escape key.
  *
+ * @param capture - When true, listens in the capture phase and stops propagation, so a nested
+ * overlay can dismiss on Escape without an ancestor (e.g. a Dropdown) also closing.
+ *
  * @internal
  */
-export function useCloseOnEscape(isOpen, onClose) {
+export function useCloseOnEscape(isOpen, onClose, capture = false) {
     useEffect(() => {
         if (!isOpen) {
             return undefined;
         }
         const handleKeyDown = (event) => {
             if (event.key === "Escape") {
+                if (capture) {
+                    event.stopPropagation();
+                }
                 onClose();
             }
         };
-        document.addEventListener("keydown", handleKeyDown);
-        return () => document.removeEventListener("keydown", handleKeyDown);
-    }, [isOpen, onClose]);
+        document.addEventListener("keydown", handleKeyDown, { capture });
+        return () => document.removeEventListener("keydown", handleKeyDown, { capture });
+    }, [isOpen, onClose, capture]);
 }

package/esm/List/InvertableSelect/InvertableSelectVirtualised.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InvertableSelectVirtualised.d.ts","sourceRoot":"","sources":["../../../src/List/InvertableSelect/InvertableSelectVirtualised.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"InvertableSelectVirtualised.d.ts","sourceRoot":"","sources":["../../../src/List/InvertableSelect/InvertableSelectVirtualised.tsx"],"names":[],"mappings":"AAEA,OAAO,EAGH,KAAK,YAAY,EACjB,KAAK,SAAS,EAKjB,MAAM,OAAO,CAAC;AAuBf,OAAO,EACH,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,kCAAkC,EACvC,KAAK,qCAAqC,EAC1C,KAAK,qCAAqC,EAC7C,MAAM,uBAAuB,CAAC;AAe/B;;;;GAIG;AACH,MAAM,WAAW,2CAA2C,CAAC,CAAC;IAC1D;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;IAEvB;;OAEG;IACH,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAEjC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,8CAA8C;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAClC,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAEhC,yBAAyB,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IAEjD,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,CAAC,EAAE,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC,KAAK,CAAC,EAAE,GAAG,CAAC;IAEZ,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAE5B,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAEhC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,iCAAiC,KAAK,YAAY,CAAC;IACzE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,mCAAmC,KAAK,YAAY,CAAC;IAC7E,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,qCAAqC,KAAK,YAAY,CAAC;IACjF,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,kCAAkC,KAAK,YAAY,CAAC;IAC3E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,2CAA2C,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC;IACrF,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,qCAAqC,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC;IACpF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,8CAA8C,KAAK,YAAY,CAAC;CAC3F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,KAAK,EAAE,iCAAiC,CAAC,CAAC,CAAC,2CA2YzF"}

package/esm/List/InvertableSelect/InvertableSelectVirtualised.js

@@ -133,7 +133,9 @@ export function InvertableSelectVirtualised(props) {
             item,
             title: getItemTitle(item),
             isSelected: getIsItemSelected(item),
-            focusedAction: item === focusedItem ? focusedAction : undefined,
+            // `focusedAction` persists across blur (so Tab-back-in resumes sensibly), so gate
+            // it on `isFocusWithin` here to avoid reporting a stale focus to consumers.
+            focusedAction: isFocusWithin && item === focusedItem ? focusedAction : undefined,
             listRef: containerRef,
             index: items.indexOf(item) + 1,
             itemsCount: items.length,
@@ -144,6 +146,7 @@ export function InvertableSelectVirtualised(props) {
         getIsItemSelected,
         focusedItem,
         focusedAction,
+        isFocusWithin,
         containerRef,
         items,
         selectItems,

package/esm/ParameterControl/StringParameterControlDropdown.js

@@ -22,10 +22,10 @@ export function StringParameterControlDropdown({ name, value, resetValue, constr
     return (_jsx(ParameterControlDropdown, { name: name, draft: draft, onDraftChange: setDraft, inputType: "text", inputId: inputId, ariaAttributes: ariaAttributes, errorMessage: error ? (_jsx(FormattedMessage, { ...error, values: { minLength: constraints?.minLength, maxLength: constraints?.maxLength } })) : undefined, onReset: showReset ? () => setDraft(resetValue) : undefined, onApply: () => onApply(draft), onCancel: onCancel }));
 }
 function getStringDraftValidationError(draft, constraints) {
-    if (isValidStringParameterValue(draft, constraints)) {
+    const { minLength, maxLength } = constraints ?? {};
+    if (isValidStringParameterValue(draft, { minLength, maxLength })) {
         return undefined;
     }
-    const { minLength } = constraints ?? {};
     return minLength !== undefined && draft.length < minLength
         ? messages.errorTooShort
         : messages.errorTooLong;

package/esm/Timezone/TimezoneSelect.d.ts

@@ -0,0 +1,108 @@
+import { type ReactElement, type ReactNode } from "react";
+import { type IUiListboxItem } from "../@ui/UiListbox/types.js";
+import { type IDropdownButtonRenderProps } from "../Dropdown/Dropdown.js";
+/**
+ * Special item rendered above the divider in {@link TimezoneSelect}, ahead of the curated
+ * timezone list. Callers use these for entries like "Default (workspace)" or "From browser (...)".
+ *
+ * @internal
+ */
+export interface ITimezoneSelectSpecialItem {
+    /**
+     * Value emitted by onChange when this item is selected. Undefined typically represents
+     * "no explicit timezone" (e.g. inherit the workspace setting).
+     */
+    id: string | undefined;
+    /**
+     * Display label of the item.
+     */
+    label: string;
+}
+/**
+ * Render props passed to a custom trigger renderer of {@link TimezoneSelect}.
+ *
+ * Extends the {@link IDropdownButtonRenderProps} contract of the underlying dropdown
+ * (toggle/open/close callbacks, isOpen, buttonRef and accessibility props) with the
+ * current selection so that custom triggers can display it.
+ *
+ * @internal
+ */
+export interface ITimezoneSelectButtonRenderProps extends IDropdownButtonRenderProps {
+    /**
+     * Human-readable label of the current selection: the matching special item label,
+     * the selected timezone as "name (offset)" (e.g. "Prague (GMT+01:00)"),
+     * or the placeholder when nothing is selected.
+     */
+    buttonLabel: string;
+    /**
+     * Currently selected timezone ID (IANA ID, a special item ID or undefined).
+     */
+    value: string | undefined;
+    /**
+     * Whether the select is disabled. Custom triggers should reflect this state.
+     */
+    isDisabled?: boolean;
+}
+/**
+ * All label props are required so that callers pass localized strings — the component
+ * has no built-in English defaults to leak into the UI.
+ *
+ * @internal
+ */
+export interface ITimezoneSelectProps {
+    /**
+     * Currently selected timezone ID (IANA ID, a special item ID or undefined).
+     */
+    value?: string;
+    /**
+     * Called when the user selects a timezone.
+     */
+    onChange: (id: string | undefined) => void;
+    /**
+     * Items rendered above the divider, ahead of the curated timezone list.
+     */
+    specialItems?: ITimezoneSelectSpecialItem[];
+    /**
+     * Label of the dropdown button when nothing is selected and no special item matches.
+     */
+    placeholder?: string;
+    /**
+     * Placeholder of the search input.
+     */
+    searchPlaceholder: string;
+    /**
+     * Accessibility label of the search input and the listbox.
+     */
+    ariaLabel: string;
+    /**
+     * Label shown when the search yields no results.
+     */
+    noMatchLabel: string;
+    isDisabled?: boolean;
+    /**
+     * Optional content rendered above the search input (e.g. a dialog-like header).
+     */
+    header?: ReactNode;
+    /**
+     * Custom renderer of the dropdown trigger. When not provided, a standard dropdown
+     * button showing the current selection is rendered.
+     *
+     * Use this to embed the select in surfaces where the default button does not fit,
+     * e.g. as an item of an options menu. The renderer receives the dropdown render props
+     * ({@link IDropdownButtonRenderProps}: toggleDropdown, isOpen, buttonRef, accessibility
+     * props, ...) together with the current selection ({@link ITimezoneSelectButtonRenderProps}).
+     */
+    renderButton?: (props: ITimezoneSelectButtonRenderProps) => ReactNode;
+}
+type TimezoneListItemData = string | undefined;
+export declare function buildListboxItems(specialItems: ITimezoneSelectSpecialItem[], searchString: string): IUiListboxItem<TimezoneListItemData>[];
+export declare function getSelectedItemId(value: string | undefined, specialItems: ITimezoneSelectSpecialItem[]): string | undefined;
+/**
+ * Searchable dropdown for picking a timezone from the curated list, with optional special
+ * items (e.g. "Default (workspace)", "From browser (...)") rendered above a divider.
+ *
+ * @internal
+ */
+export declare function TimezoneSelect({ value, onChange, specialItems, placeholder, searchPlaceholder, ariaLabel, noMatchLabel, isDisabled, header, renderButton }: ITimezoneSelectProps): ReactElement;
+export {};
+//# sourceMappingURL=TimezoneSelect.d.ts.map

package/esm/Timezone/TimezoneSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimezoneSelect.d.ts","sourceRoot":"","sources":["../../src/Timezone/TimezoneSelect.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAqB,MAAM,OAAO,CAAC;AAG7E,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhG,OAAO,EAAY,KAAK,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAYpF;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;OAGG;IACH,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gCAAiC,SAAQ,0BAA0B;IAChF;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACjC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAE3C;;OAEG;IACH,YAAY,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAE5C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,SAAS,CAAC;CACzE;AAED,KAAK,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAAC;AAM/C,wBAAgB,iBAAiB,CAC7B,YAAY,EAAE,0BAA0B,EAAE,EAC1C,YAAY,EAAE,MAAM,GACrB,cAAc,CAAC,oBAAoB,CAAC,EAAE,CA6BxC;AAGD,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,YAAY,EAAE,0BAA0B,EAAE,GAC3C,MAAM,GAAG,SAAS,CAMpB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAC3B,KAAK,EACL,QAAQ,EACR,YAAiB,EACjB,WAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,UAAU,EACV,MAAM,EACN,YAAY,EACf,EAAE,oBAAoB,GAAG,YAAY,CA2FrC"}

package/esm/Timezone/TimezoneSelect.js

@@ -0,0 +1,90 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// (C) 2026 GoodData Corporation
+import { useMemo, useState } from "react";
+import { UiButton } from "../@ui/UiButton/UiButton.js";
+import { UiListbox } from "../@ui/UiListbox/UiListbox.js";
+import { Dropdown } from "../Dropdown/Dropdown.js";
+import { Input } from "../Form/Input.js";
+import { NoData } from "../NoData/NoData.js";
+import { getTimezoneDisplayLabel, getTimezones, timezoneMatchesSearch } from "./timezones.js";
+const DROPDOWN_ALIGN_POINTS = [{ align: "bl tl" }, { align: "tl bl" }];
+const DROPDOWN_BODY_WIDTH = 300;
+// ~10 rows of 28px compact list items visible before the list scrolls
+const LIST_MAX_HEIGHT = 280;
+// special items may carry an undefined id, so listbox entries need a synthetic unique id
+const SPECIAL_ITEM_ID_PREFIX = "special-item-";
+// exported for tests
+export function buildListboxItems(specialItems, searchString) {
+    const search = searchString.trim().toLowerCase();
+    const specialListItems = specialItems
+        // keep the pre-filter index — getSelectedItemId derives the selected id from the
+        // unfiltered array, so filtered-out items must not shift the ids of the remaining ones
+        .map((item, index) => ({ item, index }))
+        .filter(({ item }) => !search || item.label.toLowerCase().includes(search))
+        .map(({ item, index }) => ({
+        type: "interactive",
+        id: `${SPECIAL_ITEM_ID_PREFIX}${index}`,
+        stringTitle: item.label,
+        data: item.id,
+    }));
+    const timezoneListItems = getTimezones()
+        .filter((timezone) => timezoneMatchesSearch(timezone, search))
+        .map((timezone) => ({
+        type: "interactive",
+        id: timezone.id,
+        stringTitle: getTimezoneDisplayLabel(timezone.id),
+        // the label shows the friendly name; surface the IANA ID on hover
+        tooltip: timezone.id,
+        data: timezone.id,
+    }));
+    return specialListItems.length > 0 && timezoneListItems.length > 0
+        ? [...specialListItems, { type: "separator" }, ...timezoneListItems]
+        : [...specialListItems, ...timezoneListItems];
+}
+// exported for tests
+export function getSelectedItemId(value, specialItems) {
+    const specialIndex = specialItems.findIndex((item) => item.id === value);
+    if (specialIndex >= 0) {
+        return `${SPECIAL_ITEM_ID_PREFIX}${specialIndex}`;
+    }
+    return value;
+}
+/**
+ * Searchable dropdown for picking a timezone from the curated list, with optional special
+ * items (e.g. "Default (workspace)", "From browser (...)") rendered above a divider.
+ *
+ * @internal
+ */
+export function TimezoneSelect({ value, onChange, specialItems = [], placeholder = "", searchPlaceholder, ariaLabel, noMatchLabel, isDisabled, header, renderButton, }) {
+    const [searchString, setSearchString] = useState("");
+    const selectedSpecialItem = specialItems.find((item) => item.id === value);
+    const buttonLabel = selectedSpecialItem
+        ? selectedSpecialItem.label
+        : value === undefined
+            ? placeholder
+            : getTimezoneDisplayLabel(value);
+    const items = useMemo(() => buildListboxItems(specialItems, searchString), [specialItems, searchString]);
+    const hasNoMatchingData = items.length === 0;
+    return (_jsx(Dropdown, { closeOnParentScroll: true, alignPoints: DROPDOWN_ALIGN_POINTS, className: "gd-timezone-select s-timezone-select", onOpenStateChanged: (isOpen) => {
+            if (!isOpen) {
+                setSearchString("");
+            }
+        }, renderButton: (renderProps) => renderButton ? (renderButton({ ...renderProps, buttonLabel, value, isDisabled })) : (_jsx(UiButton, { label: buttonLabel, onClick: renderProps.toggleDropdown, isDisabled: isDisabled, iconAfter: renderProps.isOpen ? "navigateUp" : "navigateDown", size: "small", dataTestId: "s-timezone-select-button", accessibilityConfig: {
+                ariaLabel,
+                ariaExpanded: renderProps.isOpen,
+            } })), renderBody: ({ closeDropdown, ariaAttributes }) => (_jsxs("div", { className: "gd-timezone-select__body s-timezone-select-body", children: [header, _jsx("div", { className: "gd-timezone-select__search s-timezone-select-search", children: _jsx(Input, { value: searchString, onChange: (newValue) => setSearchString(newValue.toString()), placeholder: searchPlaceholder, autofocus: true, clearOnEsc: true, isSearch: true, isSmall: true, onEscKeyPress: (event) => {
+                            if (searchString) {
+                                event.stopPropagation();
+                            }
+                            else {
+                                closeDropdown();
+                            }
+                        }, accessibilityConfig: {
+                            ariaLabel,
+                        } }) }), hasNoMatchingData ? (_jsx(NoData, { hasNoMatchingData: true, notFoundLabel: noMatchLabel, noDataLabel: noMatchLabel })) : (_jsx(UiListbox
+                // remount when the filter changes so the focused index cannot point
+                // past the end of a shortened result list, which would break keyboard selection
+                , { width: DROPDOWN_BODY_WIDTH, maxHeight: LIST_MAX_HEIGHT, items: items, selectedItemId: getSelectedItemId(value, specialItems), onSelect: (item) => {
+                        onChange(item.data);
+                    }, onClose: closeDropdown, ariaAttributes: ariaAttributes, isCompact: true, dataTestId: "s-timezone-select-list", itemDataTestId: "s-timezone-select-item" }, searchString))] })), overlayPositionType: "sameAsTarget" }));
+}

package/esm/Timezone/timezones.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Item describing a single timezone from the curated list.
+ *
+ * @internal
+ */
+export interface ITimezoneItem {
+    /**
+     * IANA timezone ID, e.g. "Europe/Prague".
+     */
+    id: string;
+    /**
+     * Human readable name without the offset, e.g. "Prague" or "Pacific Time (US & Canada)".
+     */
+    name: string;
+    /**
+     * GMT offset label, e.g. "GMT+01:00".
+     */
+    offsetLabel: string;
+    /**
+     * Offset from UTC in minutes as observed in January (northern hemisphere winter).
+     */
+    januaryOffset: number;
+    /**
+     * Offset from UTC in minutes as observed in June (northern hemisphere summer).
+     */
+    juneOffset: number;
+}
+/**
+ * Returns the full display label of a timezone, combining the offset and the name,
+ * e.g. "GMT+01:00 Prague". Use only where the merged label is actually displayed;
+ * consumers that need the name or the offset alone should read the fields directly.
+ *
+ * @internal
+ */
+export declare function getTimezoneTitle(item: Pick<ITimezoneItem, "name" | "offsetLabel">): string;
+/**
+ * Returns the curated list of timezones.
+ *
+ * @internal
+ */
+export declare function getTimezones(): ITimezoneItem[];
+/**
+ * Returns the timezone from the curated list matching the provided IANA timezone ID,
+ * or undefined when the ID is not in the curated list.
+ *
+ * @internal
+ */
+export declare function getTimezoneById(id: string | undefined): ITimezoneItem | undefined;
+/**
+ * Returns the curated timezone that matches the offsets of the browser/runtime timezone.
+ * Falls back to UTC when no curated timezone matches.
+ *
+ * @internal
+ */
+export declare function getUserTimezone(): ITimezoneItem;
+/**
+ * Returns the display label used by the timezone picker: the friendly name with the GMT offset
+ * as a suffix in brackets, e.g. "Prague (GMT+01:00)". The name falls back to the raw IANA ID
+ * for zones outside the curated list, and the offset suffix is dropped when not known.
+ *
+ * The friendly name (not the IANA ID) is shown so the picker reads the same as the Home UI
+ * timezone settings — the id-to-name mapping is not visible to users anywhere.
+ *
+ * @internal
+ */
+export declare function getTimezoneDisplayLabel(id: string): string;
+/**
+ * Tests whether the timezone matches the search string. Matches on the picker display label
+ * ("name (offset)"), the friendly title (offset + name) and the IANA ID, with underscores
+ * treated as spaces so that e.g. "Los Angeles" finds "America/Los_Angeles".
+ *
+ * @internal
+ */
+export declare function timezoneMatchesSearch(timezone: ITimezoneItem, search: string): boolean;
+/**
+ * Returns display labels for the provided IANA timezone ID.
+ *
+ * @remarks
+ * The backend accepts any ICU-known timezone, so the ID may not be present in the curated list.
+ * In that case the raw ID is used as the name and the offset label is computed via Intl
+ * (empty when the runtime does not know the timezone either).
+ *
+ * @internal
+ */
+export declare function getTimezoneLabels(id: string): Pick<ITimezoneItem, "name" | "offsetLabel">;
+//# sourceMappingURL=timezones.d.ts.map

package/esm/Timezone/timezones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezones.d.ts","sourceRoot":"","sources":["../../src/Timezone/timezones.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACtB;AAkJD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,MAAM,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAkB/C;AAED;;;;;;;;;GASG;AAGH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAWtF;AAmBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,CAAC,CAUzF"}

package/esm/Timezone/timezones.js

@@ -0,0 +1,253 @@
+// (C) 2026 GoodData Corporation
+const timezonesRaw = [
+    ["Pacific/Midway", "International Date Line West", "GMT-11:00", -660, -660],
+    ["Pacific/Pago_Pago", "Samoa", "GMT-11:00", -660, -660],
+    ["Pacific/Honolulu", "Hawaii", "GMT-10:00", -600, -600],
+    ["America/Juneau", "Alaska", "GMT-09:00", -540, -480],
+    ["America/Los_Angeles", "Pacific Time (US & Canada)", "GMT-08:00", -480, -420],
+    ["America/Tijuana", "Tijuana", "GMT-08:00", -480, -420],
+    ["America/Phoenix", "Arizona", "GMT-07:00", -420, -420],
+    ["America/Chihuahua", "Chihuahua", "GMT-07:00", -420, -360],
+    ["America/Mazatlan", "Mazatlan", "GMT-07:00", -420, -360],
+    ["America/Denver", "Mountain Time (US & Canada)", "GMT-07:00", -420, -360],
+    ["America/Guatemala", "Central America", "GMT-06:00", -360, -360],
+    ["America/Chicago", "Central Time (US & Canada)", "GMT-06:00", -360, -300],
+    ["America/Winnipeg", "Central - ON (west); Manitoba", "GMT-06:00", -360, -300],
+    ["America/Mexico_City", "Mexico City", "GMT-06:00", -360, -300],
+    ["America/Monterrey", "Monterrey", "GMT-06:00", -360, -300],
+    ["America/Regina", "Saskatchewan", "GMT-06:00", -360, -360],
+    ["America/Bogota", "Bogota", "GMT-05:00", -300, -300],
+    ["America/New_York", "Eastern Time (US & Canada)", "GMT-05:00", -300, -240],
+    ["America/Indiana/Indianapolis", "Indiana (East)", "GMT-05:00", -300, -240],
+    ["America/Lima", "Lima", "GMT-05:00", -300, -300],
+    ["America/Caracas", "Caracas", "GMT-04:30", -270, -270],
+    ["America/Halifax", "Atlantic Time (Canada)", "GMT-04:00", -240, -180],
+    ["America/Guyana", "Georgetown", "GMT-04:00", -240, -240],
+    ["America/La_Paz", "La Paz", "GMT-04:00", -240, -240],
+    ["America/Santiago", "Santiago", "GMT-04:00", -180, -240],
+    ["America/St_Johns", "Newfoundland", "GMT-03:30", -210, -150],
+    ["America/Sao_Paulo", "Brasilia", "GMT-03:00", -120, -180],
+    ["America/Argentina/Buenos_Aires", "Buenos Aires", "GMT-03:00", -180, -180],
+    ["America/Godthab", "Greenland", "GMT-03:00", -180, -120],
+    ["Atlantic/South_Georgia", "Mid-Atlantic", "GMT-02:00", -120, -120],
+    ["Atlantic/Azores", "Azores", "GMT-01:00", -60, 0],
+    ["Atlantic/Cape_Verde", "Cape Verde Is.", "GMT-01:00", -60, -60],
+    ["Africa/Casablanca", "Casablanca", "GMT+00:00", 0, 0],
+    ["Europe/Dublin", "Dublin", "GMT+00:00", 0, 60],
+    ["Europe/Lisbon", "Lisbon", "GMT+00:00", 0, 60],
+    ["Europe/London", "London", "GMT+00:00", 0, 60],
+    ["Africa/Monrovia", "Monrovia", "GMT+00:00", 0, 0],
+    ["Etc/UTC", "UTC", "GMT+00:00", 0, 0],
+    ["Europe/Amsterdam", "Amsterdam", "GMT+01:00", 60, 120],
+    ["Europe/Belgrade", "Belgrade", "GMT+01:00", 60, 120],
+    ["Europe/Berlin", "Berlin", "GMT+01:00", 60, 120],
+    ["Europe/Bratislava", "Bratislava", "GMT+01:00", 60, 120],
+    ["Europe/Brussels", "Brussels", "GMT+01:00", 60, 120],
+    ["Europe/Budapest", "Budapest", "GMT+01:00", 60, 120],
+    ["Europe/Copenhagen", "Copenhagen", "GMT+01:00", 60, 120],
+    ["Europe/Ljubljana", "Ljubljana", "GMT+01:00", 60, 120],
+    ["Europe/Madrid", "Madrid", "GMT+01:00", 60, 120],
+    ["Europe/Paris", "Paris", "GMT+01:00", 60, 120],
+    ["Europe/Prague", "Prague", "GMT+01:00", 60, 120],
+    ["Europe/Rome", "Rome", "GMT+01:00", 60, 120],
+    ["Europe/Sarajevo", "Sarajevo", "GMT+01:00", 60, 120],
+    ["Europe/Skopje", "Skopje", "GMT+01:00", 60, 120],
+    ["Europe/Stockholm", "Stockholm", "GMT+01:00", 60, 120],
+    ["Europe/Vienna", "Vienna", "GMT+01:00", 60, 120],
+    ["Europe/Warsaw", "Warsaw", "GMT+01:00", 60, 120],
+    ["Africa/Algiers", "West Central Africa", "GMT+01:00", 60, 60],
+    ["Europe/Zagreb", "Zagreb", "GMT+01:00", 60, 120],
+    ["Europe/Athens", "Athens", "GMT+02:00", 120, 180],
+    ["Europe/Bucharest", "Bucharest", "GMT+02:00", 120, 180],
+    ["Africa/Cairo", "Cairo", "GMT+02:00", 120, 180],
+    ["Africa/Harare", "Harare", "GMT+02:00", 120, 120],
+    ["Europe/Helsinki", "Helsinki", "GMT+02:00", 120, 180],
+    ["Europe/Istanbul", "Istanbul", "GMT+02:00", 120, 180],
+    ["Asia/Jerusalem", "Jerusalem", "GMT+02:00", 120, 180],
+    ["Europe/Kiev", "Kyiv", "GMT+02:00", 120, 180],
+    ["Europe/Minsk", "Minsk", "GMT+02:00", 120, 180],
+    ["Africa/Johannesburg", "Pretoria", "GMT+02:00", 120, 120],
+    ["Europe/Riga", "Riga", "GMT+02:00", 120, 180],
+    ["Europe/Sofia", "Sofia", "GMT+02:00", 120, 180],
+    ["Europe/Tallinn", "Tallinn", "GMT+02:00", 120, 180],
+    ["Europe/Vilnius", "Vilnius", "GMT+02:00", 120, 180],
+    ["Asia/Baghdad", "Baghdad", "GMT+03:00", 180, 180],
+    ["Asia/Kuwait", "Kuwait", "GMT+03:00", 180, 180],
+    ["Europe/Moscow", "Moscow", "GMT+03:00", 180, 240],
+    ["Africa/Nairobi", "Nairobi", "GMT+03:00", 180, 180],
+    ["Asia/Riyadh", "Riyadh", "GMT+03:00", 180, 180],
+    ["Asia/Tehran", "Tehran", "GMT+03:30", 210, 270],
+    ["Asia/Baku", "Baku", "GMT+04:00", 240, 300],
+    ["Asia/Muscat", "Muscat", "GMT+04:00", 240, 240],
+    ["Asia/Tbilisi", "Tbilisi", "GMT+04:00", 240, 240],
+    ["Asia/Yerevan", "Yerevan", "GMT+04:00", 240, 300],
+    ["Asia/Kabul", "Kabul", "GMT+04:30", 270, 270],
+    ["Asia/Yekaterinburg", "Ekaterinburg", "GMT+05:00", 300, 360],
+    ["Asia/Karachi", "Karachi", "GMT+05:00", 300, 300],
+    ["Asia/Tashkent", "Tashkent", "GMT+05:00", 300, 300],
+    ["Asia/Kolkata", "Kolkata", "GMT+05:30", 330, 330],
+    ["Asia/Colombo", "Sri Jayawardenepura", "GMT+05:30", 330, 330],
+    ["Asia/Kathmandu", "Kathmandu", "GMT+05:45", 345, 345],
+    ["Asia/Almaty", "Almaty", "GMT+06:00", 360, 360],
+    ["Asia/Dhaka", "Dhaka", "GMT+06:00", 360, 360],
+    ["Asia/Novosibirsk", "Novosibirsk", "GMT+06:00", 360, 420],
+    ["Asia/Rangoon", "Rangoon", "GMT+06:30", 390, 390],
+    ["Asia/Bangkok", "Bangkok", "GMT+07:00", 420, 420],
+    ["Asia/Jakarta", "Jakarta", "GMT+07:00", 420, 420],
+    ["Asia/Krasnoyarsk", "Krasnoyarsk", "GMT+07:00", 420, 480],
+    ["Asia/Shanghai", "Beijing", "GMT+08:00", 480, 480],
+    ["Asia/Chongqing", "Chongqing", "GMT+08:00", 480, 480],
+    ["Asia/Hong_Kong", "Hong Kong", "GMT+08:00", 480, 480],
+    ["Asia/Irkutsk", "Irkutsk", "GMT+08:00", 480, 540],
+    ["Asia/Kuala_Lumpur", "Kuala Lumpur", "GMT+08:00", 480, 480],
+    ["Australia/Perth", "Perth", "GMT+08:00", 480, 480],
+    ["Asia/Singapore", "Singapore", "GMT+08:00", 480, 480],
+    ["Asia/Taipei", "Taipei", "GMT+08:00", 480, 480],
+    ["Asia/Ulaanbaatar", "Ulaanbaatar", "GMT+08:00", 480, 480],
+    ["Asia/Urumqi", "Urumqi", "GMT+08:00", 480, 480],
+    ["Asia/Seoul", "Seoul", "GMT+09:00", 540, 540],
+    ["Asia/Tokyo", "Tokyo", "GMT+09:00", 540, 540],
+    ["Asia/Yakutsk", "Yakutsk", "GMT+09:00", 540, 600],
+    ["Australia/Adelaide", "Adelaide", "GMT+09:30", 630, 570],
+    ["Australia/Darwin", "Darwin", "GMT+09:30", 570, 570],
+    ["Australia/Brisbane", "Brisbane", "GMT+10:00", 600, 600],
+    ["Pacific/Guam", "Guam", "GMT+10:00", 600, 600],
+    ["Australia/Hobart", "Hobart", "GMT+10:00", 660, 600],
+    ["Australia/Melbourne", "Melbourne", "GMT+10:00", 660, 600],
+    ["Pacific/Port_Moresby", "Port Moresby", "GMT+10:00", 600, 600],
+    ["Australia/Sydney", "Sydney", "GMT+10:00", 660, 600],
+    ["Asia/Vladivostok", "Vladivostok", "GMT+10:00", 600, 660],
+    ["Asia/Kamchatka", "Kamchatka", "GMT+11:00", 660, 720],
+    ["Asia/Magadan", "Magadan", "GMT+11:00", 660, 720],
+    ["Pacific/Noumea", "New Caledonia", "GMT+11:00", 660, 660],
+    ["Asia/Sakhalin", "Sakhalin Island", "GMT+11:00", 660, 660],
+    ["Pacific/Auckland", "Auckland", "GMT+12:00", 780, 720],
+    ["Pacific/Fiji", "Fiji", "GMT+12:00", 780, 720],
+    ["Pacific/Majuro", "Marshall Is.", "GMT+12:00", 720, 720],
+    ["Pacific/Tongatapu", "Nuku'alofa", "GMT+13:00", 780, 780],
+];
+const timezones = timezonesRaw.map(([id, name, offsetLabel, januaryOffset, juneOffset]) => ({
+    id,
+    name,
+    offsetLabel,
+    januaryOffset,
+    juneOffset,
+}));
+const TIMEZONE_DEFAULT = timezones.find((tz) => tz.id === "Etc/UTC");
+/**
+ * Returns the full display label of a timezone, combining the offset and the name,
+ * e.g. "GMT+01:00 Prague". Use only where the merged label is actually displayed;
+ * consumers that need the name or the offset alone should read the fields directly.
+ *
+ * @internal
+ */
+export function getTimezoneTitle(item) {
+    return item.offsetLabel ? `${item.offsetLabel} ${item.name}` : item.name;
+}
+/**
+ * Returns the curated list of timezones.
+ *
+ * @internal
+ */
+export function getTimezones() {
+    return timezones;
+}
+/**
+ * Returns the timezone from the curated list matching the provided IANA timezone ID,
+ * or undefined when the ID is not in the curated list.
+ *
+ * @internal
+ */
+export function getTimezoneById(id) {
+    return timezones.find((tz) => tz.id === id);
+}
+/**
+ * Returns the curated timezone that matches the offsets of the browser/runtime timezone.
+ * Falls back to UTC when no curated timezone matches.
+ *
+ * @internal
+ */
+export function getUserTimezone() {
+    // prefer the exact runtime IANA id so zones sharing offsets (e.g. Berlin vs Amsterdam)
+    // resolve to the viewer's actual zone; fall back to offset matching for runtime ids
+    // that are not part of the curated list
+    const runtimeTimezoneId = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    const exactMatch = getTimezoneById(runtimeTimezoneId);
+    if (exactMatch) {
+        return exactMatch;
+    }
+    // sample the offsets on a fixed date in winter and in summer so that both DST variants are covered
+    const januaryOffset = -new Date(2011, 0, 1, 0, 0, 0, 0).getTimezoneOffset();
+    const juneOffset = -new Date(2011, 5, 1, 0, 0, 0, 0).getTimezoneOffset();
+    return (timezones.find((tz) => tz.januaryOffset === januaryOffset && tz.juneOffset === juneOffset) ??
+        TIMEZONE_DEFAULT);
+}
+/**
+ * Returns the display label used by the timezone picker: the friendly name with the GMT offset
+ * as a suffix in brackets, e.g. "Prague (GMT+01:00)". The name falls back to the raw IANA ID
+ * for zones outside the curated list, and the offset suffix is dropped when not known.
+ *
+ * The friendly name (not the IANA ID) is shown so the picker reads the same as the Home UI
+ * timezone settings — the id-to-name mapping is not visible to users anywhere.
+ *
+ * @internal
+ */
+// TODO INE (CQ-2725): finalize the picker label format and the ID-in-tooltip presentation
+// after the UX discussion.
+export function getTimezoneDisplayLabel(id) {
+    const { name, offsetLabel } = getTimezoneLabels(id);
+    return offsetLabel ? `${name} (${offsetLabel})` : name;
+}
+/**
+ * Tests whether the timezone matches the search string. Matches on the picker display label
+ * ("name (offset)"), the friendly title (offset + name) and the IANA ID, with underscores
+ * treated as spaces so that e.g. "Los Angeles" finds "America/Los_Angeles".
+ *
+ * @internal
+ */
+export function timezoneMatchesSearch(timezone, search) {
+    const normalizedSearch = search.trim().toLowerCase();
+    if (!normalizedSearch) {
+        return true;
+    }
+    return (getTimezoneTitle(timezone).toLowerCase().includes(normalizedSearch) ||
+        getTimezoneDisplayLabel(timezone.id).toLowerCase().includes(normalizedSearch) ||
+        timezone.id.toLowerCase().replace(/_/g, " ").includes(normalizedSearch.replace(/_/g, " ")));
+}
+function computeOffsetLabel(id) {
+    try {
+        const parts = new Intl.DateTimeFormat("en-US", {
+            timeZone: id,
+            timeZoneName: "longOffset",
+        }).formatToParts(new Date());
+        const offsetPart = parts.find((part) => part.type === "timeZoneName")?.value;
+        if (!offsetPart) {
+            return "";
+        }
+        // plain "GMT" is reported for the zero offset; normalize to the curated label format
+        return offsetPart === "GMT" ? "GMT+00:00" : offsetPart;
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Returns display labels for the provided IANA timezone ID.
+ *
+ * @remarks
+ * The backend accepts any ICU-known timezone, so the ID may not be present in the curated list.
+ * In that case the raw ID is used as the name and the offset label is computed via Intl
+ * (empty when the runtime does not know the timezone either).
+ *
+ * @internal
+ */
+export function getTimezoneLabels(id) {
+    const known = getTimezoneById(id);
+    if (known) {
+        return { name: known.name, offsetLabel: known.offsetLabel };
+    }
+    return {
+        name: id,
+        offsetLabel: computeOffsetLabel(id),
+    };
+}