@siemens/ix 4.4.0 → 5.1.0

package/dist/types/components/split-button/split-button.d.ts

@@ -1,8 +1,39 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import { CloseBehavior } from '../dropdown/dropdown-controller';
-import { AlignedPlacement } from '../dropdown/placement';
 import type { SplitButtonVariant } from './split-button.types';
-export declare class SplitButton {
+import { AriaActiveDescendantMixinContract } from '../utils/internal/mixins/accessibility/aria-activedescendant.mixin';
+declare const SplitButton_base: abstract new (...args: any[]) => {
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    hostElement?: import("@stencil/core/internal").HTMLStencilElement;
+    connectedCallback?(): void;
+    componentWillRender?(): Promise<void> | void;
+    componentDidRender?(): void;
+    componentWillLoad?(): Promise<void> | void;
+    componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+    componentWillUpdate?(): Promise<void> | void;
+    componentDidUpdate?(): void;
+    render?(): any;
+} & import("../utils/internal/component").StencilLifecycle & {
+    suppressAriaActiveDescendant: boolean;
+    isAriaActiveDescendantActive(): boolean;
+    getControllingAriaElement(): Promise<HTMLElement> | HTMLElement | null;
+    getAriaActiveDescendantProxyItemId(): string | boolean;
+    clearActiveDescendant(): Promise<void>;
+    $internal_onActiveDescendantChange(event: import("../utils/internal/mixins/setup.mixin").IxFocusVisibleChangeEvent): Promise<void>;
+    hostElement?: import("@stencil/core/internal").HTMLStencilElement;
+    connectedCallback?(): void;
+    disconnectedCallback?(): void;
+    componentWillRender?(): Promise<void> | void;
+    componentDidRender?(): void;
+    componentWillLoad?(): Promise<void> | void;
+    componentDidLoad?(): void;
+    componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+    componentWillUpdate?(): Promise<void> | void;
+    componentDidUpdate?(): void;
+    render?(): any;
+};
+export declare class SplitButton extends SplitButton_base implements AriaActiveDescendantMixinContract {
     hostElement: HTMLIxSplitButtonElement;
     /**
      * Color variant of button
@@ -52,10 +83,6 @@ export declare class SplitButton {
      * @since 4.1.0
      */
     disableDropdownButton: boolean;
-    /**
-     * Placement of the dropdown
-     */
-    placement: AlignedPlacement;
     /**
      * Enable Popover API rendering for dropdown.
      *
@@ -63,13 +90,21 @@ export declare class SplitButton {
      * @since 4.3.0
      */
     enableTopLayer: boolean;
-    toggle: boolean;
     /**
      * Button clicked
      */
     buttonClick: EventEmitter<MouseEvent>;
-    private readonly triggerElementRef;
+    private showDropdown;
+    private internalId;
+    private observeChildrenChange?;
+    componentDidLoad(): Promise<void> | void;
+    disconnectedCallback(): void;
     private get isDisabledButton();
     private get isDisabledIcon();
+    getControllingAriaElement(): Promise<HTMLElement> | HTMLElement | null;
+    isAriaActiveDescendantActive(): boolean;
+    getAriaActiveDescendantProxyItemId(): string | boolean;
+    private updateProxyList;
     render(): any;
 }
+export {};

package/dist/types/components/tab-item/tab-item.d.ts

@@ -1,6 +1,49 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import type { TabClickDetail } from './tab-item.types';
-export declare class TabItem {
+import { ComponentIdMixinContract } from '../utils/internal/mixins/id.mixin';
+import { BaseTabMixinContract } from './tab.mixin';
+declare const TabItem_base: abstract new (...args: any[]) => {
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    hostElement?: import("@stencil/core/internal").HTMLStencilElement;
+    connectedCallback?(): void;
+    componentWillRender?(): Promise<void> | void;
+    componentDidRender?(): void;
+    componentWillLoad?(): Promise<void> | void;
+    componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+    componentWillUpdate?(): Promise<void> | void;
+    componentDidUpdate?(): void;
+    render?(): any;
+} & import("../utils/internal/component").StencilLifecycle & {
+    $internal_id: number;
+    getHostElementId(): string;
+    hostElement?: import("@stencil/core/internal").HTMLStencilElement;
+    connectedCallback?(): void;
+    disconnectedCallback?(): void;
+    componentWillRender?(): Promise<void> | void;
+    componentDidRender?(): void;
+    componentWillLoad?(): Promise<void> | void;
+    componentDidLoad?(): void;
+    componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+    componentWillUpdate?(): Promise<void> | void;
+    componentDidUpdate?(): void;
+    render?(): any;
+} & {
+    tabKey: string;
+    hostElement?: import("@stencil/core/internal").HTMLStencilElement;
+    connectedCallback?(): void;
+    disconnectedCallback?(): void;
+    componentWillRender?(): Promise<void> | void;
+    componentDidRender?(): void;
+    componentWillLoad?(): Promise<void> | void;
+    componentDidLoad?(): void;
+    componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+    componentWillUpdate?(): Promise<void> | void;
+    componentDidUpdate?(): void;
+    render?(): any;
+};
+export declare class TabItem extends TabItem_base implements BaseTabMixinContract, ComponentIdMixinContract {
+    hostElement: HTMLIxTabItemElement;
     /**
      * Set selected tab
      */
@@ -10,33 +53,52 @@ export declare class TabItem {
      */
     disabled: boolean;
     /**
-     * Set small size tab
+     * Set icon of the tab
+     *
+     * @since 5.0.0
      */
-    small: boolean;
-    /**
-     * Set icon only tab
-     */
-    icon: boolean;
-    /**
-     * Set rounded tab
-     */
-    rounded: boolean;
+    icon?: string;
     /**
      * Set counter value
      */
     counter?: number;
     /**
-     * Set layout width style
+     * If the tab can be closed
+     *
+     * @since 5.0.0
      */
-    layout: 'auto' | 'stretched';
+    closable: boolean;
     /**
-     * Set selected placement
+     * Tab label
+     *
+     * @since 5.0.0
      */
+    label?: string;
+    /**
+     * Aria label for the close button, important for accessibility
+     *
+     * @since 5.0.0
+     */
+    ariaLabelCloseButton: string;
+    /** @internal */
     placement: 'bottom' | 'top';
+    /** @internal */
+    rounded: boolean;
+    /** @internal */
+    small: boolean;
+    /** @internal */
+    layout: 'auto' | 'stretched';
+    /** @internal */
+    iconOnly: boolean;
     /**
      * Emitted when the tab is clicked.
      */
     tabClick: EventEmitter<TabClickDetail>;
-    private tabItemClasses;
+    /**
+     * Emitted when the tab's close button is clicked.
+     */
+    tabClose: EventEmitter<TabClickDetail>;
+    private onTabSelect;
     render(): any;
 }
+export {};

package/dist/types/components/tab-item/tab-item.types.d.ts

@@ -1,3 +1,4 @@
 export type TabClickDetail = {
-    nativeEvent: MouseEvent;
+    tabKey?: string;
+    nativeEvent: Event;
 };

package/dist/types/components/tab-item/tab.mixin.d.ts

@@ -0,0 +1,26 @@
+import { MixedInCtor } from '../../stencil-public-runtime';
+import { StencilLifecycle } from '../utils/internal/component';
+export interface BaseTabMixinContract {
+    tabKey: string;
+}
+export declare const BaseTabMixin: <B extends MixedInCtor<StencilLifecycle>>(Base: B) => {
+    new (...args: any[]): {
+        /**
+         * Key of the tab, used for identifying the tab in events
+         *
+         * @since 5.0.0
+         */
+        tabKey: string;
+        hostElement?: import("@stencil/core/internal").HTMLStencilElement;
+        connectedCallback?(): void;
+        disconnectedCallback?(): void;
+        componentWillRender?(): Promise<void> | void;
+        componentDidRender?(): void;
+        componentWillLoad?(): Promise<void> | void;
+        componentDidLoad?(): void;
+        componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+        componentWillUpdate?(): Promise<void> | void;
+        componentDidUpdate?(): void;
+        render?(): any;
+    };
+} & B;

package/dist/types/components/tab-panel/tab-panel.d.ts

@@ -0,0 +1,42 @@
+import { ComponentIdMixinContract } from '../utils/internal/mixins/id.mixin';
+declare const TabPanel_base: abstract new (...args: any[]) => {
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    hostElement?: import("@stencil/core/internal").HTMLStencilElement;
+    connectedCallback?(): void;
+    componentWillRender?(): Promise<void> | void;
+    componentDidRender?(): void;
+    componentWillLoad?(): Promise<void> | void;
+    componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+    componentWillUpdate?(): Promise<void> | void;
+    componentDidUpdate?(): void;
+    render?(): any;
+} & import("../utils/internal/component").StencilLifecycle & {
+    $internal_id: number;
+    getHostElementId(): string;
+    hostElement?: import("@stencil/core/internal").HTMLStencilElement;
+    connectedCallback?(): void;
+    disconnectedCallback?(): void;
+    componentWillRender?(): Promise<void> | void;
+    componentDidRender?(): void;
+    componentWillLoad?(): Promise<void> | void;
+    componentDidLoad?(): void;
+    componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+    componentWillUpdate?(): Promise<void> | void;
+    componentDidUpdate?(): void;
+    render?(): any;
+};
+/**
+ * @internal
+ * @since 5.0.0
+ * */
+export declare class TabPanel extends TabPanel_base implements ComponentIdMixinContract {
+    hostElement: HTMLIxTabPanelElement;
+    /**
+     * Key of the tab panel, has to be the same as the tabKey of the corresponding ix-tab-item
+     */
+    tabKey: string;
+    connectedCallback(): void;
+    render(): any;
+}
+export {};

package/dist/types/components/tab-set/tab-set.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @internal
+ * @since 5.0.0
+ * */
+export declare class TabSet {
+    hostElement: HTMLIxTabSetElement;
+    private get tabPanels();
+    private get tabList();
+    private get tabListItems();
+    private panelsObserver?;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    private onPanelComponentsChange;
+    private checkPanelsVisibility;
+    render(): any;
+}

package/dist/types/components/tabs/tabs.d.ts

@@ -1,5 +1,33 @@
 import { EventEmitter } from '../../stencil-public-runtime';
-export declare class Tabs {
+declare const Tabs_base: abstract new (...args: any[]) => {
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    hostElement?: import("@stencil/core/internal").HTMLStencilElement;
+    connectedCallback?(): void;
+    componentWillRender?(): Promise<void> | void;
+    componentDidRender?(): void;
+    componentWillLoad?(): Promise<void> | void;
+    componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+    componentWillUpdate?(): Promise<void> | void;
+    componentDidUpdate?(): void;
+    render?(): any;
+} & import("../utils/internal/component").StencilLifecycle & {
+    inheritAriaAttributes: import("../utils/a11y").A11yAttributes;
+    getIgnoredAriaAttributes(): import("../utils/a11y").A11yAttributeName[];
+    componentWillLoad(): Promise<void> | void;
+    ariaAttributeChanged(newValue: string | null, _: string | null, propName: string): void;
+    hostElement?: import("@stencil/core/internal").HTMLStencilElement;
+    connectedCallback?(): void;
+    disconnectedCallback?(): void;
+    componentWillRender?(): Promise<void> | void;
+    componentDidRender?(): void;
+    componentDidLoad?(): void;
+    componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+    componentWillUpdate?(): Promise<void> | void;
+    componentDidUpdate?(): void;
+    render?(): any;
+};
+export declare class Tabs extends Tabs_base {
     hostElement: HTMLIxTabsElement;
     /**
      * Set tab items to small size
@@ -9,10 +37,6 @@ export declare class Tabs {
      * Set rounded tabs
      */
     rounded: boolean;
-    /**
-     * Set default selected tab by index
-     */
-    selected: number;
     /**
      * Set layout width style
      */
@@ -22,68 +46,54 @@ export declare class Tabs {
      */
     placement: 'bottom' | 'top';
     /**
-     * ARIA label for the chevron left icon button
+     * Aria label for the overflow menu button.
      *
-     * @since 3.2.0
+     * @since 5.0.0
      */
-    ariaLabelChevronLeftIconButton: string;
+    ariaLabelMoreTabs: string;
     /**
-     * ARIA label for the chevron right icon button
+     * Active tab key.
      *
-     * @since 3.2.0
+     * @since 5.0.0
      */
-    ariaLabelChevronRightIconButton: string;
+    activeTabKey?: string;
     /**
-     * Tab selection event. Event detail is the zero-based tab index. Fires when
-     * the user selects a tab, or when the tab list changes and the selected index
-     * is adjusted. Not emitted when `selected` is set from outside.
+     * Keyboard interaction behavior:
+     * automatic:  A tabs widget where tabs are automatically activated and their panel is displayed when they receive focus.
+     * manual: A tabs widget where users activate a tab and display its panel by pressing Space or Enter.
+     *
+     * @since 5.0.0
      */
-    selectedChange: EventEmitter<number>;
-    totalItems: number;
-    currentScrollAmount: number;
-    scrollAmount: number;
-    scrollActionAmount: number;
-    showArrowPrevious: boolean;
-    showArrowNext: boolean;
-    private windowStartSize;
+    keyboardNavigation: 'automatic' | 'manual';
+    /**
+     * Tab selection event. Event detail contains the new active tab key.
+     *
+     * @since 5.0.0
+     */
+    tabChange: EventEmitter<string | undefined>;
+    /**
+     * Tab close event. Event detail contains the closed tab key.
+     *
+     * @since 5.0.0
+     */
+    tabClose: EventEmitter<string | undefined>;
+    private isTabsOverflow;
+    private overflowMenuItems;
     private resizeObserver?;
-    private readonly ARROW_WIDTH;
-    /** Movement in px beyond which we treat as drag (not tap). */
-    private readonly TAP_THRESHOLD_PX;
-    private classObserver?;
-    private updateScheduled;
-    private readonly clickAction;
-    private isDragging;
-    onWindowResize(): number | undefined;
-    private getTabs;
-    private getTab;
-    private getTabsWrapper;
-    private getTabsContainer;
-    private initResizeObserver;
-    private observeSlotChanges;
-    private scheduleTabUpdate;
-    private setTabAttributes;
-    private applyRequiredClasses;
-    private buildRequiredClasses;
-    private ensureSelectedIndex;
-    private updateSelected;
-    private updateTabAttributes;
-    private showArrows;
-    private showPreviousArrow;
-    private showNextArrow;
-    private move;
-    onSelectedChange(newValue: number): void;
-    private setSelected;
-    private clickTab;
-    private dragStart;
-    private dragMove;
-    private dragStop;
-    componentWillLoad(): void;
-    componentDidRender(): void;
-    componentWillRender(): void;
-    private renderArrows;
+    private itemsObserver?;
+    private readonly tabsContainerRef;
+    private readonly tabsRef;
+    private get tabs();
     componentDidLoad(): void;
+    componentWillLoad(): void;
     disconnectedCallback(): void;
-    onTabClick(event: CustomEvent): void;
+    onActiveTabChange(tabKey: string | undefined, oldTabKey: string | undefined): void;
+    private setTabActive;
+    private onComponentChildrenChange;
+    private onComponentResize;
+    private onTabClick;
+    private emitTabChangeEvent;
+    private onTabsNavigate;
     render(): any;
 }
+export {};

package/dist/types/components/time-input/time-input.d.ts

@@ -1,14 +1,29 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import { PickerValidityStateTracker } from '../input/input.util';
 import { IxInputFieldComponent, ValidationResults } from '../utils/input';
+import { InputPickerMixinContract } from '../utils/internal/mixins/input/input-picker.mixin';
+import { MakeRef } from '../utils/make-ref';
 import type { TimeInputValidityState } from './time-input.types';
+declare const TimeInput_base: abstract new (...args: any[]) => {
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    hostElement?: import("@stencil/core/internal").HTMLStencilElement;
+    connectedCallback?(): void;
+    componentWillRender?(): Promise<void> | void;
+    componentDidRender?(): void;
+    componentWillLoad?(): Promise<void> | void;
+    componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+    componentWillUpdate?(): Promise<void> | void;
+    componentDidUpdate?(): void;
+    render?(): any;
+} & import("../utils/internal/component").StencilLifecycle;
 /**
  * @since 3.2.0
  * @form-ready
  * @slot start - Element will be displayed at the start of the input
  * @slot end - Element will be displayed at the end of the input
  */
-export declare class TimeInput implements IxInputFieldComponent<string> {
+export declare class TimeInput extends TimeInput_base implements IxInputFieldComponent<string>, InputPickerMixinContract {
     hostElement: HTMLIxTimeInputElement;
     formInternals: ElementInternals;
     /**
@@ -29,6 +44,20 @@ export declare class TimeInput implements IxInputFieldComponent<string> {
      * See {@link https://moment.github.io/luxon/#/formatting?id=table-of-tokens} for all available tokens.
      */
     format: string;
+    /**
+     * Earliest selectable time (`format` tokens). Invalid non-empty values are ignored.
+     *
+     * @since 5.0.0
+     */
+    minTime?: string;
+    /**
+     * Latest selectable time (`format` tokens). Invalid non-empty values are ignored.
+     *
+     * @since 5.0.0
+     */
+    maxTime?: string;
+    watchMinTimePropHandler(): void;
+    watchMaxTimePropHandler(): void;
     /**
      * Required attribute.
      */
@@ -135,6 +164,13 @@ export declare class TimeInput implements IxInputFieldComponent<string> {
      * @since 4.3.0
      */
     enableTopLayer: boolean;
+    /**
+     * ARIA label for the time picker toggle button
+     * Will be set as aria-label for the nested HTML button element
+     *
+     * @since 5.0.0
+     */
+    ariaLabelTimeToggleButton?: string;
     /**
      * Value change event. Emitted when the input value changes.
      */
@@ -167,13 +203,9 @@ export declare class TimeInput implements IxInputFieldComponent<string> {
     private readonly inputElementRef;
     private readonly dropdownElementRef;
     private classObserver?;
-    /** @internal */
     initialValue?: string;
-    /** @internal */
     invalidReason?: string;
-    /** @internal */
     touched: boolean;
-    /** @internal */
     validityTracker: PickerValidityStateTracker;
     private disposableChangesAndVisibilityObservers?;
     private handleInputKeyDown;
@@ -182,11 +214,14 @@ export declare class TimeInput implements IxInputFieldComponent<string> {
     componentWillLoad(): void;
     private updatePaddings;
     disconnectedCallback(): void;
-    watchValue(): void;
     /** @internal */
     hasValidValue(): Promise<boolean>;
     /** @internal */
     getAssociatedFormElement(): Promise<HTMLFormElement | null>;
+    private isWithinConfiguredBounds;
+    private syncPickerTimeFromValue;
+    private validateNonEmptyValue;
+    private revalidateCurrentValue;
     onInput(value: string): Promise<void>;
     onTimeIconClick(event: Event): void;
     openDropdown(): Promise<void>;
@@ -210,5 +245,7 @@ export declare class TimeInput implements IxInputFieldComponent<string> {
      * @internal
      */
     isTouched(): Promise<boolean>;
+    getPickerElement(): MakeRef<HTMLIxDropdownElement> | null;
     render(): any;
 }
+export {};

package/dist/types/components/time-picker/time-picker-column-values.d.ts

@@ -0,0 +1,15 @@
+export type TimePickerColumnIntervals = {
+    hourInterval: number;
+    minuteInterval: number;
+    secondInterval: number;
+    millisecondInterval: number;
+};
+/**
+ * Builds the discrete values shown in each time-picker column.
+ */
+export declare function buildTimePickerColumnNumberArrays(intervals: TimePickerColumnIntervals, timeRef: 'AM' | 'PM' | undefined): {
+    hourNumbers: number[];
+    minuteNumbers: number[];
+    secondNumbers: number[];
+    millisecondsNumbers: number[];
+};

package/dist/types/components/time-picker/time-picker-compute-time.d.ts

@@ -0,0 +1,6 @@
+import { DateTime } from 'luxon';
+import type { TimePickerDescriptorUnit } from './time-picker.types';
+/**
+ * Applies a raw column value to a base time (including 12h rules).
+ */
+export declare function computeTimeWithRawUnitValue(baseTime: DateTime, unit: TimePickerDescriptorUnit, rawValue: number, timeRef: 'AM' | 'PM' | undefined): DateTime | null;

package/dist/types/components/time-picker/time-picker-constraints.d.ts

@@ -0,0 +1,16 @@
+import { DateTime } from 'luxon';
+/**
+ * Parses a time-of-day string in `format` and applies it to `baseDay` (date part only).
+ */
+export declare function parseTimeOnDay(value: string | undefined, format: string, baseDay: DateTime): DateTime | null;
+export declare function getTimePickerConstraintBounds(minTime: string | undefined, maxTime: string | undefined, format: string, baseDay: DateTime): {
+    min: DateTime | null;
+    max: DateTime | null;
+};
+export declare function isWithinTimePickerConstraints(candidate: DateTime, min: DateTime | null, max: DateTime | null): boolean;
+export declare function hasActiveTimePickerConstraints(min: DateTime | null, max: DateTime | null): boolean;
+/**
+ * Whether the inclusive wall-clock range `[rangeStart, rangeEnd]` can intersect
+ * inclusive constraint bounds `[min, max]` (either bound may be null = unbounded).
+ */
+export declare function timeOfDayRangeIntersectsInclusiveBounds(rangeStart: DateTime, rangeEnd: DateTime, min: DateTime | null, max: DateTime | null): boolean;

package/dist/types/components/time-picker/time-picker-display.d.ts

@@ -0,0 +1,6 @@
+import type { TimePickerDescriptorUnit } from './time-picker.types';
+export declare function formatTimePickerUnitValue(unit: TimePickerDescriptorUnit, value: number): string;
+export type TimePickerColumnSeparatorDescriptor = {
+    unit: TimePickerDescriptorUnit;
+};
+export declare function getTimePickerColumnSeparator(currentIndex: number, descriptors: TimePickerColumnSeparatorDescriptor[]): string;

package/dist/types/components/time-picker/time-picker-format.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Luxon format patterns used to decide which time-picker columns are shown.
+ */
+export declare const LUXON_FORMAT_PATTERNS: {
+    hours: RegExp;
+    minutes: RegExp;
+    seconds: RegExp;
+    milliseconds: RegExp;
+};
+/**
+ * Whether the Luxon format string uses 12-hour clock semantics for the picker.
+ */
+export declare function isFormat12Hour(format: string): boolean;

package/dist/types/components/time-picker/time-picker-range.d.ts

@@ -0,0 +1,11 @@
+import { DateTime } from 'luxon';
+import type { TimePickerDescriptorUnit } from './time-picker.types';
+export type TimePickerCandidateRange = {
+    start: DateTime;
+    end: DateTime;
+};
+export declare function getCandidateRangeForUnit(unit: TimePickerDescriptorUnit, candidate: DateTime): TimePickerCandidateRange | null;
+export declare function isSelectableForUnitWithinBounds(unit: TimePickerDescriptorUnit, candidate: DateTime, bounds: {
+    min: DateTime | null;
+    max: DateTime | null;
+}): boolean;

package/dist/types/components/time-picker/time-picker-step-focus.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Moves one step in a ring over `values`, skipping entries where `canSelect`
+ * is false (same algorithm as {@link TimePicker#stepFocusedValue}).
+ *
+ * @returns the next selectable value, or `null` if `values` is empty or no entry is selectable.
+ */
+export declare function findNextSelectableRingValue(values: number[], currentValue: number, direction: 1 | -1, canSelect: (candidate: number) => boolean): number | null;