@okta/odyssey-react-mui 1.29.0 → 1.32.0

package/src/ui-shell/SideNav/SideNavLogo.tsx

@@ -0,0 +1,65 @@
+/*!
+ * Copyright (c) 2024-present, Okta, Inc. and/or its affiliates. All rights reserved.
+ * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the "License.")
+ *
+ * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and limitations under the License.
+ */
+
+import { memo, useMemo } from "react";
+import styled from "@emotion/styled";
+
+import { OktaLogo } from "./OktaLogo.js";
+import { SideNavLogoProps } from "./types.js";
+
+const StyledLogoContainer = styled("div")(() => ({
+  display: "flex",
+  alignItems: "center",
+  height: "100%",
+}));
+
+const StyledLogoLink = styled("a")(() => ({
+  display: "flex",
+  alignItems: "center",
+  height: "100%",
+}));
+
+const SideNavLogo = ({
+  imageAltText,
+  logoComponent,
+  imageUrl,
+  ...optionalProps
+}: SideNavLogoProps) => {
+  const logo = useMemo(() => {
+    if (logoComponent) {
+      return logoComponent;
+    }
+
+    if (imageAltText && imageUrl) {
+      return <img src={imageUrl} alt={imageAltText} />;
+    }
+
+    return <OktaLogo />;
+  }, [imageAltText, logoComponent, imageUrl]);
+
+  return "href" in optionalProps && "ariaLabel" in optionalProps ? (
+    <StyledLogoLink
+      aria-label={optionalProps.ariaLabel}
+      data-se="sidenav-header-logo"
+      href={optionalProps.href}
+    >
+      {logo}
+    </StyledLogoLink>
+  ) : (
+    <StyledLogoContainer role="presentation">{logo}</StyledLogoContainer>
+  );
+};
+
+const MemoizedSideNavLogo = memo(SideNavLogo);
+MemoizedSideNavLogo.displayName = "SideNavLogo";
+
+export { MemoizedSideNavLogo as SideNavLogo };

package/src/ui-shell/SideNav/SideNavToggleButton.tsx

