@hortiview/shared-components 2.22.0 → 2.23.0

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+## [2.23.0](https://dev.azure.com/sdundc/HV%20Platform/_git/HortiView-Frontend-Shared/compare/v2.22.0...v2.23.0) (2026-04-13)
+
+### Features
+
+* improve FormDatePicker UTC handling and date conversion logic ([d2e6000](https://dev.azure.com/sdundc/HV%20Platform/_git/HortiView-Frontend-Shared/commit/d2e6000f5e6e60acdd4c424297b76ea5d1d2f88a))
+
+### Code Refactoring
+
+* extract FormDatePicker utility functions into a separate service file; linting ([7908c2c](https://dev.azure.com/sdundc/HV%20Platform/_git/HortiView-Frontend-Shared/commit/7908c2c5233c841965a515f7144656fdd0d12285))
+* rename and update date handling functions for improved clarity and functionality ([1f6713b](https://dev.azure.com/sdundc/HV%20Platform/_git/HortiView-Frontend-Shared/commit/1f6713bbe19e84f01f57890f7c77559ce281e9d5))
+
 ## [2.22.0](https://dev.azure.com/sdundc/HV%20Platform/_git/HortiView-Frontend-Shared/compare/v2.21.0...v2.22.0) (2026-04-13)
 
 ### Features

package/dist/components/FormComponents/FormDatePicker/FormDatePicker.d.ts

@@ -21,7 +21,7 @@ type DatePickerProps<T extends FieldValues> = {
     helperText?: string;
     /** Add the number of years to subtract from the current date as bottom of range */
     minRangeYear?: number;
-    /** Add the number of years to add to the current date as top of range */
+    /** Add the number of years to add to the current date as top of the range */
     maxRangeYear?: number;
     /** Locale to be used for the date picker. */
     locale?: string;
@@ -30,6 +30,18 @@ type DatePickerProps<T extends FieldValues> = {
  * FormDatePicker is a custom form input component for selecting dates.
  * It is integrated with react-hook-form for form management.
  *
+ * Date handling model used by this component:
+ *
+ * - The persisted/form value is a "date-only" value stored as a Date at 00:00:00 UTC.
+ * - The UI date picker works with Date objects in the browser's local timezone.
+ * - Before rendering, the stored UTC date is converted into a local Date with the same
+ *   calendar year/month/day so the picker shows the expected day for the user.
+ * - After selection, the picked local calendar date is converted back into a UTC-midnight Date
+ *   before storing it in react-hook-form.
+ *
+ * This conversion is necessary to avoid timezone-related off-by-one-day issues when working
+ * with date-only values.
+ *
  * @param propertyName - the name of the property this date picker maps to in the form.
  * @param label - label displayed along with the date picker.
  * @param closeLabel - label displayed as close button text.
@@ -43,5 +55,5 @@ type DatePickerProps<T extends FieldValues> = {
  *
  * @returns A JSX element that renders a date picker form input.
  */
-export declare const FormDatePicker: <T extends FieldValues>({ propertyName, label, closeLabel, className, minRangeYear, maxRangeYear, locale, rules, helperText, ...props }: Omit<ElementDatePickerProps, "locale"> & DatePickerProps<T>) => import("react/jsx-runtime").JSX.Element;
+export declare const FormDatePicker: <T extends FieldValues>({ propertyName, label, closeLabel, className, minRangeYear, maxRangeYear, locale, rules, helperText, ...props }: Omit<ElementDatePickerProps, "locale" | "useUtc"> & DatePickerProps<T>) => import("react/jsx-runtime").JSX.Element;
 export {};