@povio/ui 2.2.9-rc.14 → 2.2.9-rc.16

package/dist/components/inputs/Selection/Select/Select.js

@@ -1,9 +1,13 @@
+import { ArrowDropDownIcon } from "../../../../assets/icons/ArrowDropDown.js";
+import { UIConfig } from "../../../../config/uiConfig.context.js";
+import { StaticInput } from "../../shared/StaticInput.js";
 import { SelectBase } from "../shared/SelectBase.js";
-import { jsx } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { isValidElement, useEffect, useRef, useState } from "react";
 import { mergeRefs } from "@react-aria/utils";
-import { Controller } from "react-hook-form";
+import { Controller, useWatch } from "react-hook-form";
 //#region src/components/inputs/Selection/Select/Select.tsx
-function Select(props) {
+function _Select(props) {
 	if ("formControl" in props && props.formControl) {
 		const { formControl, ref, ...innerProps } = props;
 		return /* @__PURE__ */ jsx(Controller, {
@@ -23,5 +27,63 @@ function Select(props) {
 	}
 	return /* @__PURE__ */ jsx(SelectBase, { ...props });
 }
+function Select({ renderStaticInput, ...props }) {
+	const ui = UIConfig.useConfig();
+	const [renderInput, setRenderInput] = useState(!(renderStaticInput ?? ui.renderStaticInput));
+	const [shouldFocus, setShouldFocus] = useState(false);
+	const rootRef = useRef(null);
+	const currentValue = ("formControl" in props && props.formControl ? useWatch({
+		control: props.formControl.control,
+		name: props.formControl.name
+	}) : props.value) ?? props.value;
+	let isFormControlDisabled = false;
+	if ("formControl" in props && props.formControl) isFormControlDisabled = !!props.formControl.control._options?.disabled;
+	if (!renderInput && props.selectionMode !== "multiple" && !!props.showSelectionContent && currentValue != null) setRenderInput(true);
+	if (!renderInput && !!props.customTrigger) setRenderInput(true);
+	useEffect(() => {
+		if (!renderInput || !shouldFocus) return;
+		requestAnimationFrame(() => {
+			(rootRef.current?.querySelector("[data-type='select-trigger'], input, button, [tabindex]"))?.focus();
+		});
+		setShouldFocus(false);
+	}, [renderInput, shouldFocus]);
+	if (!renderInput) {
+		const getItemLabel = (id) => {
+			const item = props.items.find((innerItem) => innerItem.id === id);
+			if (!item) return "";
+			if (props.showSelectionContent && item.content) return isValidElement(item.content) ? item.label : item.content;
+			return item.label;
+		};
+		const mode = props.selectionMode ?? ui.select.selectionMode;
+		let displayValue = "";
+		if (mode === "multiple") {
+			if (Array.isArray(currentValue) && currentValue.length > 0) displayValue = /* @__PURE__ */ jsx(Fragment, { children: currentValue.map((id) => getItemLabel(id)).filter(Boolean).map((item, index) => /* @__PURE__ */ jsxs("span", { children: [item, index < currentValue.length - 1 && ","] }, `${index}`)) });
+		} else if (currentValue != null) displayValue = getItemLabel(currentValue);
+		const as = props.as ?? ui.input.as;
+		let isDisabled = !!props.isDisabled;
+		if (isFormControlDisabled) isDisabled = true;
+		return /* @__PURE__ */ jsx(StaticInput, {
+			...props,
+			onInteract: (focus) => {
+				setShouldFocus(focus);
+				setRenderInput(true);
+			},
+			as,
+			size: props.size ?? ui.input.size,
+			variant: props.variant ?? ui.input.variant,
+			isHeaderHidden: props.isHeaderHidden || as === "inline",
+			hideLabel: props.hideLabel ?? ui.input.hideLabel,
+			isDisabled,
+			placeholder: as === "floating" ? "" : props.placeholder,
+			displayValue,
+			isEmpty: !displayValue,
+			trailingVisual: /* @__PURE__ */ jsx(ArrowDropDownIcon, { className: "size-6 shrink-0 text-interactive-text-secondary-idle" })
+		});
+	}
+	return /* @__PURE__ */ jsx(_Select, {
+		...props,
+		ref: mergeRefs(props.ref, rootRef)
+	});
+}
 //#endregion
 export { Select };

package/dist/components/inputs/Selection/shared/SelectInput.js

@@ -4,7 +4,7 @@ import { Typography } from "../../../text/Typography/Typography.js";
 import "../../../../config/i18n.js";
 import { FormFieldLabel } from "../../FormField/FormFieldLabel.js";
 import { InputClear } from "../../shared/InputClear.js";
-import { inputBase, inputSize } from "../../shared/input.cva.js";
+import { inputBase, inputClearClass, inputSize } from "../../shared/input.cva.js";
 import { SelectInputTags } from "./SelectInputTags.js";
 import { SelectContext } from "./select.context.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -17,6 +17,7 @@ import { useTranslation } from "react-i18next";
 var SelectInput = ({ ref, placeholder, variant, as, size, isDisabled, isInvalid, className, hideDropdownIcon, isSearchable, isClearable, showSelectionContent, inputClassName, fieldProps, headerProps, selectedTagsType, collapseAfter, isRequired, isDirty, onCloseComboBox, onBlur, fireBlurOnChange, leadingContent, trailingContent, onMouseEnter, onFocusCapture, ...props }) => {
 	const inputSizeCva = UIStyle.useCva("input.sizeCva", inputSize);
 	const inputBaseCva = UIStyle.useCva("input.baseCva", inputBase);
+	const inputClearClassCva = UIStyle.useCva("input.clearClassCva", inputClearClass);
 	const { t } = useTranslation("ui");
 	const state = use(ComboBoxStateContext);
 	const { hoverProps, isHovered } = useHover({ isDisabled });
@@ -137,17 +138,18 @@ var SelectInput = ({ ref, placeholder, variant, as, size, isDisabled, isInvalid,
 					})
 				]
 			}),
-			trailingContent && /* @__PURE__ */ jsx("div", {
-				className: "flex shrink-0 items-center",
-				children: trailingContent
-			}),
 			isClearable && /* @__PURE__ */ jsx(InputClear, {
 				onClear: () => {
 					onClear();
 					if (fireBlurOnChange) onBlur?.({});
 				},
+				className: inputClearClassCva({ as }),
 				show: showClearButton
 			}),
+			trailingContent && /* @__PURE__ */ jsx("div", {
+				className: "flex shrink-0 items-center",
+				children: trailingContent
+			}),
 			!hideDropdownIcon && /* @__PURE__ */ jsx(Button, {
 				excludeFromTabOrder: true,
 				"aria-label": t(($) => isOpen ? $.ui.closeAlt : $.ui.openAlt),

package/dist/components/inputs/shared/StaticInput.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { FormFieldProps } from '../FormField/FormField';
+import { TextInputProps } from '../Input/TextInput/TextInput';
+import { InputSizeProps, InputVariantProps } from './input.cva';
+interface StaticInputProps extends FormFieldProps {
+    onInteract: (shouldFocus: boolean) => void;
+    as?: TextInputProps["as"];
+    size?: InputSizeProps["size"];
+    variant?: InputVariantProps["variant"];
+    applyMinInputWidth?: boolean;
+    placeholder?: ReactNode;
+    displayValue?: ReactNode;
+    isEmpty?: boolean;
+    leadingVisual?: ReactNode;
+    trailingVisual?: ReactNode;
+    inputClassName?: string;
+}
+export declare const StaticInput: ({ onInteract, as, size, variant, applyMinInputWidth, placeholder, displayValue, isEmpty, leadingVisual, trailingVisual, inputClassName, className, ...formFieldProps }: StaticInputProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/inputs/shared/StaticInput.js

@@ -0,0 +1,69 @@
+import { UIStyle } from "../../../config/uiStyle.context.js";
+import { FormFieldLabel } from "../FormField/FormFieldLabel.js";
+import { inputBase, inputSize } from "./input.cva.js";
+import { FormField } from "../FormField/FormField.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { clsx } from "clsx";
+//#region src/components/inputs/shared/StaticInput.tsx
+var StaticInput = ({ onInteract, as, size, variant, applyMinInputWidth, placeholder, displayValue, isEmpty, leadingVisual, trailingVisual, inputClassName, className, ...formFieldProps }) => {
+	const inputBaseCva = UIStyle.useCva("input.baseCva", inputBase);
+	const inputSizeCva = UIStyle.useCva("input.sizeCva", inputSize);
+	let hasValue = !!displayValue;
+	if (isEmpty != null) hasValue = !isEmpty;
+	let staticDisplayContent = placeholder;
+	if (hasValue) staticDisplayContent = displayValue;
+	else if (as === "floating") staticDisplayContent = null;
+	const shouldRenderFloatingLineSpacer = as === "floating" && !hasValue;
+	return /* @__PURE__ */ jsx(FormField, {
+		...formFieldProps,
+		as,
+		className,
+		onMouseEnter: () => onInteract(false),
+		tabIndex: as === "inline" ? -1 : void 0,
+		children: /* @__PURE__ */ jsxs("div", {
+			tabIndex: formFieldProps.isDisabled ? -1 : 0,
+			onFocus: () => onInteract(true),
+			onClick: () => onInteract(true),
+			onPointerDown: () => onInteract(true),
+			"data-is-empty": !hasValue || void 0,
+			"data-disabled": formFieldProps.isDisabled || void 0,
+			"data-is-disabled": formFieldProps.isDisabled || void 0,
+			"data-has-selection": hasValue || void 0,
+			"data-rac": "",
+			className: clsx("group/static-input group/input-content group/select-content relative flex items-center justify-between gap-input-gap-input-text-to-elements", applyMinInputWidth && "min-w-input-width-min-width", inputBaseCva({
+				as,
+				variant
+			}), inputClassName),
+			children: [/* @__PURE__ */ jsxs("div", {
+				className: clsx(inputSizeCva({
+					size,
+					as
+				}), "flex w-full items-center gap-input-gap-input-text-to-elements pr-0!"),
+				children: [leadingVisual && /* @__PURE__ */ jsx("div", {
+					className: "pointer-events-none shrink-0",
+					children: leadingVisual
+				}), /* @__PURE__ */ jsxs("div", {
+					className: clsx("flex w-full truncate", as === "floating" && "flex-col", as === "filter" && "gap-input-gap-input-text-to-elements"),
+					children: [as && ["filter", "floating"].includes(as) && /* @__PURE__ */ jsx(FormFieldLabel, {
+						as,
+						size,
+						label: formFieldProps.label,
+						isRequired: formFieldProps.isRequired,
+						isDisabled: formFieldProps.isDisabled
+					}), /* @__PURE__ */ jsxs("div", {
+						className: clsx("truncate", !hasValue && "text-text-default-3"),
+						children: [staticDisplayContent, shouldRenderFloatingLineSpacer && /* @__PURE__ */ jsx(Fragment, { children: "\xA0" })]
+					})]
+				})]
+			}), trailingVisual && /* @__PURE__ */ jsx("div", {
+				className: clsx(inputSizeCva({
+					size,
+					as
+				}), "pointer-events-none flex items-center gap-input-gap-trailing-elements py-0! pl-0!"),
+				children: trailingVisual
+			})]
+		})
+	});
+};
+//#endregion
+export { StaticInput };

package/dist/components/inputs/shared/TooltipWrapper.js

@@ -1,7 +1,10 @@
+import { UIStyle } from "../../../config/uiStyle.context.js";
 import { Tooltip } from "../../overlays/Tooltip/Tooltip.js";
+import { tooltipWrapperTrigger } from "./tooltipWrapper.cva.js";
 import { jsx } from "react/jsx-runtime";
 //#region src/components/inputs/shared/TooltipWrapper.tsx
 var TooltipWrapper = (props) => {
+	const tooltipWrapperTriggerCva = UIStyle.useCva("tooltipWrapper.triggerCva", tooltipWrapperTrigger);
 	if (props.as !== "inline") return props.children;
 	return /* @__PURE__ */ jsx(Tooltip, {
 		text: props.error || void 0,
@@ -9,10 +12,11 @@ var TooltipWrapper = (props) => {
 		color: "error",
 		hidden: !props.error,
 		isNonInteractiveTrigger: true,
-		triggerClassName: props.triggerClassName,
+		triggerClassName: tooltipWrapperTriggerCva({ className: props.triggerClassName }),
 		triggerTabIndex: props.triggerTabIndex,
 		children: /* @__PURE__ */ jsx("div", {
 			tabIndex: -1,
+			className: tooltipWrapperTriggerCva({}),
 			children: props.children
 		})
 	});

package/dist/components/inputs/shared/input.cva.d.ts

@@ -12,6 +12,11 @@ export declare const inputSize: (props?: ({
 } & ClassProp) | undefined) => string;
 export interface InputSizeProps extends VariantProps<typeof inputSize> {
 }
+export declare const inputClearClass: (props?: ({
+    as?: "filter" | "default" | "floating" | "inline" | null | undefined;
+} & ClassProp) | undefined) => string;
+export interface InputClearClassProps extends VariantProps<typeof inputClearClass> {
+}
 export declare const inputSide: (props?: ({
     size?: "small" | "default" | "extra-small" | "large" | null | undefined;
     type?: "left" | "right" | "var" | null | undefined;

package/dist/components/inputs/shared/input.cva.js

@@ -191,6 +191,15 @@ var inputSize = cva("", {
 		as: "default"
 	}
 });
+var inputClearClass = cva("", {
+	variants: { as: {
+		default: "",
+		floating: "",
+		filter: "",
+		inline: ""
+	} },
+	defaultVariants: { as: "default" }
+});
 var inputSide = cva("", {
 	variants: {
 		size: {
@@ -277,4 +286,4 @@ var useInputCva = () => {
 	};
 };
 //#endregion
-export { inputBase, inputSide, inputSize, useInputCva };
+export { inputBase, inputClearClass, inputSide, inputSize, useInputCva };

package/dist/components/inputs/shared/tooltipWrapper.cva.d.ts

@@ -0,0 +1,4 @@
+import { VariantProps } from 'class-variance-authority';
+export declare const tooltipWrapperTrigger: (props?: import('class-variance-authority/types').ClassProp | undefined) => string;
+export interface TooltipWrapperTriggerVariantProps extends VariantProps<typeof tooltipWrapperTrigger> {
+}

package/dist/components/inputs/shared/tooltipWrapper.cva.js

@@ -0,0 +1,5 @@
+import { cva } from "class-variance-authority";
+//#region src/components/inputs/shared/tooltipWrapper.cva.ts
+var tooltipWrapperTrigger = cva("inline-flex");
+//#endregion
+export { tooltipWrapperTrigger };

package/dist/config/uiConfig.context.d.ts

@@ -1,4 +1,4 @@
-import { PropsWithChildren } from 'react';
+import { PropsWithChildren, ReactElement } from 'react';
 import { ButtonProps } from '../components/buttons/Button/Button';
 import { CheckboxProps } from '../components/inputs/Checkbox/Checkbox';
 import { DatePickerProps } from '../components/inputs/DateTime/DatePicker/DatePicker';
@@ -19,6 +19,7 @@ export declare namespace UIConfig {
         [P in keyof T]-?: T[P] extends object ? DeepRequired<T[P]> : Exclude<T[P], null | undefined>;
     };
     export interface Options {
+        renderStaticInput: boolean;
         input: Pick<TextInputProps, "variant" | "isClearable" | "hideLabel" | "as" | "size">;
         button: Pick<ButtonProps, "variant" | "size">;
         numberInput: Pick<NumberInputProps, "formatOptions">;
@@ -34,6 +35,8 @@ export declare namespace UIConfig {
         toggle: Pick<ToggleProps, "variant">;
         slider: Pick<SliderProps, "minValue" | "maxValue">;
         dateInput: Pick<DatePickerProps, "todayIcon" | "todayIconButtonSize" | "shouldForceLeadingZeros" | "disableManualEntry" | "autoFixYear"> & {
+            calendarIcon?: ReactElement;
+            dateTimeIcon?: ReactElement;
             setDateValueOnDateSelection?: boolean;
         };
         actionModal: Pick<ActionModalProps, "titleTypography" | "descriptionTypography">;

package/dist/config/uiConfig.context.js

@@ -1,3 +1,5 @@
+import { CalendarIcon } from "../assets/icons/Calendar.js";
+import { DateTimeIcon } from "../assets/icons/DateTime.js";
 import { ObjectUtils } from "../utils/object.utils.js";
 import { useDeepCompareMemo } from "../hooks/useDeepCompare.js";
 import { jsx } from "react/jsx-runtime";
@@ -6,6 +8,7 @@ import { createContext, use } from "react";
 var UIConfig;
 (function(_UIConfig) {
 	const DEFAULT_CONFIG = {
+		renderStaticInput: true,
 		input: {
 			variant: "outlined",
 			as: "default",
@@ -47,6 +50,8 @@ var UIConfig;
 			shouldForceLeadingZeros: false,
 			disableManualEntry: false,
 			autoFixYear: false,
+			calendarIcon: /* @__PURE__ */ jsx(CalendarIcon, { className: "size-5" }),
+			dateTimeIcon: /* @__PURE__ */ jsx(DateTimeIcon, { className: "size-5" }),
 			setDateValueOnDateSelection: false
 		},
 		actionModal: {

package/dist/config/uiStyle.context.d.ts

@@ -11,8 +11,9 @@ import { FormFieldHelperVariantProps } from '../components/inputs/FormField/form
 import { RadioVariantProps } from '../components/inputs/RadioGroup/radio.cva';
 import { SelectPopoverCva } from '../components/inputs/Selection/shared/selectDesktop.cva';
 import { SelectListBoxItemCva } from '../components/inputs/Selection/shared/selectItem.cva';
-import { InputBaseProps, InputSideProps, InputSizeProps } from '../components/inputs/shared/input.cva';
+import { InputBaseProps, InputClearClassProps, InputSideProps, InputSizeProps } from '../components/inputs/shared/input.cva';
 import { LabelBaseProps } from '../components/inputs/shared/label.cva';
+import { TooltipWrapperTriggerVariantProps } from '../components/inputs/shared/tooltipWrapper.cva';
 import { ToggleVariantProps } from '../components/inputs/Toggle/toggle.cva';
 import { MenuCvaVariantProps, MenuItemVariantProps, MenuPopoverVariantProps, MenuPopoverWrapperVariantProps } from '../components/Menu/menu.cva';
 import { AccordionChevronVariantProps, AccordionHeadingSubtitleVariantProps, AccordionHeadingTitleVariantProps, AccordionHeadingVariantProps, AccordionIconVariantProps, AccordionItemVariantProps, AccordionPanelContentVariantProps, AccordionPanelVariantProps, AccordionTriggerVariantProps, AccordionVariantProps } from '../components/navigation/Accordion/accordion.cva';
@@ -69,9 +70,13 @@ export declare namespace UIStyle {
         };
         input: {
             baseCva?: Cva<InputBaseProps>;
+            clearClassCva?: Cva<InputClearClassProps>;
             sizeCva?: Cva<InputSizeProps>;
             sideCva?: Cva<InputSideProps>;
         };
+        tooltipWrapper: {
+            triggerCva?: Cva<TooltipWrapperTriggerVariantProps>;
+        };
         datePickerInput: {
             contentRowCva?: Cva<DatePickerInputContentRowProps>;
         };

package/dist/hooks/useQueryAutocomplete.d.ts

@@ -1,26 +1,14 @@
-import { UseInfiniteQueryResult, UseQueryResult } from '@tanstack/react-query';
+import { InfiniteData } from '@tanstack/react-query';
 import { Key } from 'react-aria-components';
-import { SelectItem } from '../components/inputs/Selection/shared/select.types';
-type QueryResult<TData = any> = UseQueryResult<TData> | UseInfiniteQueryResult<TData>;
-type QueryFn<TData = any> = (...args: any[]) => QueryResult<TData>;
-type QueryDataType<TQueryFn extends QueryFn> = Exclude<ReturnType<TQueryFn>["data"], undefined>;
-interface UseQueryAutocompleteOptions<TQueryFn extends QueryFn, TKey extends Key = Key> {
-    query: TQueryFn;
-    queryParams?: Parameters<TQueryFn>[0];
-    queryOptions?: Parameters<TQueryFn>[1];
-    mapItems: (data: QueryDataType<TQueryFn>) => SelectItem<TKey>[];
-    initialQueryState?: boolean;
-    search?: string;
-}
+import { InfiniteQueryPage, QueryFn, UseQueryAutocompleteOptions } from '../components/inputs/Selection/Autocomplete/queryAutocomplete.types';
 export declare const useQueryAutocomplete: <TQueryFn extends QueryFn, TKey extends Key = Key>({ query, queryParams, queryOptions, mapItems, initialQueryState, search, }: UseQueryAutocompleteOptions<TQueryFn, TKey>) => {
     data: any;
     isLoading: boolean;
     isQueryEnabled: boolean;
     handleEnableQuery: () => void;
-    items: SelectItem<TKey>[];
-    totalItems: any;
+    items: import('..').SelectItem<TKey>[];
+    totalItems: number | undefined;
     hasNextPage: boolean;
-    fetchNextPage: (() => Promise<unknown>) | ((options?: import('@tanstack/react-query').FetchNextPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<any, Error>>) | undefined;
+    fetchNextPage: ((options?: import('@tanstack/react-query').FetchNextPageOptions) => Promise<import('@tanstack/react-query').InfiniteQueryObserverResult<InfiniteData<InfiniteQueryPage<TKey>, unknown>, Error>>) | undefined;
     isFetchingNextPage: boolean;
 };
-export {};

package/dist/hooks/useQueryAutocomplete.js

@@ -1,16 +1,19 @@
 import { ApiQueryUtils } from "../utils/query.utils.js";
 import { useMemo, useState } from "react";
 //#region src/hooks/useQueryAutocomplete.ts
+var isFilterSearchParams = (params) => {
+	return typeof params === "object" && params !== null && "filter" in params;
+};
 var useQueryAutocomplete = ({ query, queryParams, queryOptions, mapItems, initialQueryState, search }) => {
 	const [isQueryEnabled, setIsQueryEnabled] = useState(!initialQueryState);
 	const queryResult = query(search === void 0 ? queryParams : {
 		...queryParams,
 		limit: queryParams?.limit ?? ApiQueryUtils.DEFAULT_LIMIT,
 		search,
-		filter: queryParams && "filter" in queryParams ? {
+		...isFilterSearchParams(queryParams) ? { filter: {
 			...queryParams.filter,
 			search
-		} : void 0
+		} } : {}
 	}, {
 		...queryOptions,
 		enabled: isQueryEnabled && (queryOptions?.enabled ?? true)
@@ -20,11 +23,10 @@ var useQueryAutocomplete = ({ query, queryParams, queryOptions, mapItems, initia
 	const isInfiniteQueryResult = (result) => {
 		return "hasNextPage" in result && "fetchNextPage" in result;
 	};
-	const isInfiniteQuery = isInfiniteQueryResult(queryResult);
 	const handleEnableQuery = () => {
 		setIsQueryEnabled(true);
 	};
-	const infiniteQueryResult = isInfiniteQuery ? queryResult : void 0;
+	const infiniteQueryResult = isInfiniteQueryResult(queryResult) ? queryResult : void 0;
 	const hasNextPage = infiniteQueryResult?.hasNextPage ?? false;
 	const fetchNextPage = infiniteQueryResult?.fetchNextPage;
 	const isFetchingNextPage = infiniteQueryResult?.isFetchingNextPage ?? false;

package/dist/index.d.ts

@@ -103,6 +103,7 @@ export { Select } from './components/inputs/Selection/Select/Select';
 export type { ControlledSliderProps, SliderProps } from './components/inputs/Slider/Slider';
 export { Slider } from './components/inputs/Slider/Slider';
 export type { InputVariantProps } from './components/inputs/shared/input.cva';
+export type { TooltipWrapperTriggerVariantProps } from './components/inputs/shared/tooltipWrapper.cva';
 export type { ControlledToggleProps, ToggleProps } from './components/inputs/Toggle/Toggle';
 export { Toggle } from './components/inputs/Toggle/Toggle';
 export type { MenuProps } from './components/Menu/Menu';

package/dist/utils/date-time.utils.d.ts

@@ -1,5 +1,15 @@
 import { CalendarDate, CalendarDateTime, DateValue, ZonedDateTime } from '@internationalized/date';
 export declare namespace DateTimeUtils {
+    function getDatePlaceholder(locale?: string): string;
+    function getTimePlaceholder(locale?: string): string;
+    function getDateTimePlaceholder(locale?: string): string;
+    function getDateRangePlaceholder(locale?: string): string;
+    function formatCalendarDateLocalized(calendarDate: CalendarDate, locale?: string): string;
+    function formatTimeLocalized(timeValue: {
+        hour: number;
+        minute: number;
+    }, locale?: string): string;
+    function formatCalendarDateTimeLocalized(calendarDateTime: Pick<CalendarDateTime, "day" | "month" | "year" | "hour" | "minute">, locale?: string): string;
     function fromISOtoZonedDateTime(isoString: string): ZonedDateTime;
     function fromDateValueToISO(dateValue: DateValue): string;
     function fromLocalToZonedDateTime(date: Date): ZonedDateTime;

package/dist/utils/date-time.utils.js

@@ -1,7 +1,88 @@
-import { CalendarDate, CalendarDateTime, fromDate, getLocalTimeZone, parseAbsolute, parseAbsoluteToLocal } from "@internationalized/date";
+import { CalendarDate, CalendarDateTime, DateFormatter, fromDate, getLocalTimeZone, parseAbsolute, parseAbsoluteToLocal } from "@internationalized/date";
 //#region src/utils/date-time.utils.ts
 var DateTimeUtils;
 (function(_DateTimeUtils) {
+	const DATE_SAMPLE_DATE_UTC = new Date(Date.UTC(2e3, 10, 22));
+	const TIME_SAMPLE_DATE_UTC = new Date(Date.UTC(2e3, 10, 22, 13, 45));
+	const getDatePlaceholderFormatter = (locale) => new Intl.DateTimeFormat(locale, {
+		day: "2-digit",
+		month: "2-digit",
+		year: "numeric"
+	});
+	const getTimePlaceholderFormatter = (locale) => new Intl.DateTimeFormat(locale, {
+		hour: "2-digit",
+		minute: "2-digit",
+		hourCycle: "h23"
+	});
+	const getResolvedLocale = (locale) => {
+		if (locale) return locale;
+		return new Intl.DateTimeFormat().resolvedOptions().locale;
+	};
+	const getDateFormatter = (locale) => new DateFormatter(getResolvedLocale(locale), {
+		day: "2-digit",
+		month: "2-digit",
+		year: "numeric",
+		timeZone: "UTC"
+	});
+	const getTimeFormatter = (locale) => new DateFormatter(getResolvedLocale(locale), {
+		hour: "2-digit",
+		minute: "2-digit",
+		hourCycle: "h23",
+		timeZone: "UTC"
+	});
+	const getDateTimeFormatter = (locale) => new DateFormatter(getResolvedLocale(locale), {
+		day: "2-digit",
+		month: "2-digit",
+		year: "numeric",
+		hour: "2-digit",
+		minute: "2-digit",
+		hourCycle: "h23",
+		timeZone: "UTC"
+	});
+	const mapTypeToPlaceholder = (type) => {
+		switch (type) {
+			case "day": return "dd";
+			case "month": return "mm";
+			case "year": return "yyyy";
+			case "hour": return "hh";
+			case "minute": return "mm";
+			default: return null;
+		}
+	};
+	const formatPlaceholder = (formatter, sampleDate) => {
+		return formatter.formatToParts(sampleDate).map((part) => mapTypeToPlaceholder(part.type) ?? part.value).join("");
+	};
+	function getDatePlaceholder(locale) {
+		return formatPlaceholder(getDatePlaceholderFormatter(locale), DATE_SAMPLE_DATE_UTC);
+	}
+	_DateTimeUtils.getDatePlaceholder = getDatePlaceholder;
+	function getTimePlaceholder(locale) {
+		return formatPlaceholder(getTimePlaceholderFormatter(locale), TIME_SAMPLE_DATE_UTC);
+	}
+	_DateTimeUtils.getTimePlaceholder = getTimePlaceholder;
+	function getDateTimePlaceholder(locale) {
+		return `${getDatePlaceholder(locale)}, ${getTimePlaceholder(locale)}`;
+	}
+	_DateTimeUtils.getDateTimePlaceholder = getDateTimePlaceholder;
+	function getDateRangePlaceholder(locale) {
+		const datePlaceholder = getDatePlaceholder(locale);
+		return `${datePlaceholder} – ${datePlaceholder}`;
+	}
+	_DateTimeUtils.getDateRangePlaceholder = getDateRangePlaceholder;
+	function formatCalendarDateLocalized(calendarDate, locale) {
+		return getDateFormatter(locale).format(calendarDate.toDate("UTC"));
+	}
+	_DateTimeUtils.formatCalendarDateLocalized = formatCalendarDateLocalized;
+	function formatTimeLocalized(timeValue, locale) {
+		const dateTime = new CalendarDateTime(2e3, 11, 22, timeValue.hour, timeValue.minute);
+		return getTimeFormatter(locale).format(dateTime.toDate("UTC"));
+	}
+	_DateTimeUtils.formatTimeLocalized = formatTimeLocalized;
+	function formatCalendarDateTimeLocalized(calendarDateTime, locale) {
+		const normalizedValue = new CalendarDateTime(calendarDateTime.year, calendarDateTime.month, calendarDateTime.day, calendarDateTime.hour, calendarDateTime.minute);
+		return getDateTimeFormatter(locale).format(normalizedValue.toDate("UTC"));
+	}
+	_DateTimeUtils.formatCalendarDateTimeLocalized = formatCalendarDateTimeLocalized;
 	function fromISOtoZonedDateTime(isoString) {
 		return parseAbsoluteToLocal(isoString);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@povio/ui",
-  "version": "2.2.9-rc.14",
+  "version": "2.2.9-rc.16",
   "type": "module",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",