@aurodesignsystem-dev/auro-formkit 0.0.0-pr1483.1 → 0.0.0-pr1483.11

package/components/datepicker/dist/src/auro-calendar-cell.d.ts

@@ -38,7 +38,7 @@ export class AuroCalendarCell extends LitElement {
             type: BooleanConstructor;
         };
         locale: {
-            type: ObjectConstructor;
+            type: StringConstructor;
         };
         dateStr: {
             type: StringConstructor;
@@ -148,6 +148,8 @@ export class AuroCalendarCell extends LitElement {
      * @returns {String} The title of the auro-calendar-cell in the user's locale.
      */
     private getTitle;
+    _titleFormatter: Intl.DateTimeFormat | undefined;
+    _titleFormatterLocale: any;
     /**
      * Gets the name of the date slot.
      * @private

package/components/datepicker/dist/src/auro-calendar-month.d.ts

@@ -8,6 +8,19 @@ export class AuroCalendarMonth extends RangeDatepickerCalendar {
             type: BooleanConstructor;
             reflect: boolean;
         };
+        /**
+         * BCP 47 locale tag (such as `en-US`) for calendar localization.
+         * as wc-range-datepicker expects a `locale` prop, we use `localeCode` to avoid conflicts.
+         */
+        localeCode: {
+            type: StringConstructor;
+        };
+        /**
+         * Names of all 12 months. When omitted, names are derived from `localeCode`.
+         */
+        monthNames: {
+            type: ArrayConstructor;
+        };
     };
     /**
      * Returns month name to be rendered in the calendar header.
@@ -16,5 +29,15 @@ export class AuroCalendarMonth extends RangeDatepickerCalendar {
      * @returns {String} The name of the month.
      */
     private computeCurrentMonthName;
+    _cachedMonthNames: string[] | undefined;
+    _cachedMonthNamesLocale: any;
+    /**
+     * Determines the current month name based on locale.
+     * This is a rewrite of the function used in the class RangeDatepickerCalendar and should not be removed from here.
+     * @private
+     * @param {Object} changedProperties - The properties that have changed since the last update.
+     * @returns {void}
+     */
+    private updated;
 }
 import { RangeDatepickerCalendar } from './vendor/wc-range-datepicker/range-datepicker-calendar.js';

package/components/datepicker/dist/src/auro-calendar.d.ts

@@ -83,6 +83,8 @@ export class AuroCalendar extends RangeDatepicker {
             reflect: boolean;
         };
         /**
+         * If true, the month will be displayed before the year in the calendar header.
+         * Passed to AuroCalendarMonth via utilitesCalendarRender.
          * @private
          */
         monthFirst: {
@@ -102,6 +104,19 @@ export class AuroCalendar extends RangeDatepicker {
             type: BooleanConstructor;
             reflect: boolean;
         };
+        /**
+         * BCP 47 locale tag (such as `en-US`) for calendar localization.
+         * as wc-range-datepicker expects a `locale` prop, we use `localeCode` to avoid conflicts and pass the locale down to calendar-month elements.
+         */
+        localeCode: {
+            type: StringConstructor;
+        };
+        /**
+         * Names of all 12 months. When omitted, names are derived from `localeCode`.
+         */
+        monthNames: {
+            type: ArrayConstructor;
+        };
     };
     /**
      * @private

package/components/datepicker/dist/src/auro-datepicker.d.ts

@@ -126,6 +126,13 @@ export class AuroDatePicker extends AuroElement {
             type: StringConstructor;
             reflect: boolean;
         };
+        /**
+         * Defines the locale of the element. Used to derive the date format when `format` is not explicitly set.
+         */
+        locale: {
+            type: StringConstructor;
+            reflect: boolean;
+        };
         /**
          * Defines the screen size breakpoint at which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.
          *
@@ -170,17 +177,12 @@ export class AuroDatePicker extends AuroElement {
             reflect: boolean;
         };
         /**
-         * Names of all 12 months to render in the calendar, used for localization of date string in mobile layout.
+         * Names of all 12 months to render in the calendar.
+         * When omitted, month names will be automatically populated from the active `locale` (falling back to `en-US`).
          */
         monthNames: {
             type: ArrayConstructor;
         };