@@ -0,0 +1,272 @@
+/*!
+ * Copyright (c) 2022-present, Okta, Inc. and/or its affiliates. All rights reserved.
+ * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the "License.")
+ *
+ * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and limitations under the License.
+ */
+
+import { Button as MuiButton } from "@mui/material";
+import type { ButtonProps as MuiButtonProps } from "@mui/material";
+import {
+  HTMLAttributes,
+  memo,
+  useCallback,
+  useImperativeHandle,
+  useMemo,
+  useRef,
+} from "react";
+import styled from "@emotion/styled";
+import { useTranslation } from "react-i18next";
+
+import {
+  ContrastColors,
+  generateContrastColors,
+} from "../../createContrastColors.js";
+import { FocusHandle } from "../../inputUtils.js";
+import { MuiPropsContext, MuiPropsContextType } from "../../MuiPropsContext.js";
+import {
+  DesignTokens,
+  useOdysseyDesignTokens,
+} from "../../OdysseyDesignTokensContext.js";
+import { Tooltip } from "../../Tooltip.js";
+import { useUiShellContext } from "../../ui-shell/UiShellProvider.js";
+
+const StyledToggleButton = styled(MuiButton, {
+  shouldForwardProp: (prop) =>
+    prop !== "odysseyDesignTokens" &&
+    prop !== "isSideNavCollapsed" &&
+    prop !== "toggleContrastColors",
+})<{
+  isSideNavCollapsed: boolean;
+  odysseyDesignTokens: DesignTokens;
+  toggleContrastColors?: ContrastColors;
+}>(({ isSideNavCollapsed, odysseyDesignTokens, toggleContrastColors }) => ({
+  backgroundColor: "transparent",
+  position: "relative",
+  width: odysseyDesignTokens.Spacing6,
+  height: odysseyDesignTokens.Spacing6,
+  border: 0,
+  zIndex: 2,
+
+  "&:focus-visible": {
+    boxShadow: `inset 0 0 0 2px ${odysseyDesignTokens.PalettePrimaryMain}`,
+    outline: "none",
+  },
+
+  "&:hover, &:focus-visible": {
+    backgroundColor: "transparent",
+
+    "#lineOne": {
+      animation: `lineOne-animate-to-collapse ${odysseyDesignTokens.TransitionDurationMain} cubic-bezier(0, 0, 0.2, 1)`,
+      animationFillMode: "forwards",
+      "@keyframes lineOne-animate-to-collapse": {
+        "0%": {
+          transform: "translate3d(-50%, -50%, 0)",
+        },
+        "50%": {
+          transform: "translate3d(-50%, -50%, 0) rotate(-90deg) scaleY(.75)",
+        },
+        "100%": {
+          transform: "translate3d(-50%, -27%, 0) rotate(-45deg) scaleY(.75)",
+        },
+      },
+    },
+
+    "#lineTwo": {
+      animation: `lineTwo-animate-to-collapse ${odysseyDesignTokens.TransitionDurationMain} cubic-bezier(0, 0, 0.2, 1)`,
+      animationFillMode: "forwards",
+      "@keyframes lineTwo-animate-to-collapse": {
+        "0%": {
+          transform: "translate3d(-50%, -50%, 0)",
+        },
+        "50%": {
+          transform: "translate3d(-50%, -50%, 0) rotate(-90deg) scaleY(.75)",
+        },
+        "100%": {
+          transform: "translate3d(-50%, -73%, 0) rotate(-135deg) scaleY(.75)",
+        },
+      },
+    },
+
+    ...(isSideNavCollapsed && {
+      "#lineOne": {
+        animation: `lineOne-animate-to-expand ${odysseyDesignTokens.TransitionDurationMain} cubic-bezier(0, 0, 0.2, 1)`,
+        animationFillMode: "forwards",
+        "@keyframes lineOne-animate-to-expand": {
+          "0%": {
+            transform: "translate3d(-50%, -50%, 0)",
+          },
+          "50%": {
+            transform: "translate3d(-50%, -50%, 0) rotate(90deg) scaleY(.75)",
+          },
+          "100%": {
+            transform: "translate3d(-50%, -73%, 0) rotate(135deg) scaleY(.75)",
+          },
+        },
+      },
+
+      "#lineTwo": {
+        animation: `lineTwo-animate-to-expand ${odysseyDesignTokens.TransitionDurationMain} cubic-bezier(0, 0, 0.2, 1)`,
+        animationFillMode: "forwards",
+        "@keyframes lineTwo-animate-to-expand": {
+          "0%": {
+            transform: "translate3d(-50%, -50%, 0)",
+          },
+          "50%": {
+            transform: "translate3d(-50%, -50%, 0) rotate(90deg) scaleY(.75)",
+          },
+          "100%": {
+            transform: "translate3d(-50%, -27%, 0) rotate(45deg) scaleY(.75)",
+          },
+        },
+      },
+    }),
+  },
+
+  span: {
+    position: "absolute",
+    top: "50%",
+    left: "50%",
+    width: "2px",
+    height: odysseyDesignTokens.Spacing4,
+    backgroundColor: odysseyDesignTokens.HueNeutral600,
+    transform: "translate3d(-50%, -50%, 0)",
+    transition: `transform ${odysseyDesignTokens.TransitionDurationMain}`,
+
+    ...(toggleContrastColors?.fontColor && {
+      backgroundColor: toggleContrastColors.fontColor,
+    }),
+  },
+}));
+
+export type SideNavToggleButtonProps = {
+  /**
+   * The ref forwarded to the Button
+   */
+  buttonRef?: React.RefObject<FocusHandle>;
+  /**
+   * The `id` of the item this button controls
+   */
+  ariaControls: string;
+  /**
+   * The ID of the Button
+   */
+  id?: string;
+  isSideNavCollapsed: boolean;
+  tabIndex?: HTMLAttributes<HTMLElement>["tabIndex"];
+  /**
+   * The click event handler for the Button
+   */
+  onClick?: MuiButtonProps["onClick"];
+  onKeyDown?: MuiButtonProps["onKeyDown"];
+};
+
+const SideNavToggleButton = ({
+  ariaControls,
+  buttonRef,
+  id,
+  isSideNavCollapsed,
+  onClick,
+  tabIndex,
+}: SideNavToggleButtonProps) => {
+  const odysseyDesignTokens = useOdysseyDesignTokens();
+  const { t } = useTranslation();
+  const uiShellContext = useUiShellContext();
+
+  const localButtonRef = useRef<HTMLButtonElement | HTMLAnchorElement>(null);
+
+  const toggleContrastColors = useMemo(() => {
+    const hasNonStandardAppBackgroundColor =
+      uiShellContext?.appBackgroundColor &&
+      uiShellContext?.appBackgroundColor !==
+        odysseyDesignTokens.HueNeutralWhite &&
+      uiShellContext?.appBackgroundColor !== odysseyDesignTokens.HueNeutral50;
+
+    if (hasNonStandardAppBackgroundColor) {
+      return generateContrastColors(
+        uiShellContext.appBackgroundColor,
+        odysseyDesignTokens,
+      );
+    }
+
+    return undefined;
+  }, [odysseyDesignTokens, uiShellContext]);
+
+  useImperativeHandle(
+    buttonRef,
+    () => ({
+      focus: () => {
+        localButtonRef.current?.focus();
+      },
+    }),
+    [],
+  );
+
+  const toggleLabel = useMemo(
+    () =>
+      isSideNavCollapsed
+        ? t("sidenav.toggle.expand")
+        : t("sidenav.toggle.collapse"),
+    [isSideNavCollapsed, t],
+  );
+
+  const renderButton = useCallback(
+    (muiProps: MuiPropsContextType) => {
+      return (
+        <StyledToggleButton
+          {...muiProps}
+          aria-controls={ariaControls}
+          aria-expanded={!isSideNavCollapsed}
+          aria-label={toggleLabel}
+          data-se="sidenav-toggle-button"
+          data-sidenav-toggle={true}
+          id={id}
+          isSideNavCollapsed={isSideNavCollapsed}
+          odysseyDesignTokens={odysseyDesignTokens}
+          onClick={onClick}
+          ref={(element) => {
+            if (element) {
+              (
+                localButtonRef as React.MutableRefObject<HTMLButtonElement>
+              ).current = element;
+              //@ts-expect-error ref is not an optional prop on the props context type
+              muiProps?.ref?.(element);
+            }
+          }}
+          tabIndex={tabIndex}
+          toggleContrastColors={toggleContrastColors}
+          variant="floating"
+        >
+          <span id="lineOne" />
+          <span id="lineTwo" />
+        </StyledToggleButton>
+      );
+    },
+    [
+      ariaControls,
+      id,
+      isSideNavCollapsed,
+      odysseyDesignTokens,
+      onClick,
+      tabIndex,
+      toggleContrastColors,
+      toggleLabel,
+    ],
+  );
+
+  return (
+    <Tooltip ariaType="description" placement="right" text={toggleLabel}>
+      <MuiPropsContext.Consumer>{renderButton}</MuiPropsContext.Consumer>
+    </Tooltip>
+  );
+};
+
+const MemoizedSideNavToggleButton = memo(SideNavToggleButton);
+MemoizedSideNavToggleButton.displayName = "SideNavToggleButton";
+
+export { MemoizedSideNavToggleButton as SideNavToggleButton };

