@oslokommune/punkt-react 16.9.0 → 16.10.0

package/dist/shared-types/aria.d.ts

@@ -0,0 +1,65 @@
+/**
+ * aria.ts
+ *
+ * Type definitions for ARIA attributes and roles.
+ * These follow the WAI-ARIA specification and are used across all Punkt components.
+ */
+export type TAriaBoolean = boolean | 'true' | 'false';
+export type TAriaBooleanMixed = TAriaBoolean | 'mixed';
+export type TAriaCurrent = TAriaBoolean | 'page' | 'step' | 'location' | 'date' | 'time';
+export type TAriaHasPopup = TAriaBoolean | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog';
+export type TAriaInvalid = TAriaBoolean | 'grammar' | 'spelling';
+export type TAriaLive = 'off' | 'polite' | 'assertive';
+export type TAriaRelevant = 'additions' | 'removals' | 'text' | 'all';
+export type TAriaSort = 'none' | 'ascending' | 'descending' | 'other';
+export type TAriaAutoComplete = 'none' | 'inline' | 'list' | 'both';
+export type TAriaOrientation = 'horizontal' | 'vertical';
+export interface IAriaAttributes {
+    'aria-activedescendant'?: string;
+    'aria-controls'?: string;
+    'aria-describedby'?: string;
+    'aria-details'?: string;
+    'aria-errormessage'?: string;
+    'aria-flowto'?: string;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    'aria-owns'?: string;
+    'aria-roledescription'?: string;
+    'aria-autocomplete'?: TAriaAutoComplete;
+    'aria-checked'?: TAriaBooleanMixed;
+    'aria-current'?: TAriaCurrent;
+    'aria-disabled'?: TAriaBoolean;
+    'aria-expanded'?: TAriaBoolean;
+    'aria-haspopup'?: TAriaHasPopup;
+    'aria-hidden'?: TAriaBoolean;
+    'aria-invalid'?: TAriaInvalid;
+    'aria-keyshortcuts'?: string;
+    'aria-level'?: number;
+    'aria-modal'?: TAriaBoolean;
+    'aria-multiline'?: TAriaBoolean;
+    'aria-multiselectable'?: TAriaBoolean;
+    'aria-orientation'?: TAriaOrientation;
+    'aria-placeholder'?: string;
+    'aria-pressed'?: TAriaBooleanMixed;
+    'aria-readonly'?: TAriaBoolean;
+    'aria-required'?: TAriaBoolean;
+    'aria-selected'?: TAriaBoolean;
+    'aria-sort'?: TAriaSort;
+    'aria-atomic'?: TAriaBoolean;
+    'aria-busy'?: TAriaBoolean;
+    'aria-live'?: TAriaLive;
+    'aria-relevant'?: TAriaRelevant | string;
+    'aria-colcount'?: number;
+    'aria-colindex'?: number;
+    'aria-colspan'?: number;
+    'aria-rowcount'?: number;
+    'aria-rowindex'?: number;
+    'aria-rowspan'?: number;
+    'aria-posinset'?: number;
+    'aria-setsize'?: number;
+    'aria-valuemax'?: number;
+    'aria-valuemin'?: number;
+    'aria-valuenow'?: number;
+    'aria-valuetext'?: string;
+}
+export type TAlertRole = 'alert' | 'status';

package/dist/shared-types/booleanish.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Booleanish type that accepts boolean or string "true"/"false"
+ * This allows attributes to be set as strings in HTML
+ */
+export type Booleanish = boolean | 'true' | 'false';
+/**
+ * Converter for booleanish attributes
+ * Converts string "true"/"false" to boolean values
+ */
+export declare const booleanishConverter: {
+    fromAttribute(value: string | boolean | null): boolean;
+    toAttribute(value: boolean): string | null;
+};

package/dist/shared-types/calendar.d.ts

@@ -0,0 +1,41 @@
+/**
+ * calendar.ts
+ *
+ * Type definitions for the calendar component.
+ * Used by both Elements and React calendar implementations
+ * and by the shared calendar helper functions.
+ */
+export interface IDateConstraints {
+    earliest: string | null;
+    latest: string | null;
+    excludedates: Date[];
+    excludeweekdays: string[];
+}
+export interface ICalendarGridDimensions {
+    firstDayOfMonth: Date;
+    lastDayOfMonth: Date;
+    startingDay: number;
+    numDays: number;
+    numRows: number;
+    numDaysPrevMonth: number;
+    initialWeek: number;
+}
+export interface IGridCellPosition {
+    rowIndex: number;
+    colIndex: number;
+}
+export type TDateRangeMap = {
+    [key: string]: boolean;
+};
+export interface ISelectionState {
+    selected: string[];
+    _selected: Date[];
+    inRange: TDateRangeMap;
+}
+export interface ISelectionOptions {
+    multiple: boolean;
+    maxMultiple: number;
+    range: boolean;
+    excludedates: Date[];
+    excludeweekdays: string[];
+}

