@salt-ds/date-components 0.0.0-snapshot-20260330155807

package/CHANGELOG.md

@@ -0,0 +1,109 @@
+# @salt-ds/date-components
+
+## 0.0.0-snapshot-20260330155807
+
+### Patch Changes
+
+- ad98ac6: New package `@salt-ds/date-components` has been added to contain shared date-related components such as `Calendar`, `CalendarNavigation`, and `DateInput`.
+  To avoid a breaking change, `@salt-ds/lab` still re-exports these components for now (and logs a deprecation warning in development). New code should import from `@salt-ds/date-components`.
+
+  Calendar updates
+
+  - fixed styling issues with selected range border.
+  - fix Calendar dropdown spacing that caused an ellipsis to appear at mobile breakpoints.
+  - improved screenreader support.
+  - type improvements
+    - remove un-used code/types and simplified structure of selection types.
+    - simplify types, generics for usage of date adapters are no longer essentially required unless you are creating a custom date adapter.
+  - Calendar provides default screen-reader announcements by default.
+  - custom live announcements can be configured through a `createAnnouncement` factory method.
+
+  ```
+  import { Calendar } from "@salt-ds/lab";
+  import type { CreateAnnouncement } from "@salt-ds/lab";
+
+  const customCreateAnnouncement: CreateAnnouncement<DateFrameworkType> = (announcementType, state, dateAdapter) => {
+    switch (minFocusableDateExceeded) {
+      case "dateSelected":
+        return `Minimum date exceeded ${dateAdapter.format(state.selectedDate)}`;
+      case "maxFocusableDateExceeded":
+        return `Maximum date exceeded ${dateAdapter.format(state.selectedDate)}`;
+      case "dateSelected":
+        return `You selected ${dateAdapter.format(state.selectedDate, "longDate")}`;
+      case "visibleMonthChanged":
+        return `Selected ${dateAdapter.format(state.startVisibleMonth, "monthYear")}`;
+      default:
+        return undefined;
+    }
+  };
+
+  <Calendar
+    createAnnouncement={customCreateAnnouncement}
+    timezone="UTC"
+  />
+  ```
+
+  - `CalendarNavigation` has new props `PreviousButtonProps` and `NextButtonProps` to pass props to the navigation buttons.
+    These props can be used in place of `onNavigateNext`, `disableNavigateNext` and `onNavigatePrevious`, `disableNavigatePrevious`.
+  - `CalendarNavigation` has removed props `onMonthSelect` and `onYearSelect`, use `MonthDropdownProps` and `YearDropdownProps` instead.
+
+  ```diff
+  <CalendarNavigation
+  -  onMonthSelect={handleMonthSelect}
+  +  MonthDropdownProps={{
+  +    onChange: handleMonthSelect
+  +  }}
+  -  onYearSelect={handleYearSelect}
+  +  YearDropdownProps={{
+  +    onChange: handleYearSelect
+  +  }}
+  -  onNavigatePrevious={handlePrevious}
+  -  disableNavigatePrevious={isPreviousDisabled}
+  +  PreviousButtonProps={{
+  +    onClick: handlePrevious,
+  +    disabled: isPreviousDisabled
+  +  }}
+  -  onNavigateNext={handleNext}
+  -  disableNavigateNext={isNextDisabled}
+  +  NextButtonProps={{
+  +    onClick: handleNext,
+  +    disabled: isNextDisabled
+  +  }}
+  />
+  ```
+
+  - `CalendarNavigation` now adds tooltips to out of range dates.
+  - when a Calendar has `minDate` or `maxDate` and the user navigates to a month outside of that range, the Calendar will now automatically navigate back to the closest valid month.
+
+- 6252900: Update date library dependency versions used by date components and date-adapters.
+
+  Package.json dependency range updates:
+
+  - `@date-fns/tz` `^1.2.0` -> `^1.4.1` (root, `@salt-ds/lab` devDeps, site deps, and `@salt-ds/date-adapters` peers)
+  - `dayjs` `^1.11.13` -> `^1.11.20` (lab devDeps, site deps, and date-adapters peers)
+  - `luxon` `^3.6.1` -> `^3.7.2` (lab devDeps, site deps, and date-adapters peers)
+  - `moment-timezone` `^0.5.46` -> `^0.6.1` (lab devDeps, site deps, and date-adapters peers)
+  - `@types/luxon` `^3.6.2` -> `^3.7.1` (lab devDeps, site devDeps, and date-adapters peers)
+
+  These changes are dependency-only (no Salt public API changes).
+
+- 61769ce: Date picker updates
+
+  - fixed a bug where a disabled picker could still open by clicking the input
+  - improved screen reader support
+
+- 8ebbe39: `DateInputSingle` and `DateInputRange` a11y and dayjs timezone improvements
+
+  - added `aria-invalid` to `DateInputSingle` and `DateInputRange` input elements when an error is present.
+  - fixed Dayjs timezone handling for date input/picker workflows so that user-entered dates are correctly interpreted as midnight in the selected IANA timezone when serializing to ISO (e.g. `America/New_York`, `Asia/Shanghai`).
+
+- Updated dependencies [6252900]
+- Updated dependencies [cfc1591]
+- Updated dependencies [0a08ae0]
+- Updated dependencies [49b3486]
+- Updated dependencies [8ebbe39]
+- Updated dependencies [8d9ca17]
+- Updated dependencies [a68cf61]
+  - @salt-ds/date-adapters@0.0.0-snapshot-20260330155807
+  - @salt-ds/core@0.0.0-snapshot-20260330155807
+  - @salt-ds/icons@0.0.0-snapshot-20260330155807

package/README.md

@@ -0,0 +1,63 @@
+# @salt-ds/date-components
+
+Salt Design System date components.
+
+## Status
+
+The date components previously lived in `@salt-ds/lab`. They now live here in `@salt-ds/date-components`.
+
+To avoid a breaking change, `@salt-ds/lab` still re-exports these components for now (and logs a deprecation warning in development). New code should import from `@salt-ds/date-components`.
+
+## Contents
+
+This package includes:
+
+- **Calendar** (and supporting hooks)
+- **Date input** components
+- **Date picker** components
+- **LocalizationProvider** for date localization/config
+
+## Installation
+
+```sh
+yarn add @salt-ds/date-components @salt-ds/date-adapters
+```
+
+You will also need the usual Salt peer dependencies (React) and the Salt packages used by these components (for example `@salt-ds/core`, `@salt-ds/styles`).
+
+## Date adapters
+
+The date components rely on `@salt-ds/date-adapters` for parsing/formatting and date framework integration.
+
+Make sure you have an adapter configured for the date library/framework you’re using, and wrap your app (or the relevant subtree) with `LocalizationProvider`.
+
+## Usage
+
+Import components from `@salt-ds/date-components`:
+
+```tsx
+import {
+  LocalizationProvider,
+  DatePicker,
+  DateInputSingle,
+  Calendar,
+} from "@salt-ds/date-components";
+
+// ...render in your app
+```
+
+## Migration from `@salt-ds/lab`
+
+If you currently import date components from `@salt-ds/lab`, you can continue to do so for now, but those exports are deprecated and will be removed in a future release.
+
+Update imports from:
+
+```ts
+import { DatePicker } from "@salt-ds/lab";
+```
+
+to:
+
+```ts
+import { DatePicker } from "@salt-ds/date-components";
+```