package/src/ui-shell/SideNav/SortableList/SortableItem.tsx

@@ -0,0 +1,237 @@
+/*!
+ * Copyright (c) 2024-present, Okta, Inc. and/or its affiliates. All rights reserved.
+ * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the "License.")
+ *
+ * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and limitations under the License.
+ */
+
+import type {
+  DraggableSyntheticListeners,
+  UniqueIdentifier,
+} from "@dnd-kit/core";
+import { useSortable } from "@dnd-kit/sortable";
+import { CSS } from "@dnd-kit/utilities";
+import styled from "@emotion/styled";
+import {
+  createContext,
+  createRef,
+  RefObject,
+  useContext,
+  useMemo,
+  CSSProperties,
+  PropsWithChildren,
+} from "react";
+import { useTranslation } from "react-i18next";
+
+import {
+  DesignTokens,
+  useOdysseyDesignTokens,
+} from "../../../OdysseyDesignTokensContext.js";
+import {
+  UiShellColors,
+  useUiShellContext,
+} from "../../../ui-shell/UiShellProvider.js";
+import { ContrastColors } from "../../../createContrastColors.js";
+
+type ItemProps = {
+  id: UniqueIdentifier;
+  isDisabled?: boolean;
+  isSelected?: boolean;
+  isSortable?: boolean;
+};
+
+export type SortableItemContextType = {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  attributes: Record<string, any>;
+  listeners: DraggableSyntheticListeners;
+  ref: RefObject<HTMLButtonElement>;
+};
+
+const SortableItemContext = createContext<SortableItemContextType>({
+  attributes: {},
+  listeners: undefined,
+  ref: createRef<HTMLButtonElement>(),
+});
+
+const StyledSortableListItem = styled("li", {
+  shouldForwardProp: (prop) =>
+    prop !== "odysseyDesignTokens" &&
+    prop !== "isSelected" &&
+    prop !== "sideNavContrastColors",
+})<{
+  isSelected?: boolean;
+  odysseyDesignTokens: DesignTokens;
+  sideNavContrastColors: UiShellColors["sideNavContrastColors"];
+}>(({ odysseyDesignTokens, isSelected, sideNavContrastColors }) => ({
+  position: "relative",
+
+  button: {
+    top: "50%",
+    left: odysseyDesignTokens.Spacing2,
+    transform: "translateY(-50%)",
+  },
+
+  svg: {
+    path: {
+      fill: "currentColor",
+      ...(sideNavContrastColors?.fontColor && {
+        fill: sideNavContrastColors.fontColor,
+      }),
+    },
+  },
+
+  "&:has(a:hover, button:hover, a:focus, button:focus, a:focus-visible, button:focus-visible, [role='button']:hover, [role='button']:focus, [role='button']:focus-visible)":
+    {
+      button: {
+        opacity: 1,
+        outlineWidth: 0,
+      },
+    },
+
+  ...(isSelected && {
+    svg: {
+      path: {
+        fill: odysseyDesignTokens.TypographyColorAction,
+
+        ...(sideNavContrastColors?.fontColor && {
+          fill: sideNavContrastColors.fontColor,
+        }),
+      },
+    },
+  }),
+}));
+
+const StyledUl = styled("ul")({
+  padding: 0,
+  listStyle: "none",
+  listStyleType: "none",
+});
+
+const StyledDragHandleButton = styled("button", {
+  shouldForwardProp: (prop) =>
+    prop !== "odysseyDesignTokens" &&
+    prop !== "isDragging" &&
+    prop !== "focusRingColor",
+})<{
+  focusRingColor: ContrastColors["focusRingColor"];
+  isDragging?: boolean;
+  odysseyDesignTokens: DesignTokens;
+}>(({ odysseyDesignTokens, isDragging, focusRingColor }) => ({
+  position: "absolute",
+  opacity: 0,
+  padding: odysseyDesignTokens.Spacing2,
+  border: "none",
+  backgroundColor: "transparent",
+  cursor: `${isDragging ? "grabbing" : "grab"}`,
+  transition: `opacity ${odysseyDesignTokens.TransitionDurationMain}`,
+  borderRadius: odysseyDesignTokens.BorderRadiusMain,
+
+  svg: {
+    display: "flex",
+  },
+
+  "&:focus, &:focus-visible": {
+    outline: "none",
+    boxShadow: `inset 0 0 0 2px ${odysseyDesignTokens.PalettePrimaryMain}`,
+
+    ...(focusRingColor && {
+      boxShadow: `inset 0 0 0 2px ${focusRingColor}`,
+    }),
+  },
+}));
+
+type DragHandleProps = {
+  isDisabled?: boolean;
+  isDragging?: boolean;
+};
+
+export const DragHandle = ({ isDragging }: DragHandleProps) => {
+  const { attributes, listeners, ref } = useContext(SortableItemContext);
+  const odysseyDesignTokens: DesignTokens = useOdysseyDesignTokens();
+  const { t } = useTranslation();
+  const uiShellContext = useUiShellContext();
+
+  return (
+    <StyledDragHandleButton
+      {...attributes}
+      {...listeners}
+      aria-label={t("navigation.drag.handle")}
+      focusRingColor={uiShellContext?.sideNavContrastColors?.focusRingColor}
+      isDragging={isDragging}
+      ref={ref}
+      odysseyDesignTokens={odysseyDesignTokens}
+    >
+      <svg
+        width="16"
+        height="16"
+        viewBox="0 0 16 16"
+        fill="none"
+        xmlns="http://www.w3.org/2000/svg"
+      >
+        <path
+          fillRule="evenodd"
+          clipRule="evenodd"
+          d="M6 2.33331C6 2.8856 5.55228 3.33331 5 3.33331C4.44772 3.33331 4 2.8856 4 2.33331C4 1.78103 4.44772 1.33331 5 1.33331C5.55228 1.33331 6 1.78103 6 2.33331ZM11 3.33331C11.5523 3.33331 12 2.8856 12 2.33331C12 1.78103 11.5523 1.33331 11 1.33331C10.4477 1.33331 10 1.78103 10 2.33331C10 2.8856 10.4477 3.33331 11 3.33331ZM11 7.11109C11.5523 7.11109 12 6.66338 12 6.11109C12 5.55881 11.5523 5.11109 11 5.11109C10.4477 5.11109 10 5.55881 10 6.11109C10 6.66338 10.4477 7.11109 11 7.11109ZM12 9.88887C12 10.4412 11.5523 10.8889 11 10.8889C10.4477 10.8889 10 10.4412 10 9.88887C10 9.33659 10.4477 8.88887 11 8.88887C11.5523 8.88887 12 9.33659 12 9.88887ZM11 14.6666C11.5523 14.6666 12 14.2189 12 13.6666C12 13.1144 11.5523 12.6666 11 12.6666C10.4477 12.6666 10 13.1144 10 13.6666C10 14.2189 10.4477 14.6666 11 14.6666ZM5 7.11109C5.55228 7.11109 6 6.66338 6 6.11109C6 5.55881 5.55228 5.11109 5 5.11109C4.44772 5.11109 4 5.55881 4 6.11109C4 6.66338 4.44772 7.11109 5 7.11109ZM6 9.88888C6 10.4412 5.55228 10.8889 5 10.8889C4.44772 10.8889 4 10.4412 4 9.88888C4 9.33659 4.44772 8.88888 5 8.88888C5.55228 8.88888 6 9.33659 6 9.88888ZM5 14.6666C5.55228 14.6666 6 14.2189 6 13.6666C6 13.1144 5.55228 12.6666 5 12.6666C4.44772 12.6666 4 13.1144 4 13.6666C4 14.2189 4.44772 14.6666 5 14.6666Z"
+          fill="#3F59E4"
+        />
+      </svg>
+    </StyledDragHandleButton>
+  );
+};
+
+export const SortableItem = ({
+  id,
+  isDisabled,
+  isSelected,
+  isSortable = true,
+  children,
+}: PropsWithChildren<ItemProps>) => {
+  const {
+    attributes,
+    isDragging,
+    listeners,
+    setNodeRef,
+    setActivatorNodeRef,
+    transform,
+    transition,
+  } = useSortable({ id });
+
+  const context: SortableItemContextType = useMemo(
+    () => ({
+      attributes,
+      listeners,
+      // This library gives us a legacy ref function, and I can't change it, so I had to override the type. --Kevin Ghadyani
+      ref: setActivatorNodeRef as unknown as RefObject<HTMLButtonElement>,
+    }),
+    [attributes, listeners, setActivatorNodeRef],
+  );
+
+  const style: CSSProperties = {
+    opacity: isDragging ? 0.4 : undefined,
+    transform: CSS.Translate.toString(transform),
+    transition,
+  };
+
+  const uiShellContext = useUiShellContext();
+  const odysseyDesignTokens: DesignTokens = useOdysseyDesignTokens();
+
+  return (
+    <SortableItemContext.Provider value={context}>
+      <StyledSortableListItem
+        isSelected={isSelected}
+        odysseyDesignTokens={odysseyDesignTokens}
+        ref={setNodeRef}
+        sideNavContrastColors={uiShellContext?.sideNavContrastColors}
+        style={style}
+      >
+        {!isDisabled && isSortable && <DragHandle isDragging={isDragging} />}
+        <StyledUl>{children}</StyledUl>
+      </StyledSortableListItem>
+    </SortableItemContext.Provider>
+  );
+};