package/dist/shared-types/combobox.d.ts

@@ -0,0 +1,34 @@
+/**
+ * combobox.ts
+ *
+ * Type definitions for the combobox and listbox components.
+ * Used by both Elements and React implementations
+ * and by the shared combobox helper functions.
+ */
+/**
+ * Tag skin colors available for combobox option tags.
+ * Matches the TTagSkin values from the tag component.
+ */
+export type TPktComboboxTagSkin = 'blue' | 'blue-dark' | 'blue-light' | 'green' | 'red' | 'yellow' | 'beige' | 'gray' | 'grey';
+/**
+ * Represents a single option in a combobox or listbox.
+ */
+export interface IPktComboboxOption {
+    description?: string;
+    disabled?: boolean;
+    fulltext?: string;
+    label?: string;
+    prefix?: string;
+    selected?: boolean;
+    tagSkinColor?: TPktComboboxTagSkin;
+    userAdded?: boolean;
+    value: string;
+}
+/**
+ * How the selected value is displayed in the combobox input.
+ */
+export type TPktComboboxDisplayValue = 'label' | 'value' | 'prefixAndValue';
+/**
+ * Placement of selected value tags in multiple selection mode.
+ */
+export type TPktComboboxTagPlacement = 'inside' | 'outside';

package/dist/shared-types/datepicker.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Internationalization strings for the datepicker component family.
+ * Shared between Elements and React packages.
+ */
+export interface IDatepickerStrings {
+    /** Calendar-related strings */
+    calendar?: {
+        /** Alt text for calendar button */
+        buttonAltText?: string;
+    };
+    /** Generic UI strings (used in range datepicker) */
+    generic?: {
+        /** Label for range start input */
+        from?: string;
+        /** Label for range end input */
+        to?: string;
+    };
+    /** Form validation messages */
+    forms?: {
+        messages?: {
+            /** Error message when date is before minimum */
+            rangeUnderflow?: string;
+            /** Error message when date is after maximum */
+            rangeOverflow?: string;
+            /** Error message for invalid date format */
+            badInput?: string;
+            /** Error message when required field is empty */
+            valueMissing?: string;
+        };
+    };
+    /** Date-related strings */
+    dates?: {
+        /** Month label */
+        month?: string;
+        /** Year label */
+        year?: string;
+    };
+}
+/**
+ * Default strings for single/multiple datepicker
+ */
+export declare const defaultSingleStrings: IDatepickerStrings;
+/**
+ * Default strings for range datepicker
+ */
+export declare const defaultRangeStrings: IDatepickerStrings;

package/dist/shared-types/form.d.ts

@@ -0,0 +1,16 @@
+/**
+ * form.ts
+ *
+ * Type definitions for HTML form elements and controls.
+ * These follow HTML standards for form element types.
+ */
+/**
+ * HTML button type attribute values
+ * Used for <button type="..."> and similar elements
+ */
+export type THTMLButtonType = 'button' | 'submit' | 'reset';
+/**
+ * Selection mode for form controls
+ * Used in components that support single, multiple, or range selection
+ */
+export type TSelectionMode = 'single' | 'multiple' | 'range';

package/dist/shared-types/header.d.ts

