@salt-ds/lab 1.0.0-alpha.71 → 1.0.0-alpha.73

package/CHANGELOG.md

@@ -1,5 +1,116 @@
 # @salt-ds/lab
 
+## 1.0.0-alpha.73
+
+### Patch Changes
+
+- 86877dd: Fixed extra margin appearing on StaticList.
+- Updated dependencies [55e7bc5]
+- Updated dependencies [3481308]
+- Updated dependencies [851e4cb]
+  - @salt-ds/core@1.47.3
+
+## 1.0.0-alpha.72
+
+### Patch Changes
+
+- a8ee89c: Upgrade peer dependencies for Luxon and its type definitions to the latest versions.
+
+  - Updated peer dependency `luxon` from `^3.5.0` to `^3.6.1`.
+  - Updated peer dependency `@types/luxon` from `^3.4.2` to `^3.6.2`.
+
+  This upgrade includes improvements and bug fixes provided in the newer versions of Luxon and its type definitions. Ensure compatibility with your codebase by reviewing any changes in the Luxon API or type definitions. As these are peer dependencies, make sure that the consuming projects are also updated to these versions to avoid potential conflicts.
+
+- ab80f5f: Updated the `Calendar` API to use a `multiselect` prop instead of `selectionVariant="multiselect"`
+
+  Previously, the `Calendar` component used `selectionVariant="multiselect"` to enable the selection and de-selection of multiple single dates, with the de-selection logic embedded within the component.
+
+  To extend multiple selection capabilities to all selection variants, we have revised the API to include a `multiselect` boolean prop. This change removes the need for `selectionVariant="multiselect"`.
+
+  Now, you can apply the multiselect property in `Calendar` alongside `selectionVariant="single`", `selectionVariant="range"`, or `selectionVariant="offset"`.
+
+  This update allows us to offer a consistent multiple selection API across all date selection variants.
+
+  ```diff
+  <Calendar
+  -  selectionVariant="multiselect"
+  +  selectionVariant="single"
+  +  multiselect
+  >
+    <CalendarNavigation />
+    <CalendarGrid />
+  </Calendar>
+  ```
+
+  To de-select a previous selection, control is provided through a new `select` prop that enables control over the current selection based on the day that has been selected by the user.
+
+  ```diff
+  function selectMultiselectSingle<TDate extends DateFrameworkType>(
+    dateAdapter: SaltDateAdapter<TDate>,
+    previousSelectedDate: SingleDateSelection<TDate>[],
+    newDate: TDate,
+  ) {
+    const newSelection = previousSelectedDate.filter(
+      (previousSingleDate) =>
+        !dateAdapter.isSame(previousSingleDate, newDate, "day"),
+    );
+    if (previousSelectedDate.length !== newSelection.length) {
+      return newSelection;
+    }
+    return [...previousSelectedDate, newDate];
+  }
+
+  <Calendar
+  -  selectionVariant="multiselect"
+  +  selectionVariant="single"
+  +  multiselect
+  +   select={(
+  +     previousSelectedDate: SingleDateSelection<DateFrameworkType>[],
+  +     newDate: SingleDateSelection<DateFrameworkType>,
+  +   ) => selectMultiselectSingle(dateAdapter, previousSelectedDate, newDate)}
+     >
+     <StackLayout gap={0}>
+        <CalendarNavigation />
+        <CalendarGrid />
+     </StackLayout>
+  </Calendar>
+  ```
+
+  A few additional type changes have occurred:
+
+  `CalendarMultiSelectProps` has been replaced by `CalendarMultiselectSingleProps`, and `UseCalendarMultiSelectProps` has been replaced by `UseCalendarMultiselectSingleProps`.
+
+  ```diff
+  - import { type CalendarMultiSelectProps } from "@salt-ds/lab";
+  + import { type CalendarMultiselectSingleProps } from "@salt-ds/lab";
+
+  - import { type UseCalendarMultiSelectProps } from "@salt-ds/lab";
+  + import { type UseCalendarMultiselectSingleProps } from "@salt-ds/lab";
+  ```
+
+  The associated selected date type for multiselect single dates, has also been updated:
+
+  ```diff
+  import type { DateFrameworkType } from "@salt-ds/date-adapters"; // This type can be any supported date framework object type, such as Date, Dayjs, Luxon, or Moment
+  - import type { MultipleDateSelection } from "@salt-ds/lab";
+  + import type { SingleDateSelection } from "@salt-ds/lab";
+  - type selectedDate = MultipleDateSelection<DateFrameworkType>;
+  + type selectedDate = Array<SingleDateSelection<DateFrameworkType>>;
+  ```
+
+  Our goal for the `DatePicker` is to support multiple selection across all date types: `single`, `range`, and `offset`, similar to the functionality in Calendar.
+  However, this will require a design iteration around the input component before it can be added.
+
+- c86ee15: Fixed CascadingMenu and refactored the styles to not use any deprecated tokens.
+- Updated dependencies [a8ee89c]
+- Updated dependencies [09cac7d]
+- Updated dependencies [cdce628]
+- Updated dependencies [454686b]
+- Updated dependencies [f25a82b]
+- Updated dependencies [6bc8e53]
+  - @salt-ds/date-adapters@0.1.0-alpha.5
+  - @salt-ds/core@1.47.2
+
 ## 1.0.0-alpha.71
 
 ### Minor Changes