-        /**
-         * @private
-         */
-        monthFirst: {
-            type: BooleanConstructor;
-        };
         /**
          * If declared, the bib will NOT flip to an alternate position
          * when there isn't enough space in the specified `placement`.
@@ -346,6 +348,10 @@ export class AuroDatePicker extends AuroElement {
      * @private
      */
     private calendarRenderUtil;
+    /**
+     *  @private
+     */
+    private domHandler;
     appearance: string;
     touched: boolean;
     disabled: boolean;
@@ -361,9 +367,8 @@ export class AuroDatePicker extends AuroElement {
     calendarStartDate: any;
     calendarEndDate: any;
     calendarFocusDate: any;
-    format: string;
     fullscreenBreakpoint: string;
-    monthNames: string[];
+    _validLocale: string;
     placement: string;
     offset: number;
     noFlip: boolean;
@@ -432,7 +437,7 @@ export class AuroDatePicker extends AuroElement {
     /**
      * Handles click on the clear button.
      * @private
-     * @param {MouseEvent} event
+     * @param {MouseEvent} event - The click event object.
      * @returns {void}
      */
     private handleClearClick;
@@ -463,8 +468,9 @@ export class AuroDatePicker extends AuroElement {
      */
     private get displayValueFontClass();
     /**
-     * @private
      * Common display value wrapper classes.
+     * @private
+     * @return {Object} - An object containing the common classes for the display value wrapper.
      */
     private get commonDisplayValueWrapperClasses();
     /**
@@ -504,21 +510,45 @@ export class AuroDatePicker extends AuroElement {
      * @param {String} time - Unix timestamp to be converted to a date object.
      * @returns {Date} Date formatted as a string.
      */
-    /** @returns {Date|undefined} */
+    /**
+     * Read-only `Date` object derived from `value`. Returns `undefined` when `value` is empty or not a valid date.
+     * @returns {Date|undefined}
+     */
     get valueObject(): Date | undefined;
-    /** @returns {Date|undefined} */
+    /**
+     * Read-only `Date` object derived from `valueEnd`. Returns `undefined` when `valueEnd` is empty or not a valid date.
+     * @returns {Date|undefined}
+     */
     get valueEndObject(): Date | undefined;
-    /** @returns {Date|undefined} */
+    /**
+     * Read-only `Date` object derived from `minDate`. Returns `undefined` when `minDate` is empty or not a valid date.
+     * @returns {Date|undefined}
+     */
     get minDateObject(): Date | undefined;
-    /** @returns {Date|undefined} */
+    /**
+     * Read-only `Date` object derived from `maxDate`. Returns `undefined` when `maxDate` is empty or not a valid date.
+     * @returns {Date|undefined}
+     */
     get maxDateObject(): Date | undefined;
-    /** @returns {Date|undefined} */
+    /**
+     * Read-only `Date` object derived from `calendarStartDate`. Returns `undefined` when `calendarStartDate` is empty or not a valid date.
+     * @returns {Date|undefined}
+     */
     get calendarStartDateObject(): Date | undefined;
-    /** @returns {Date|undefined} */
+    /**
+     * Read-only `Date` object derived from `calendarEndDate`. Returns `undefined` when `calendarEndDate` is empty or not a valid date.
+     * @returns {Date|undefined}
+     */
     get calendarEndDateObject(): Date | undefined;
-    /** @returns {Date|undefined} */
+    /**
+     * Read-only `Date` object derived from `centralDate`. Returns `undefined` when `centralDate` is empty or not a valid date.
+     * @returns {Date|undefined}
+     */
     get centralDateObject(): Date | undefined;
-    /** @returns {Date|undefined} */
+    /**
+     * Read-only `Date` object derived from `calendarFocusDate`. Returns `undefined` when `calendarFocusDate` is empty or not a valid date.
+     * @returns {Date|undefined}
+     */
     get calendarFocusDateObject(): Date | undefined;
     /**
      * Converts a Unix timestamp (seconds) from the vendor calendar to an ISO date string.
@@ -636,9 +666,20 @@ export class AuroDatePicker extends AuroElement {
      * @private
      */
     private setHasValue;
+    /**
+     * Returns `true` when the datepicker has an active validation error.
+     * @returns {boolean}
+     */
     get hasError(): boolean;
-    updated(changedProperties: any): Promise<void>;
-    monthFirst: boolean | undefined;
+    /**
+     * lifecycle method to check if the locale is valid.
+     * @ignore
+     * @param {Map} changedProperties - The map of properties that have changed since the last update.
+     * @returns {void}
+     */
+    willUpdate(changedProperties: Map<any, any>): void;
+    format: string | undefined;
+    updated(changedProperties: any): void;
     previousTabIndex: string | null | undefined;
     /**
      * Handles the transfer of content between slots in the component.
@@ -656,6 +697,7 @@ export class AuroDatePicker extends AuroElement {
      */
     private configureClickHandler;
     firstUpdated(): void;
+    locale: any;
     /**
      * Renders the snowflake layout for the datepicker.
      * @private

package/components/datepicker/dist/src/utilities.d.ts

@@ -1,11 +1,4 @@
 export class AuroDatepickerUtilities {
-    /**
-     * Converts an ISO date string (yyyy-mm-dd) to any display format.
-     * @param {string} isoStr - ISO date string.
-     * @param {string} format - Target display format (e.g. "mm/dd/yyyy", "dd/mm/yyyy").
-     * @returns {string|undefined}
-     */
-    toCustomFormat(isoStr: string, format: string): string | undefined;
     /**
      * Converts any date object to a date object representing the first day of the month.
      * @param {Object} date - Date to convert to the first day of the month.
@@ -19,19 +12,6 @@ export class AuroDatepickerUtilities {
      * @returns {Number}
      */
     monthDiff(date1: Object, date2: Object): number;
-    /**
-     * Convert a date object or timestamp to an ISO string (yyyy-mm-dd).
-     * @param {Date|number} date - Date object or timestamp.
-     * @returns {string|undefined}
-     */
-    getDateAsString(date: Date | number): string | undefined;
-    /**
-     * Function to format a number to two digits.
-     * @private
-     * @param {Number} num - Number to format.
-     * @returns {String}
-     */
-    private formatTwoDigits;
     /**
      * Function to generate checkmark svg.
      * @private

package/components/datepicker/dist/src/utilitiesCalendar.d.ts

@@ -4,7 +4,6 @@ export class CalendarUtilities {
      * Scroll the calendar month list to a given valid date if in mobile view.
      * @param {Object} elem - The calendar element.
      * @param {String} date - The date to scroll into view.
-     * @param {String} format - The format of the date.
      * @returns {void}
      */
     scrollMonthIntoView(elem: Object, date: string): void;

package/components/dropdown/demo/customize.min.js

@@ -3942,7 +3942,7 @@ class AuroHelpText extends i {
   }
 }
 
-var formkitVersion = '202605271820';
+var formkitVersion = '202606051831';
 
 class AuroElement extends i {
   static get properties() {

package/components/dropdown/demo/getting-started.min.js

@@ -3942,7 +3942,7 @@ class AuroHelpText extends i {
   }
 }
 
-var formkitVersion = '202605271820';
+var formkitVersion = '202606051831';
 
 class AuroElement extends i {
   static get properties() {

package/components/dropdown/demo/index.min.js

@@ -3969,7 +3969,7 @@ class AuroHelpText extends i {
   }
 }
 
-var formkitVersion = '202605271820';
+var formkitVersion = '202606051831';
 
 class AuroElement extends i {
   static get properties() {

package/components/dropdown/dist/index.js

@@ -3874,7 +3874,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202605271820';
+var formkitVersion = '202606051831';
 
 class AuroElement extends LitElement {
   static get properties() {

package/components/dropdown/dist/registered.js

@@ -3874,7 +3874,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202605271820';
+var formkitVersion = '202606051831';
 
 class AuroElement extends LitElement {
   static get properties() {