@@ -0,0 +1,88 @@
+/**
+ * header.ts
+ *
+ * Type definitions for header-related domain models.
+ * These represent user, organization, and menu item data structures.
+ */
+/**
+ * User object containing information about the logged-in user
+ */
+export interface User {
+    /** Full name of the user */
+    name: string;
+    /** Short name or initials (deprecated) */
+    shortname?: string;
+    /** Last login timestamp (ISO string or Date) */
+    lastLoggedIn?: Date | string;
+}
+/**
+ * Representation object containing information about the organization/entity being represented
+ */
+export interface Representing {
+    /** Name of the organization or entity */
+    name: string;
+    /** Short name or initials (deprecated) */
+    shortname?: string;
+    /** Organization number */
+    orgNumber?: string | number;
+}
+/**
+ * Menu item in the user menu
+ * The iconName will be typed as PktIconName in package-specific implementations
+ */
+export interface UserMenuItem<IconType = string> {
+    /** Icon name to display */
+    iconName?: IconType;
+    /** Text for the menu item */
+    title: string;
+    /** Link URL or click handler function */
+    target: string | (() => void);
+}
+/**
+ * Internal type for rendering links/buttons (supports both href and onClick)
+ * Base interface for discriminated union
+ */
+export interface InternalMenuItemBase<IconType = string> {
+    title: string;
+    iconName?: IconType;
+}
+/**
+ * Internal menu item that is a link
+ */
+export interface InternalMenuLink<IconType = string> extends InternalMenuItemBase<IconType> {
+    href: string;
+}
+/**
+ * Internal menu item that is a button
+ */
+export interface InternalMenuButton<IconType = string> extends InternalMenuItemBase<IconType> {
+    onClick: () => void;
+}
+/**
+ * Union type for internal menu items (discriminated by href vs onClick)
+ */
+export type TInternalMenuItem<IconType = string> = InternalMenuLink<IconType> | InternalMenuButton<IconType>;
+/**
+ * Helper to convert UserMenuItem (with target) to internal format
+ */
+export declare const convertUserMenuItem: <IconType = string>(item: UserMenuItem<IconType>) => TInternalMenuItem<IconType>;
+/**
+ * Variant for the slot menu button in tablet/mobile mode
+ */
+export type TSlotMenuVariant = 'icon-only' | 'icon-right';
+/**
+ * Type for which menu is currently open in the header
+ */
+export type THeaderMenu = 'none' | 'slot' | 'search' | 'user';
+/**
+ * Placement options for the logout button
+ */
+export type TLogOutButtonPlacement = 'userMenu' | 'header' | 'both' | 'none';
+/**
+ * Position options for the header
+ */
+export type THeaderPosition = 'fixed' | 'relative';
+/**
+ * Scroll behavior options for the header
+ */
+export type THeaderScrollBehavior = 'hide' | 'none';

package/dist/shared-types/heading.d.ts

@@ -0,0 +1,9 @@
+/**
+ * heading.ts
+ *
+ * Type definitions for heading-related types.
+ * These represent HTML heading semantics (h1-h6) and typography scales.
+ */
+export type THeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+export type THeadingSize = 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge';
+export type THeadingWeight = 'light' | 'regular' | 'medium' | 'bold';

package/dist/shared-types/index.d.ts

@@ -0,0 +1,17 @@
+export type { Booleanish } from './booleanish';
+export { booleanishConverter } from './booleanish';
+export type { TAriaBoolean, TAriaBooleanMixed, TAriaCurrent, TAriaHasPopup, TAriaInvalid, TAriaLive, TAriaRelevant, TAriaSort, TAriaAutoComplete, TAriaOrientation, IAriaAttributes, TAlertRole, } from './aria';
+export type { THeadingLevel, THeadingSize, THeadingWeight } from './heading';
+export type { User, Representing, UserMenuItem, InternalMenuItemBase, InternalMenuLink, InternalMenuButton, TInternalMenuItem, TSlotMenuVariant, THeaderMenu, TLogOutButtonPlacement, THeaderPosition, THeaderScrollBehavior, } from './header';
+export { convertUserMenuItem } from './header';
+export type { TLayout, TVerticalPosition, THorizontalPosition, TPosition, TPositionWithCenter, } from './layout';
+export type { THTMLButtonType, TSelectionMode } from './form';
+export type { TSize3, TSize5, TSize7 } from './size';
+export type { TAlertSkin, TMessageboxSkin, TAccordionSkin, TCardSkin } from './skin';
+export type { IDateConstraints, ICalendarGridDimensions, IGridCellPosition, TDateRangeMap, ISelectionState, ISelectionOptions, } from './calendar';
+export type { IDatepickerStrings } from './datepicker';
+export { defaultSingleStrings, defaultRangeStrings } from './datepicker';
+export type { ITimepickerStrings } from './timepicker';
+export { defaultTimepickerStrings } from './timepicker';
+export type { TProgressbarRole, TProgressbarSkin, TProgressbarStatusPlacement, TProgressbarStatusType, TProgressbarTitlePosition, } from './progressbar';
+export type { IPktComboboxOption, TPktComboboxTagSkin, TPktComboboxDisplayValue, TPktComboboxTagPlacement, } from './combobox';

