@fundamental-ngx/core 0.63.0-rc.2 → 0.63.0-rc.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fundamental-ngx/core",
-  "version": "0.63.0-rc.2",
+  "version": "0.63.0-rc.21",
   "schematics": "./schematics/collection.json",
   "ng-update": {
     "migrations": "./schematics/migrations.json"
@@ -22,10 +22,10 @@
     "@angular/forms": "^21.0.0",
     "@angular/platform-browser": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@fundamental-ngx/cdk": "0.63.0-rc.2",
-    "@fundamental-ngx/i18n": "0.63.0-rc.2",
+    "@fundamental-ngx/cdk": "0.63.0-rc.21",
+    "@fundamental-ngx/i18n": "0.63.0-rc.21",
     "@sap-theming/theming-base-content": "^11.35.0",
-    "fundamental-styles": "0.41.6",
+    "fundamental-styles": "0.41.7",
     "rxjs": "^7.8.0"
   },
   "dependencies": {

package/types/fundamental-ngx-core-calendar.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { OnInit, OnChanges, EventEmitter, ElementRef, ChangeDetectorRef, SimpleChanges, OnDestroy } from '@angular/core';
+import { OnInit, OnChanges, EventEmitter, ElementRef, ChangeDetectorRef, SimpleChanges } from '@angular/core';
 import { DatetimeAdapter, DateTimeFormats } from '@fundamental-ngx/core/datetime';
 import { Subject } from 'rxjs';
 import { Nullable } from '@fundamental-ngx/cdk/utils';
@@ -243,13 +243,13 @@ declare class CalendarHeaderComponent<D> implements OnInit, OnChanges {
      * Select years range aria label id
      */
     get _selectYearsRangeButtonAriaLabelId(): string;
-    /** @hidden  */
-    private readonly _destroyRef;
     /** Month names */
     private _monthNames;
     /** Get information about amount of years displayed at once on year view  */
     private _amountOfYearsPerPeriod;
     /** @hidden */
+    private _initiated;
+    /** @hidden */
     constructor(_changeDetRef: ChangeDetectorRef, _calendarService: CalendarService, _dateTimeAdapter: DatetimeAdapter<D>);
     /** @hidden */
     ngOnChanges(changes: SimpleChanges): void;
@@ -262,8 +262,6 @@ declare class CalendarHeaderComponent<D> implements OnInit, OnChanges {
     /** @hidden */
     _processViewChange(type: FdCalendarView, event?: MouseEvent): void;
     /** @hidden */
-    private _listenToLocaleChanges;
-    /** @hidden */
     private _calculateLabels;
     /** @hidden */
     private _calculateSelectMonthLabel;
@@ -1431,7 +1429,7 @@ declare class CalendarYearViewComponent<D> implements OnInit, OnChanges, Focusab
  * ```
  *
  */
-declare class CalendarComponent<D> implements OnInit, OnChanges, ControlValueAccessor, Validator, OnDestroy {
+declare class CalendarComponent<D> implements OnInit, OnChanges, ControlValueAccessor, Validator {
     private _elementRef;
     private _changeDetectorRef;
     private _dateTimeAdapter;
@@ -1565,9 +1563,8 @@ declare class CalendarComponent<D> implements OnInit, OnChanges, ControlValueAcc
     /** @hidden */
     nextButtonDisabled: boolean;
     /** @hidden */
-    protected readonly calendarRoleDescription: _angular_core.Signal<string>;
     /** @hidden */
-    private _subscriptions;
+    protected readonly calendarRoleDescription: _angular_core.Signal<string>;
     /** @hidden */
     private _adapterStartingDayOfWeek;
     /** @hidden */
@@ -1598,8 +1595,6 @@ declare class CalendarComponent<D> implements OnInit, OnChanges, ControlValueAcc
     ngOnChanges(changes: SimpleChanges): void;
     /** @hidden */
     getWeekStartDay(): DaysOfWeek;
-    /** @hidden */
-    ngOnDestroy(): void;
     /**
      * @hidden
      * Function that provides support for ControlValueAccessor that allows to use [(ngModel)] or forms.
@@ -1694,8 +1689,6 @@ declare class CalendarComponent<D> implements OnInit, OnChanges, ControlValueAcc
     isDateRangeMonthFormat(): boolean;
     /** Whether the date range format is year */
     isDateRangeYearFormat(): boolean;
-    /** @hidden */
-    private _listenToLocaleChanges;
     /**
      * @hidden
      * Method that sets up the currently displayed variables, like shown month and year.

package/types/fundamental-ngx-core-datetime-picker.d.ts

@@ -257,8 +257,6 @@ declare class DatetimePickerComponent<D> implements DateTimePicker<D>, OnInit, O
     /** @hidden */
     private _mobileComponentRef;
     /** @hidden */
-    private _subscriptions;
-    /** @hidden */
     private _touched;
     /** @hidden */
     constructor(_elRef: ElementRef, _changeDetRef: ChangeDetectorRef, _dateTimeAdapter: DatetimeAdapter<D>, _dateTimeFormats: DateTimeFormats, _popoverFormMessage: PopoverFormMessageService);

package/types/fundamental-ngx-core-datetime.d.ts

@@ -1,9 +1,7 @@
-import { Nullable } from '@fundamental-ngx/cdk/utils';
-import { Observable } from 'rxjs';
 import * as i0 from '@angular/core';
-import { InjectionToken, PipeTransform, Provider } from '@angular/core';
+import { Signal, PipeTransform, InjectionToken, Provider } from '@angular/core';
+import { Nullable } from '@fundamental-ngx/cdk/utils';
 import * as i1 from '@angular/cdk/platform';
-import { Platform } from '@angular/cdk/platform';
 
 /**
  * Datetime Adapter is an abstract class that must be implemented by each adapter.
@@ -246,11 +244,22 @@ declare abstract class DatetimeAdapter<D> {
      */
     abstract isValid(date: Nullable<D>): date is D;
     /**
-     * Gets the RFC 3339 compatible string (https://tools.ietf.org/html/rfc3339) for the given date.
+     * Gets the ISO 8601 date-time string for the given date.
+     *
+     * Returns a **local** (timezone-unaware) string in the format `YYYY-MM-DDTHH:mm:ss`.
+     * This is intentionally **not** RFC 3339 compliant because no timezone designator is appended.
+     *
      * This method is used to generate date strings that are compatible with native HTML attributes
      * such as the `min` or `max` attribute of an `<input>`.
+     *
+     * To produce an RFC 3339 string, append a timezone designator to the result:
+     * ```ts
+     * const rfc3339Utc = adapter.toIso8601(date) + 'Z';          // UTC
+     * const rfc3339Local = adapter.toIso8601(date) + '+05:30';    // with offset
+     * ```
+     *
      * @param date The date to get the ISO date string for.
-     * @returns The ISO date string date string.
+     * @returns The ISO 8601 date-time string without timezone designator.
      */
     abstract toIso8601(date: D): string;
     /**
@@ -282,12 +291,10 @@ declare abstract class DatetimeAdapter<D> {
      * @returns String representing how much time has passed since the date param.
      */
     abstract fromNow?(date: D): string;
-    /** locale changes stream */
-    readonly localeChanges: Observable<void>;
-    /** current locale */
-    protected locale: string;
+    /** Current locale as a readonly signal. */
+    readonly locale: Signal<string>;
     /** @hidden */
-    private _localeChanges;
+    private readonly _locale;
     protected constructor();
     /**
      * Sets the locale used for all dates.
@@ -307,7 +314,7 @@ declare abstract class DatetimeAdapter<D> {
      * Get Amount of weeks in given month/year
      * @param year The year of the date
      * @param month The month of the date
-     * @param firstDayOfWeek The first day of week. 1 - Sunday, 2 - Monday...
+     * @param firstDayOfWeek The first day of week. 1 - Sunday, 2 - Monday, ..., 7 - Saturday
      * @returns Number of weeks in the given month
      */
     getAmountOfWeeks(year: number, month: number, firstDayOfWeek: number): number;
@@ -321,69 +328,40 @@ declare abstract class DatetimeAdapter<D> {
     compareDate(first: D, second: D): number;
 }
 
-/**
- * DateTimeFormats is intended to keep options
- * related to date-time formatting / parsing
- *
- */
-interface DateTimeFormats {
-    parse: {
-        dateInput: unknown;
-        timeInput: unknown;
-        dateTimeInput: unknown;
-    };
-    display: {
-        dateInput: unknown;
-        timeInput: unknown;
-        dateTimeInput: unknown;
-        dateA11yLabel: unknown;
-        monthA11yLabel: unknown;
-        yearA11yLabel: unknown;
-    };
-    rangeDelimiter: string;
-}
-/**
- * DateTimeFormats injection token
- */
-declare const DATE_TIME_FORMATS: InjectionToken<DateTimeFormats>;
-
 declare class DateFormatPipe<D> implements PipeTransform {
-    private _dateTimeAdapter;
-    private _dateTimeFormats;
     /** @hidden */
-    constructor(_dateTimeAdapter: DatetimeAdapter<D>, _dateTimeFormats: DateTimeFormats);
+    private readonly _dateTimeAdapter;
+    /** @hidden */
+    private readonly _dateTimeFormats;
     /** Format date object */
     transform(date: D, noDateMessage?: string): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DateFormatPipe<any>, [null, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DateFormatPipe<any>, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<DateFormatPipe<any>, "dateFormat", true>;
 }
 declare class DateTimeFormatPipe<D> implements PipeTransform {
-    private _dateTimeAdapter;
-    private _dateTimeFormats;
     /** @hidden */
-    constructor(_dateTimeAdapter: DatetimeAdapter<D>, _dateTimeFormats: DateTimeFormats);
+    private readonly _dateTimeAdapter;
+    /** @hidden */
+    private readonly _dateTimeFormats;
     /** Format date object */
     transform(date: D, noDateMessage?: string): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DateTimeFormatPipe<any>, [null, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DateTimeFormatPipe<any>, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<DateTimeFormatPipe<any>, "dateTimeFormat", true>;
 }
 declare class DateFromNowPipe<D> implements PipeTransform {
-    private _dateTimeAdapter;
     /** @hidden */
-    constructor(_dateTimeAdapter: DatetimeAdapter<D>);
+    private readonly _dateTimeAdapter;
     /** Format date object */
     transform(date: D, noDateMessage?: string): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<DateFromNowPipe<any>, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<DateFromNowPipe<any>, "dateFromNow", true>;
 }
 declare class DayPeriodFormatPipe<D> implements PipeTransform {
-    private _dateTimeAdapter;
-    private _dateTimeFormats;
     /** @hidden */
-    constructor(_dateTimeAdapter: DatetimeAdapter<D>, _dateTimeFormats: DateTimeFormats);
+    private readonly _dateTimeAdapter;
     /** Format date object for day period */
     transform(date: D, customFormat?: any, noDateMessage?: string): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DayPeriodFormatPipe<any>, [null, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DayPeriodFormatPipe<any>, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<DayPeriodFormatPipe<any>, "dayPeriodFormat", true>;
 }
 declare class TranslateDayPeriodPipe implements PipeTransform {
@@ -397,6 +375,32 @@ declare class TranslateDayPeriodPipe implements PipeTransform {
     static ɵpipe: i0.ɵɵPipeDeclaration<TranslateDayPeriodPipe, "translateDayPeriod", true>;
 }
 
+/**
+ * DateTimeFormats is intended to keep options
+ * related to date-time formatting / parsing
+ *
+ */
+interface DateTimeFormats {
+    parse: {
+        dateInput: unknown;
+        timeInput: unknown;
+        dateTimeInput: unknown;
+    };
+    display: {
+        dateInput: unknown;
+        timeInput: unknown;
+        dateTimeInput: unknown;
+        dateA11yLabel: unknown;
+        monthA11yLabel: unknown;
+        yearA11yLabel: unknown;
+    };
+    rangeDelimiter: string;
+}
+/**
+ * DateTimeFormats injection token
+ */
+declare const DATE_TIME_FORMATS: InjectionToken<DateTimeFormats>;
+
 /**
  * Converts a given time string to a desired format.
  *
@@ -508,9 +512,9 @@ declare class FdDate {
 
 declare const FD_DATETIME_FORMATS: DateTimeFormats;
 
-/** Adds 0 if number is less then 10 */
-declare function _leftPad(n: number): string;
-/** Converts date to ISO8601 */
+/** Pads a number to at least 2 digits. Years are padded to at least 4 digits. */
+declare function _leftPad(n: number, minLength?: number): string;
+/** Converts date to ISO 8601 date-time string without timezone designator (`YYYY-MM-DDTHH:mm:ss`). */
 declare function toIso8601(fdDate: {
     year: number;
     month: number;
@@ -544,10 +548,16 @@ type CustomDateTimeFormatOptions = Omit<Intl.DateTimeFormatOptions, 'dayPeriod'>
 declare class FdDatetimeAdapter extends DatetimeAdapter<FdDate> {
     /** Whether to clamp the date between 1 and 9999 to avoid IE and Edge errors. */
     private readonly _fixYearsRangeIssue;
+    /** Cached Intl.RelativeTimeFormat instance, invalidated on locale change. */
+    private _relativeTimeFormatter;
+    /** Cached result of _isFormatDayFirst(), invalidated on locale change. */
+    private _dayFirstCache;
     /** @hidden */
-    constructor(localeId: string, platform: Platform);
+    constructor();
     /** @hidden */
-    fromNow?(date: FdDate): string;
+    setLocale(locale: string): void;
+    /** @hidden */
+    fromNow(date: FdDate): string;
     /** Get year */
     getYear(date: FdDate): number;
     /** Get month */
@@ -593,9 +603,9 @@ declare class FdDatetimeAdapter extends DatetimeAdapter<FdDate> {
     /** Set hours */
     setHours(date: FdDate, hours: number): FdDate;
     /** Set minutes */
-    setMinutes(date: FdDate, hours: number): FdDate;
+    setMinutes(date: FdDate, minutes: number): FdDate;
     /** Set seconds */
-    setSeconds(date: FdDate, hours: number): FdDate;
+    setSeconds(date: FdDate, seconds: number): FdDate;
     /** Get first day of week */
     getFirstDayOfWeek(): number;
     /** Get number of days in a month */
@@ -626,7 +636,7 @@ declare class FdDatetimeAdapter extends DatetimeAdapter<FdDate> {
     datesEqual(date1: FdDate, date2: FdDate): boolean;
     /** Check if dates and time are equal */
     dateTimesEqual(date1: FdDate, date2: FdDate): boolean;
-    /** Format date object to ISO8601 string */
+    /** {@inheritDoc DatetimeAdapter.toIso8601} */
     toIso8601(fdDate: FdDate): string;
     /** Check if a time format includes a day period */
     isTimeFormatIncludesDayPeriod(displayFormat: CustomDateTimeFormatOptions): boolean;
@@ -671,7 +681,7 @@ declare class FdDatetimeAdapter extends DatetimeAdapter<FdDate> {
      * @param hours The hours as a number between 0 - 24
      * @param minutes The minutes as a number between 0 - 59
      * @param seconds The seconds as a number between 0 - 59
-     * @param milliseconds The milliseconds as a number between 0 - 59
+     * @param milliseconds The milliseconds as a number between 0 - 999
      */
     private _createUTCDateInstance;
     /** @hidden */
@@ -679,16 +689,47 @@ declare class FdDatetimeAdapter extends DatetimeAdapter<FdDate> {
     /**
      * @hidden
      *
-     * Since FdDatetimeAdapter can parse only "en-US" locale
-     * there is no reason to create comprehensive time parse
-     * that can understand plenty of locales.
-     *
-     * @param timeStr Time string to parse (E.g. '10:30 PM')
-     * @returns date Native date instance
+     * Parse a time string into hours, minutes, seconds and apply to today's date.
+     * Supports: "14:30", "14:30:45", "10:30 PM", "10:30PM", "14.30" (dot separator).
      *
+     * @param timeStr Time string to parse
+     * @returns date Native date instance (Invalid Date if parsing fails)
      */
     private _parseTimeString;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FdDatetimeAdapter, [{ optional: true; }, null]>;
+    /**
+     * @hidden
+     *
+     * Try to parse a date string with common separators (/, -, .)
+     * using locale awareness for day/month ordering.
+     *
+     * @param value Date string (e.g. "12.03.2026", "03/12/2026", "2026-03-12")
+     * @returns Native Date instance or null if parsing fails
+     */
+    private _parseDateString;
+    /**
+     * @hidden
+     *
+     * Parse a locale-native datetime string that contains both a date and a time
+     * component (e.g. "20/05/2026 16:33" fr-FR, "20.5.2026, 16:33" de-DE).
+     *
+     * Strategy: split on the first 4-digit year boundary (everything before+including
+     * the year is the date part; everything after the optional ", " separator is the
+     * time part), delegate each half to the existing helpers, then combine.
+     *
+     * @param value Datetime string to parse
+     * @returns Native Date instance or null if parsing fails
+     */
+    private _parseDateTimeString;
+    /**
+     * @hidden
+     *
+     * Detect whether the current locale formats dates with day before month.
+     * Uses Intl.DateTimeFormat.formatToParts to inspect the locale's ordering.
+     *
+     * @returns true if locale puts day before month (e.g. de-DE, en-GB)
+     */
+    private _isFormatDayFirst;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FdDatetimeAdapter, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<FdDatetimeAdapter>;
 }
 

package/types/fundamental-ngx-core-form.d.ts

@@ -220,6 +220,8 @@ declare class FormInputMessageGroupComponent {
     _popover: PopoverComponent;
     /** @hidden */
     readonly _elementRef: ElementRef<any>;
+    /** @hidden Translated aria-label for the popover body (#14260). */
+    protected readonly _popoverAriaLabel: i0.Signal<string>;
     /**
      * Function is called every time message changes isOpen attribute
      */