package/src/ui-shell/SideNav/SortableList/SortableList.tsx

@@ -0,0 +1,132 @@
+/*!
+ * Copyright (c) 2024-present, Okta, Inc. and/or its affiliates. All rights reserved.
+ * The Okta software accompanied by this notice is provided pursuant to the Apache License, Version 2.0 (the "License.")
+ *
+ * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * See the License for the specific language governing permissions and limitations under the License.
+ */
+
+import { Fragment, useMemo, useState } from "react";
+import type { ReactNode } from "react";
+import { useTranslation } from "react-i18next";
+import {
+  Active,
+  Announcements,
+  DndContext,
+  KeyboardSensor,
+  PointerSensor,
+  UniqueIdentifier,
+  useSensor,
+  useSensors,
+} from "@dnd-kit/core";
+import {
+  SortableContext,
+  sortableKeyboardCoordinates,
+} from "@dnd-kit/sortable";
+
+import { SortableItem } from "./SortableItem.js";
+import { SortableOverlay } from "./SortableOverlay.js";
+
+export interface BaseItem {
+  id: UniqueIdentifier;
+  isDisabled: boolean | undefined;
+  isSelected: boolean | undefined;
+  isSortable: boolean | undefined;
+  navItem: ReactNode;
+}
+
+interface ListProps<T extends BaseItem> {
+  parentId: string;
+  items: T[];
+  onChange: (
+    parentId: string,
+    activeId: UniqueIdentifier,
+    activeIndex: number,
+    overIndex: number,
+  ) => void;
+  renderItem: (item: T) => ReactNode;
+}
+
+export const SortableList = <T extends BaseItem>({
+  parentId,
+  items,
+  onChange,
+  renderItem,
+}: ListProps<T>) => {
+  const [active, setActive] = useState<Active | null>(null);
+
+  const activeItem = useMemo(
+    () => items.find((item) => item.id === active?.id),
+    [active, items],
+  );
+  const sensors = useSensors(
+    useSensor(PointerSensor),
+    useSensor(KeyboardSensor, {
+      coordinateGetter: sortableKeyboardCoordinates,
+    }),
+  );
+
+  const { t } = useTranslation();
+  const announcements: Announcements = useMemo(
+    () => ({
+      onDragStart: ({ active }) => {
+        return `${t("sortable.list.drag.start", { activeId: active.id })}`;
+      },
+      onDragOver: ({ active, over }) => {
+        if (over) {
+          return `${t("sortable.list.drag.moved.over", { activeId: active.id, overId: over.id })}`;
+        }
+        return `${t("sortable.list.drag.nolonger.over", { activeId: active.id })}`;
+      },
+      onDragEnd: ({ active, over }) => {
+        if (over) {
+          return `${t("sortable.list.drag.end.dropped.over", { activeId: active.id, overId: over.id })}`;
+        }
+        return `${t("sortable.list.drag.end.dropped", { activeId: active.id })}`;
+      },
+      onDragCancel: ({ active }) => {
+        return `${t("sortable.list.drag.cancel", { activeId: active.id })}`;
+      },
+    }),
+    [t],
+  );
+
+  return (
+    <DndContext
+      accessibility={{ announcements: announcements }}
+      sensors={sensors}
+      onDragStart={({ active }) => {
+        setActive(active);
+      }}
+      onDragEnd={({ active, over }) => {
+        if (over && active.id !== over?.id) {
+          const activeIndex = items.findIndex(({ id }) => id === active.id);
+          const overIndex = items.findIndex(({ id }) => id === over.id);
+          // allow sorting by default except when isSortable is set to false explicitly
+          if (items[overIndex].isSortable !== false) {
+            onChange(parentId, active.id, activeIndex, overIndex);
+          }
+        }
+        setActive(null);
+      }}
+      onDragCancel={() => {
+        setActive(null);
+      }}
+    >
+      <SortableContext items={items}>
+        {items.map((item) => (
+          <Fragment key={item.id}>{renderItem(item)}</Fragment>
+        ))}
+      </SortableContext>
+      <SortableOverlay>
+        {activeItem ? renderItem(activeItem) : null}
+      </SortableOverlay>
+    </DndContext>
+  );
+};
+
+SortableList.Item = SortableItem;