package/dist/shared-types/layout.d.ts

@@ -0,0 +1,26 @@
+/**
+ * layout.ts
+ *
+ * Type definitions for layout and positioning.
+ * These represent common layout patterns used across components.
+ */
+/**
+ * Layout direction - vertical or horizontal orientation
+ */
+export type TLayout = 'vertical' | 'horizontal';
+/**
+ * Generic positioning type for top/bottom placement
+ */
+export type TVerticalPosition = 'top' | 'bottom';
+/**
+ * Generic positioning type for left/right placement
+ */
+export type THorizontalPosition = 'left' | 'right';
+/**
+ * Generic positioning type for all four directions
+ */
+export type TPosition = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * Generic positioning including center
+ */
+export type TPositionWithCenter = TPosition | 'center';

package/dist/shared-types/progressbar.d.ts

@@ -0,0 +1,5 @@
+export type TProgressbarRole = 'progressbar' | 'meter';
+export type TProgressbarSkin = 'dark-blue' | 'light-blue' | 'green' | 'red';
+export type TProgressbarStatusPlacement = 'center' | 'left' | 'following';
+export type TProgressbarStatusType = 'none' | 'percentage' | 'fraction';
+export type TProgressbarTitlePosition = 'left' | 'center';

package/dist/shared-types/size.d.ts

@@ -0,0 +1,18 @@
+/**
+ * size.ts
+ *
+ * Type definitions for sizing scales.
+ * These represent common size scales used across the design system.
+ */
+/**
+ * Standard 3-level size scale
+ */
+export type TSize3 = 'small' | 'medium' | 'large';
+/**
+ * Extended 5-level size scale
+ */
+export type TSize5 = 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge';
+/**
+ * Full 7-level size scale
+ */
+export type TSize7 = 'xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge';

package/dist/shared-types/skin.d.ts

@@ -0,0 +1,24 @@
+/**
+ * skin.ts
+ *
+ * Type definitions for component skin/color variants.
+ * Only includes skin types that are identical across packages.
+ * Component-specific skin types should remain in their respective component files.
+ */
+/**
+ * Alert component skin variants
+ * Used for semantic color coding of alerts (error, success, warning, info)
+ */
+export type TAlertSkin = 'error' | 'success' | 'warning' | 'info';
+/**
+ * Messagebox component skin variants
+ */
+export type TMessageboxSkin = 'beige' | 'blue' | 'red' | 'green';
+/**
+ * Accordion component skin variants
+ */
+export type TAccordionSkin = 'borderless' | 'outlined' | 'beige' | 'blue';
+/**
+ * Card component skin variants
+ */
+export type TCardSkin = 'outlined' | 'outlined-beige' | 'gray' | 'beige' | 'green' | 'blue';

package/dist/shared-types/timepicker.d.ts

@@ -0,0 +1,20 @@
+/**
+ * timepicker.ts
+ *
+ * Type definitions for the timepicker component.
+ * Used by both Elements and React implementations.
+ */
+/**
+ * Translation strings for the timepicker component.
+ * Matches the shape of the `timepicker` key in no.json.
+ */
+export interface ITimepickerStrings {
+    hours: string;
+    minutes: string;
+    openPicker: string;
+    prevTime: string;
+    nextTime: string;
+    selectTime: string;
+}
+/** Default labels (Norwegian Bokmål), aligned with `packages/elements/src/translations/no.json`. */
+export declare const defaultTimepickerStrings: ITimepickerStrings;

package/dist/shared-utils/calendar/calendar-grid.d.ts

@@ -0,0 +1,16 @@
+import type { ICalendarGridDimensions } from '../../shared-types/calendar';
+export type { ICalendarGridDimensions, IGridCellPosition } from '../../shared-types/calendar';
+export declare const DAYS_PER_WEEK = 7;
+export declare const MONDAY_OFFSET = 6;
+/**
+ * Calculate the dimensions and structure of the calendar grid
+ */
+export declare function calculateCalendarDimensions(year: number, month: number): ICalendarGridDimensions;
+/**
+ * Determine what type of cell to render at a given position
+ */
+export declare function getCellType(rowIndex: number, colIndex: number, dayCounter: number, gridDimensions: ICalendarGridDimensions): 'prev-month' | 'current-month' | 'next-month';
+/**
+ * Get the day number to display for a given cell
+ */
+export declare function getDayNumber(cellType: 'prev-month' | 'current-month' | 'next-month', colIndex: number, dayCounter: number, gridDimensions: ICalendarGridDimensions): number;

package/dist/shared-utils/calendar/date-validation.d.ts

@@ -0,0 +1,22 @@
+import type { IDateConstraints } from '../../shared-types/calendar';
+export type { IDateConstraints } from '../../shared-types/calendar';
+/**
+ * Check if a date is excluded based on constraints
+ */
+export declare function isDateExcluded(date: Date, constraints: IDateConstraints): boolean;
+/**
+ * Check if a day should be disabled for selection
+ */
+export declare function isDayDisabled(date: Date, isSelected: boolean, constraints: IDateConstraints, options: {
+    multiple: boolean;
+    maxMultiple: number;
+    selectedCount: number;
+}): boolean;
+/**
+ * Check if navigation to previous month is allowed
+ */
+export declare function isPrevMonthAllowed(year: number, month: number, earliest: string | null): boolean;
+/**
+ * Check if navigation to next month is allowed
+ */
+export declare function isNextMonthAllowed(year: number, month: number, latest: string | null): boolean;

package/dist/shared-utils/calendar/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Calendar Helper Exports
+ *
+ * This module re-exports all calendar helper functions and types
+ * to provide a single import point for calendar-related utilities.
+ */
+export { isDateExcluded, isDayDisabled, isPrevMonthAllowed, isNextMonthAllowed, type IDateConstraints, } from './date-validation';
+export { DAYS_PER_WEEK, MONDAY_OFFSET, calculateCalendarDimensions, getCellType, getDayNumber, type ICalendarGridDimensions, type IGridCellPosition, } from './calendar-grid';
+export { convertSelectedToDates, updateRangeMap, isRangeAllowed, addToSelection, removeFromSelection, toggleSelection, handleRangeSelection, type TDateRangeMap, type ISelectionState, type ISelectionOptions, } from './selection-manager';
+export { KEY_DIRECTION_MAP, shouldIgnoreKeyboardEvent, findNextSelectableDate, getKeyDirection, } from './keyboard-navigation';

package/dist/shared-utils/calendar/keyboard-navigation.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Keyboard navigation helpers for calendar component
+ */
+export declare const KEY_DIRECTION_MAP: Record<string, number>;
+/**
+ * Check if a keyboard event should be ignored
+ */
+export declare function shouldIgnoreKeyboardEvent(target: HTMLElement): boolean;
+/**
+ * Find the next selectable date in a given direction
+ */
+export declare function findNextSelectableDate(startDate: Date, direction: number, querySelector: (selector: string) => Element | null): Date | null;
+/**
+ * Get the direction for a keyboard event
+ */
+export declare function getKeyDirection(key: string): number | null;

package/dist/shared-utils/calendar/selection-manager.d.ts

@@ -0,0 +1,30 @@
+import type { TDateRangeMap, ISelectionOptions } from '../../shared-types/calendar';
+export type { TDateRangeMap, ISelectionState, ISelectionOptions } from '../../shared-types/calendar';
+/**
+ * Convert selected string array to Date array
+ */
+export declare function convertSelectedToDates(selected: string | string[]): Date[];
+/**
+ * Update the range map for visualizing date ranges
+ */
+export declare function updateRangeMap(start: Date, end: Date): TDateRangeMap;
+/**
+ * Check if a range selection is allowed (no excluded dates in between)
+ */
+export declare function isRangeAllowed(date: Date, selectedDates: Date[], excludedates: Date[], excludeweekdays: string[]): boolean;
+/**
+ * Add a date to the selection
+ */
+export declare function addToSelection(selectedDate: Date, currentSelected: string[]): string[];
+/**
+ * Remove a date from the selection
+ */
+export declare function removeFromSelection(selectedDate: Date, currentSelected: string[]): string[];
+/**
+ * Toggle a date in the selection
+ */
+export declare function toggleSelection(selectedDate: Date, currentSelected: string[], maxMultiple: number): string[];
+/**
+ * Handle range selection logic
+ */
+export declare function handleRangeSelection(selectedDate: Date, currentSelected: string[], options: Pick<ISelectionOptions, 'excludedates' | 'excludeweekdays'>): string[];

package/dist/shared-utils/combobox/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared combobox utilities for use by both Elements and React packages.
+ */
+export { findOptionByValue, findOptionIndex, filterOptionsBySearch, buildFulltext, isMaxSelectionReached, getOptionDisplayText, parseValueToArray, findTypeaheadMatches, getSearchInfoMessage, } from './option-utils';
+export { selectOption, deselectOption, selectAllOptions, clearAllSelections, createUserOption, toggleSelection, } from './selection-manager';
+export type { IToggleSelectionConfig, IToggleSelectionResult } from './selection-manager';
+export { isLetterOrSpace, createTypeaheadHandler, findTypeaheadOptionMatch } from './typeahead';
+export { getInputKeyAction, isArrowToggleKey, getInputValueAction, checkForMatches, getSingleValueForInput, } from './input-utils';
+export type { TInputKeyAction, TFocusOutAction, IFocusOutResult, ICheckForMatchesResult, } from './input-utils';
+export { focusAndScrollIntoView, getOptionElements, focusNextOption, focusPreviousOption, focusFirstOption, focusLastOption, focusFirstOrSelectedOption, } from './keyboard-navigation';

package/dist/shared-utils/combobox/input-utils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared combobox input utility functions used by both Elements and React packages.
+ * Covers keyboard actions, focus-out validation, match checking, and input display.
+ */
+import type { IPktComboboxOption } from '../../shared-types/combobox';
+export type TInputKeyAction = 'addValue' | 'focusListbox' | 'closeOptions' | null;
+/**
+ * Determines the action for a keydown event on the combobox input.
+ */
+export declare const getInputKeyAction: (key: string, shiftKey: boolean, multiple: boolean) => TInputKeyAction;
+/**
+ * Determines if a key is an arrow/toggle key for select-only mode.
+ */
+export declare const isArrowToggleKey: (key: string) => boolean;
+export type TFocusOutAction = 'addUserValue' | 'selectOption' | 'removeValue' | 'none';
+export interface IFocusOutResult {
+    action: TFocusOutAction;
+    value: string | null;
+}
+/**
+ * Determines what to do with the input value when focus leaves the combobox.
+ */
+export declare const getInputValueAction: (inputValue: string, currentValues: string[], options: IPktComboboxOption[], allowUserInput: boolean, multiple: boolean) => IFocusOutResult;
+export interface ICheckForMatchesResult {
+    addValueText: string | null;
+    userInfoMessage: string;
+    shouldRemoveValue: boolean;
+    shouldResetInput: boolean;
+}
+/**
+ * Determines the info message and actions based on search input.
+ * Wraps getSearchInfoMessage, adding the empty-input case.
+ */
+export declare const checkForMatches: (inputValue: string, currentValues: string[], options: IPktComboboxOption[], allowUserInput: boolean, multiple: boolean) => ICheckForMatchesResult;
+/**
+ * Determines what text to display in a single-select input for the given value.
+ */
+export declare const getSingleValueForInput: (value: string, options: IPktComboboxOption[], displayValueAs: string) => string;

package/dist/shared-utils/combobox/keyboard-navigation.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Shared combobox keyboard navigation utility functions
+ * used by both Elements and React packages.
+ * Only framework-agnostic functions belong here.
+ */
+/**
+ * Scrolls an element into view and focuses it.
+ */
+export declare const focusAndScrollIntoView: (element: HTMLElement) => void;
+/**
+ * Gets all selectable option elements from a container.
+ */
+export declare const getOptionElements: (container: HTMLElement) => HTMLElement[];
+/**
+ * Focuses the next sibling option.
+ */
+export declare const focusNextOption: (currentTarget: HTMLElement) => void;
+/**
+ * Focuses the previous sibling option.
+ * Falls back to search input if at first option and search is present.
+ */
+export declare const focusPreviousOption: (currentTarget: HTMLElement, container: HTMLElement, includeSearch: boolean) => void;
+/**
+ * Focuses the first option in the list.
+ */
+export declare const focusFirstOption: (container: HTMLElement) => void;
+/**
+ * Focuses the last option in the list.
+ */
+export declare const focusLastOption: (container: HTMLElement) => void;
+/**
+ * Focuses the first selected option, or falls back to search/new-option/first option.
+ */
+export declare const focusFirstOrSelectedOption: (container: HTMLElement, config: {
+    disabled: boolean;
+    allowUserInput: boolean;
+    customUserInput: string | null;
+    includeSearch: boolean;
+}) => void;