Refactor useDropdownV2 (#12875)

# What this PR does This PR introduces what’s needed to progressively refactor the useDropdown hooks we have. It removes useDropdownV2 and renames useDropdown used for multi-page dropdowns to useDropdownContextStateManagement ## The 3 useDropdown hooks There are currently 3 useDropdown hooks : One is used for managing states in some dropdowns that have multiple inner pages with contexts and without recoil. It is limited and would need a separate refactoring, thus I just renamed it. Then we have useDropdown and useDropdownV2, which followed our multiple versions of recoil state management wrappers. Now that the state management has been stabilized, we can merge everything on the last version. ## What this refactor will allow next This refactor will allow to refactor the legacy recoil state management, because useDropdown is depending on legacy recoil states with scopeId. Because there are only a dozen of those legacy states left, and the dropdown’s ones are the harder to refactor, because swapping them as-is causes a big QA, and if we have a big QA to do on all dropdowns, better refactor the whole dropdown management and have everything clean. After this refactor, we will be able to delete the legacy dropdown states, and proceed with the other legacy states, then removing all the legacy recoil state mangament. ## How do we allow progressive refactoring ? There are many places where useDropdown is used. To have an easier refactoring process, we want to merge multiple small pull requests so that it is easier to QA and review. For this we will maintain both legacy component state and component state V2 in parallel for isDropdownOpen, so that the new hooks `useOpenDropdown` , `useCloseDropdown` are doing the same thing than `useDropdown` and `useDropdownV2` . Thus for the moment, whether we use the legacy hooks or the new ones, the effects are the same. And we can have dropdowns operating on the old states and the new states living side by side in the app. ## QA Component | Status | Comments -- | -- | -- CommandMenuActionMenuDropdown | Ok | RecordIndexActionMenuDropdown | Ok | RecordShowRightDrawerOpenRecordButton | Ok | useCloseActionMenu | Ok | CommandMenuContextChipGroups | Ok | useCommandMenuCloseAnimationCompleteCleanup | Ok | ObjectOptionsDropdown | Ok | ObjectOptionsDropdownContent | Ok | ObjectOptionsDropdownFieldsContent | Ok | ObjectOptionsDropdownHiddenFieldsContent | Ok | ObjectOptionsDropdownHiddenRecordGroupsContent | Ok | ObjectOptionsDropdownLayoutContent | Ok | ObjectOptionsDropdownLayoutOpenInContent | Ok | ObjectOptionsDropdownMenuContent | Ok | ObjectOptionsDropdownRecordGroupFieldsContent | Ok | ObjectOptionsDropdownRecordGroupsContent | Ok | ObjectOptionsDropdownRecordGroupSortContent | Ok | RecordBoardColumnHeaderAggregateDropdown | Ok | AggregateDropdownContent | Ok | RecordBoardColumnHeaderAggregateDropdownFieldsContent | Ok | RecordBoardColumnHeaderAggregateDropdownMenuContent | Ok | RecordBoardColumnHeaderAggregateDropdownMenuContent | Ok | RecordBoardColumnHeaderAggregateDropdownOptionsContent | Ok | RecordBoard | Ok | Used closeAnyOpenDropdown instead for a better UX RecordBoardCard | Ok | useRecordBoardSelection | Ok | RecordTableColumnAggregateFooterDropdownContent | Ok | RecordTableColumnFooterWithDropdown | Ok | useOpenRecordFilterChipFromTableHeader | Ok | useCloseAnyOpenDropdown | Ok | useCloseDropdownFromOutside | Removed | Removed because unused useDropdownV2 | Removed | Removed because all calls have been removed useOpenDropdownFromOutside | Removed | Removed because unused useCloseAndResetViewPicker | Ok | WorkflowVariablesDropdown | Ok |
2025-06-25 17:16:56 +02:00
parent 74f53cc759
commit 22b4595b0b
55 changed files with 399 additions and 267 deletions
@@ -2,7 +2,7 @@ import { DropdownOnToggleEffect } from '@/ui/layout/dropdown/components/Dropdown
 import { DropdownInternalContainer } from '@/ui/layout/dropdown/components/internal/DropdownInternalContainer';
 import { DROPDOWN_RESIZE_MIN_HEIGHT } from '@/ui/layout/dropdown/constants/DropdownResizeMinHeight';
 import { DROPDOWN_RESIZE_MIN_WIDTH } from '@/ui/layout/dropdown/constants/DropdownResizeMinWidth';
-import { DropdownComponentInstanceContext } from '@/ui/layout/dropdown/contexts/DropdownComponeInstanceContext';
+import { DropdownComponentInstanceContext } from '@/ui/layout/dropdown/contexts/DropdownComponentInstanceContext';
 import { DropdownScope } from '@/ui/layout/dropdown/scopes/DropdownScope';
 import { dropdownMaxHeightComponentState } from '@/ui/layout/dropdown/states/internal/dropdownMaxHeightComponentState';
 import { dropdownMaxWidthComponentState } from '@/ui/layout/dropdown/states/internal/dropdownMaxWidthComponentState';
@@ -0,0 +1 @@
+export const DROPDOWN_OFFSET_Y = 8;
@@ -0,0 +1 @@
+export const DROPDOWN_WIDTH = '200px';
@@ -3,20 +3,36 @@ import { renderHook } from '@testing-library/react';
 import { act } from 'react';
 import { RecoilRoot } from 'recoil';

+import { DropdownComponentInstanceContext } from '@/ui/layout/dropdown/contexts/DropdownComponentInstanceContext';
 import { useCloseAnyOpenDropdown } from '@/ui/layout/dropdown/hooks/useCloseAnyOpenDropdown';
-import { useDropdown } from '@/ui/layout/dropdown/hooks/useDropdown';
+import { useOpenDropdown } from '@/ui/layout/dropdown/hooks/useOpenDropdown';
+import { isDropdownOpenComponentStateV2 } from '@/ui/layout/dropdown/states/isDropdownOpenComponentStateV2';
+import { useRecoilComponentValueV2 } from '@/ui/utilities/state/component-state/hooks/useRecoilComponentValueV2';

 const dropdownId = 'test-dropdown-id';

 const Wrapper = ({ children }: { children: React.ReactNode }) => {
-  return <RecoilRoot>{children}</RecoilRoot>;
+  return (
+    <RecoilRoot>
+      <DropdownComponentInstanceContext.Provider
+        value={{ instanceId: dropdownId }}
+      >
+        {children}
+      </DropdownComponentInstanceContext.Provider>
+    </RecoilRoot>
+  );
 };

 describe('useCloseAnyOpenDropdown', () => {
  it('should open dropdown and then close it with closeAnyOpenDropdown', async () => {
    const { result } = renderHook(
      () => {
-        const { openDropdown, isDropdownOpen } = useDropdown(dropdownId);
+        const isDropdownOpen = useRecoilComponentValueV2(
+          isDropdownOpenComponentStateV2,
+          dropdownId,
+        );
+
+        const { openDropdown } = useOpenDropdown();

        const { closeAnyOpenDropdown } = useCloseAnyOpenDropdown();

@@ -1,43 +0,0 @@
-import { expect } from '@storybook/test';
-import { renderHook } from '@testing-library/react';
-import { act } from 'react';
-import { RecoilRoot } from 'recoil';
-
-import { useCloseDropdownFromOutside } from '@/ui/layout/dropdown/hooks/useCloseDropdownFromOutside';
-import { useDropdown } from '@/ui/layout/dropdown/hooks/useDropdown';
-
-const dropdownId = 'test-dropdown-id';
-
-const Wrapper = ({ children }: { children: React.ReactNode }) => {
-  return <RecoilRoot>{children}</RecoilRoot>;
-};
-
-describe('useCloseDropdownFromOutside', () => {
-  it('should close open dropdown', async () => {
-    const { result } = renderHook(
-      () => {
-        const { isDropdownOpen, openDropdown } = useDropdown(dropdownId);
-        const { closeDropdownFromOutside } = useCloseDropdownFromOutside();
-
-        return { closeDropdownFromOutside, isDropdownOpen, openDropdown };
-      },
-      {
-        wrapper: Wrapper,
-      },
-    );
-
-    expect(result.current.isDropdownOpen).toBe(false);
-
-    act(() => {
-      result.current.openDropdown();
-    });
-
-    expect(result.current.isDropdownOpen).toBe(true);
-
-    act(() => {
-      result.current.closeDropdownFromOutside(dropdownId);
-    });
-
-    expect(result.current.isDropdownOpen).toBe(false);
-  });
-});
@@ -1,4 +1,4 @@
-import { useCloseDropdownFromOutside } from '@/ui/layout/dropdown/hooks/useCloseDropdownFromOutside';
+import { useCloseDropdown } from '@/ui/layout/dropdown/hooks/useCloseDropdown';
 import { activeDropdownFocusIdState } from '@/ui/layout/dropdown/states/activeDropdownFocusIdState';
 import { previousDropdownFocusIdState } from '@/ui/layout/dropdown/states/previousDropdownFocusIdState';
 import { useRemoveFocusItemFromFocusStackById } from '@/ui/utilities/focus/hooks/useRemoveFocusItemFromFocusStackById';
@@ -6,7 +6,7 @@ import { useRecoilCallback } from 'recoil';
 import { isDefined } from 'twenty-shared/utils';

 export const useCloseAnyOpenDropdown = () => {
-  const { closeDropdownFromOutside } = useCloseDropdownFromOutside();
+  const { closeDropdown } = useCloseDropdown();

  const { removeFocusItemFromFocusStackById } =
    useRemoveFocusItemFromFocusStackById();
@@ -33,14 +33,14 @@ export const useCloseAnyOpenDropdown = () => {
        const thereIsOneNestedDropdownOpen = isDefined(previousDropdownFocusId);

        if (isDefined(activeDropdownFocusId)) {
-          closeDropdownFromOutside(activeDropdownFocusId);
+          closeDropdown(activeDropdownFocusId);
          removeFocusItemFromFocusStackById({
            focusId: activeDropdownFocusId,
          });
        }

        if (thereIsOneNestedDropdownOpen) {
-          closeDropdownFromOutside(previousDropdownFocusId);
+          closeDropdown(previousDropdownFocusId);
          removeFocusItemFromFocusStackById({
            focusId: previousDropdownFocusId,
          });
@@ -49,7 +49,7 @@ export const useCloseAnyOpenDropdown = () => {
        set(previousDropdownFocusIdState, null);
        set(activeDropdownFocusIdState, null);
      },
-    [closeDropdownFromOutside, removeFocusItemFromFocusStackById],
+    [closeDropdown, removeFocusItemFromFocusStackById],
  );

  return { closeAnyOpenDropdown };
@@ -0,0 +1,79 @@
+import { DropdownComponentInstanceContext } from '@/ui/layout/dropdown/contexts/DropdownComponentInstanceContext';
+import { useGoBackToPreviousDropdownFocusId } from '@/ui/layout/dropdown/hooks/useGoBackToPreviousDropdownFocusId';
+import { isDropdownOpenComponentState } from '@/ui/layout/dropdown/states/isDropdownOpenComponentState';
+import { isDropdownOpenComponentStateV2 } from '@/ui/layout/dropdown/states/isDropdownOpenComponentStateV2';
+import { useRemoveFocusItemFromFocusStackById } from '@/ui/utilities/focus/hooks/useRemoveFocusItemFromFocusStackById';
+import { useAvailableComponentInstanceId } from '@/ui/utilities/state/component-state/hooks/useAvailableComponentInstanceId';
+import { useRecoilCallback } from 'recoil';
+import { isDefined } from 'twenty-shared/utils';
+
+export const useCloseDropdown = () => {
+  const { goBackToPreviousDropdownFocusId } =
+    useGoBackToPreviousDropdownFocusId();
+
+  const { removeFocusItemFromFocusStackById } =
+    useRemoveFocusItemFromFocusStackById();
+
+  const dropdownComponentInstanceIdFromContext =
+    useAvailableComponentInstanceId(DropdownComponentInstanceContext);
+
+  const closeDropdown = useRecoilCallback(
+    ({ set, snapshot }) =>
+      (dropdownComponentInstanceIdFromProps?: string) => {
+        const dropdownComponentInstanceId =
+          dropdownComponentInstanceIdFromProps ??
+          dropdownComponentInstanceIdFromContext;
+
+        if (!isDefined(dropdownComponentInstanceId)) {
+          throw new Error('Dropdown component instance ID is not defined');
+        }
+
+        const isDropdownOpen = snapshot
+          .getLoadable(
+            isDropdownOpenComponentStateV2.atomFamily({
+              instanceId: dropdownComponentInstanceId,
+            }),
+          )
+          .getValue();
+
+        const isDropdownOpenLegacy = snapshot
+          .getLoadable(
+            isDropdownOpenComponentState({
+              scopeId: dropdownComponentInstanceId,
+            }),
+          )
+          .getValue();
+
+        if (isDropdownOpen || isDropdownOpenLegacy) {
+          removeFocusItemFromFocusStackById({
+            focusId: dropdownComponentInstanceId,
+          });
+
+          goBackToPreviousDropdownFocusId();
+
+          set(
+            isDropdownOpenComponentStateV2.atomFamily({
+              instanceId: dropdownComponentInstanceId,
+            }),
+            false,
+          );
+
+          set(
+            isDropdownOpenComponentState({
+              scopeId: dropdownComponentInstanceId,
+            }),
+            false,
+          );
+        }
+      },
+    [
+      removeFocusItemFromFocusStackById,
+      goBackToPreviousDropdownFocusId,
+      dropdownComponentInstanceIdFromContext,
+    ],
+  );
+
+  return {
+    closeDropdown,
+  };
+};
@@ -1,14 +0,0 @@
-import { isDropdownOpenComponentState } from '@/ui/layout/dropdown/states/isDropdownOpenComponentState';
-import { useRecoilCallback } from 'recoil';
-
-export const useCloseDropdownFromOutside = () => {
-  const closeDropdownFromOutside = useRecoilCallback(
-    ({ set }) =>
-      (dropdownId: string) => {
-        set(isDropdownOpenComponentState({ scopeId: dropdownId }), false);
-      },
-    [],
-  );
-
-  return { closeDropdownFromOutside };
-};
@@ -10,6 +10,13 @@ import { GlobalHotkeysConfig } from '@/ui/utilities/hotkey/types/GlobalHotkeysCo
 import { HotkeyScope } from '@/ui/utilities/hotkey/types/HotkeyScope';
 import { useCallback } from 'react';

+/**
+ *
+ * @deprecated This hook is deprecated, use a specific hook instead :
+ * - `useOpenDropdown`
+ * - `useCloseDropdown`
+ * - `useToggleDropdown`
+ */
 export const useDropdown = (dropdownId?: string) => {
  const { pushFocusItemToFocusStack } = usePushFocusItemToFocusStack();
  const { removeFocusItemFromFocusStackById } =
@@ -1,106 +0,0 @@
-import { useRecoilCallback } from 'recoil';
-
-import { useGoBackToPreviousDropdownFocusId } from '@/ui/layout/dropdown/hooks/useGoBackToPreviousDropdownFocusId';
-import { useSetActiveDropdownFocusIdAndMemorizePrevious } from '@/ui/layout/dropdown/hooks/useSetFocusedDropdownIdAndMemorizePrevious';
-import { isDropdownOpenComponentState } from '@/ui/layout/dropdown/states/isDropdownOpenComponentState';
-import { usePushFocusItemToFocusStack } from '@/ui/utilities/focus/hooks/usePushFocusItemToFocusStack';
-import { useRemoveFocusItemFromFocusStackById } from '@/ui/utilities/focus/hooks/useRemoveFocusItemFromFocusStackById';
-import { FocusComponentType } from '@/ui/utilities/focus/types/FocusComponentType';
-import { GlobalHotkeysConfig } from '@/ui/utilities/hotkey/types/GlobalHotkeysConfig';
-import { HotkeyScope } from '@/ui/utilities/hotkey/types/HotkeyScope';
-
-export const useDropdownV2 = () => {
-  const { goBackToPreviousDropdownFocusId } =
-    useGoBackToPreviousDropdownFocusId();
-
-  const { pushFocusItemToFocusStack } = usePushFocusItemToFocusStack();
-
-  const { removeFocusItemFromFocusStackById } =
-    useRemoveFocusItemFromFocusStackById();
-
-  const { setActiveDropdownFocusIdAndMemorizePrevious } =
-    useSetActiveDropdownFocusIdAndMemorizePrevious();
-
-  const closeDropdown = useRecoilCallback(
-    ({ set, snapshot }) =>
-      (specificComponentId: string) => {
-        const scopeId = specificComponentId;
-
-        const isDropdownOpen = snapshot
-          .getLoadable(isDropdownOpenComponentState({ scopeId }))
-          .getValue();
-
-        if (isDropdownOpen) {
-          removeFocusItemFromFocusStackById({
-            focusId: scopeId,
-          });
-          goBackToPreviousDropdownFocusId();
-          set(
-            isDropdownOpenComponentState({
-              scopeId,
-            }),
-            false,
-          );
-        }
-      },
-    [removeFocusItemFromFocusStackById, goBackToPreviousDropdownFocusId],
-  );
-
-  const openDropdown = useRecoilCallback(
-    ({ set }) =>
-      (
-        specificComponentId: string,
-        globalHotkeysConfig?: Partial<GlobalHotkeysConfig>,
-      ) => {
-        const scopeId = specificComponentId;
-
-        set(
-          isDropdownOpenComponentState({
-            scopeId,
-          }),
-          true,
-        );
-
-        setActiveDropdownFocusIdAndMemorizePrevious(specificComponentId);
-
-        pushFocusItemToFocusStack({
-          focusId: scopeId,
-          component: {
-            type: FocusComponentType.DROPDOWN,
-            instanceId: scopeId,
-          },
-          globalHotkeysConfig,
-          // TODO: Remove this once we've fully migrated away from hotkey scopes
-          hotkeyScope: { scope: 'dropdown' } as HotkeyScope,
-          memoizeKey: 'global',
-        });
-      },
-    [pushFocusItemToFocusStack, setActiveDropdownFocusIdAndMemorizePrevious],
-  );
-
-  const toggleDropdown = useRecoilCallback(
-    ({ snapshot }) =>
-      (
-        specificComponentId: string,
-        globalHotkeysConfig?: Partial<GlobalHotkeysConfig>,
-      ) => {
-        const scopeId = specificComponentId;
-        const isDropdownOpen = snapshot
-          .getLoadable(isDropdownOpenComponentState({ scopeId }))
-          .getValue();
-
-        if (isDropdownOpen) {
-          closeDropdown(specificComponentId);
-        } else {
-          openDropdown(specificComponentId, globalHotkeysConfig);
-        }
-      },
-    [closeDropdown, openDropdown],
-  );
-
-  return {
-    closeDropdown,
-    openDropdown,
-    toggleDropdown,
-  };
-};
@@ -0,0 +1,77 @@
+import { DropdownComponentInstanceContext } from '@/ui/layout/dropdown/contexts/DropdownComponentInstanceContext';
+import { useSetActiveDropdownFocusIdAndMemorizePrevious } from '@/ui/layout/dropdown/hooks/useSetFocusedDropdownIdAndMemorizePrevious';
+import { isDropdownOpenComponentState } from '@/ui/layout/dropdown/states/isDropdownOpenComponentState';
+import { isDropdownOpenComponentStateV2 } from '@/ui/layout/dropdown/states/isDropdownOpenComponentStateV2';
+import { usePushFocusItemToFocusStack } from '@/ui/utilities/focus/hooks/usePushFocusItemToFocusStack';
+import { FocusComponentType } from '@/ui/utilities/focus/types/FocusComponentType';
+import { GlobalHotkeysConfig } from '@/ui/utilities/hotkey/types/GlobalHotkeysConfig';
+import { HotkeyScope } from '@/ui/utilities/hotkey/types/HotkeyScope';
+import { useAvailableComponentInstanceId } from '@/ui/utilities/state/component-state/hooks/useAvailableComponentInstanceId';
+import { useRecoilCallback } from 'recoil';
+import { isDefined } from 'twenty-shared/utils';
+
+type OpenDropdownArgs = {
+  dropdownComponentInstanceIdFromProps?: string;
+  globalHotkeysConfig?: Partial<GlobalHotkeysConfig>;
+};
+
+export const useOpenDropdown = () => {
+  const { pushFocusItemToFocusStack } = usePushFocusItemToFocusStack();
+
+  const { setActiveDropdownFocusIdAndMemorizePrevious } =
+    useSetActiveDropdownFocusIdAndMemorizePrevious();
+  const dropdownComponentInstanceIdFromContext =
+    useAvailableComponentInstanceId(DropdownComponentInstanceContext);
+
+  const openDropdown = useRecoilCallback(
+    ({ set }) =>
+      (args?: OpenDropdownArgs | null | undefined) => {
+        const dropdownComponentInstanceId =
+          args?.dropdownComponentInstanceIdFromProps ??
+          dropdownComponentInstanceIdFromContext;
+
+        if (!isDefined(dropdownComponentInstanceId)) {
+          throw new Error('Dropdown component instance ID is not defined');
+        }
+
+        set(
+          isDropdownOpenComponentState({
+            scopeId: dropdownComponentInstanceId,
+          }),
+          true,
+        );
+
+        set(
+          isDropdownOpenComponentStateV2.atomFamily({
+            instanceId: dropdownComponentInstanceId,
+          }),
+          true,
+        );
+
+        setActiveDropdownFocusIdAndMemorizePrevious(
+          dropdownComponentInstanceId,
+        );
+
+        pushFocusItemToFocusStack({
+          focusId: dropdownComponentInstanceId,
+          component: {
+            type: FocusComponentType.DROPDOWN,
+            instanceId: dropdownComponentInstanceId,
+          },
+          globalHotkeysConfig: args?.globalHotkeysConfig ?? undefined,
+          // TODO: Remove this once we've fully migrated away from hotkey scopes
+          hotkeyScope: { scope: 'dropdown' } as HotkeyScope,
+          memoizeKey: 'global',
+        });
+      },
+    [
+      pushFocusItemToFocusStack,
+      setActiveDropdownFocusIdAndMemorizePrevious,
+      dropdownComponentInstanceIdFromContext,
+    ],
+  );
+
+  return {
+    openDropdown,
+  };
+};
@@ -0,0 +1,66 @@
+import { DropdownComponentInstanceContext } from '@/ui/layout/dropdown/contexts/DropdownComponentInstanceContext';
+import { useCloseDropdown } from '@/ui/layout/dropdown/hooks/useCloseDropdown';
+import { useOpenDropdown } from '@/ui/layout/dropdown/hooks/useOpenDropdown';
+import { isDropdownOpenComponentState } from '@/ui/layout/dropdown/states/isDropdownOpenComponentState';
+import { isDropdownOpenComponentStateV2 } from '@/ui/layout/dropdown/states/isDropdownOpenComponentStateV2';
+import { GlobalHotkeysConfig } from '@/ui/utilities/hotkey/types/GlobalHotkeysConfig';
+import { useAvailableComponentInstanceId } from '@/ui/utilities/state/component-state/hooks/useAvailableComponentInstanceId';
+import { useRecoilCallback } from 'recoil';
+import { isDefined } from 'twenty-shared/utils';
+
+export const useToggleDropdown = () => {
+  const dropdownComponentInstanceIdFromContext =
+    useAvailableComponentInstanceId(DropdownComponentInstanceContext);
+
+  const { openDropdown } = useOpenDropdown();
+  const { closeDropdown } = useCloseDropdown();
+
+  const toggleDropdown = useRecoilCallback(
+    ({ snapshot }) =>
+      ({
+        dropdownComponentInstanceIdFromProps,
+        globalHotkeysConfig,
+      }: {
+        dropdownComponentInstanceIdFromProps?: string;
+        globalHotkeysConfig?: Partial<GlobalHotkeysConfig>;
+      }) => {
+        const dropdownComponentInstanceId =
+          dropdownComponentInstanceIdFromProps ??
+          dropdownComponentInstanceIdFromContext;
+
+        if (!isDefined(dropdownComponentInstanceId)) {
+          throw new Error('Dropdown component instance ID is not defined');
+        }
+
+        const isDropdownOpen = snapshot
+          .getLoadable(
+            isDropdownOpenComponentStateV2.atomFamily({
+              instanceId: dropdownComponentInstanceId,
+            }),
+          )
+          .getValue();
+
+        const isDropdownOpenLegacy = snapshot
+          .getLoadable(
+            isDropdownOpenComponentState({
+              scopeId: dropdownComponentInstanceId,
+            }),
+          )
+          .getValue();
+
+        if (isDropdownOpen || isDropdownOpenLegacy) {
+          closeDropdown(dropdownComponentInstanceId);
+        } else {
+          openDropdown({
+            dropdownComponentInstanceIdFromProps: dropdownComponentInstanceId,
+            globalHotkeysConfig,
+          });
+        }
+      },
+    [closeDropdown, openDropdown, dropdownComponentInstanceIdFromContext],
+  );
+
+  return {
+    toggleDropdown,
+  };
+};
@@ -1,4 +1,5 @@
 import { createState } from 'twenty-ui/utilities';
+
 export const activeDropdownFocusIdState = createState<string | null>({
  key: 'activeDropdownFocusIdState',
  defaultValue: null,
@@ -1,4 +1,4 @@
-import { DropdownComponentInstanceContext } from '@/ui/layout/dropdown/contexts/DropdownComponeInstanceContext';
+import { DropdownComponentInstanceContext } from '@/ui/layout/dropdown/contexts/DropdownComponentInstanceContext';
 import { createComponentStateV2 } from '@/ui/utilities/state/component-state/utils/createComponentStateV2';

 export const dropdownMaxHeightComponentState = createComponentStateV2<
@@ -1,4 +1,4 @@
-import { DropdownComponentInstanceContext } from '@/ui/layout/dropdown/contexts/DropdownComponeInstanceContext';
+import { DropdownComponentInstanceContext } from '@/ui/layout/dropdown/contexts/DropdownComponentInstanceContext';
 import { createComponentStateV2 } from '@/ui/utilities/state/component-state/utils/createComponentStateV2';

 export const dropdownMaxWidthComponentState = createComponentStateV2<
@@ -1,5 +1,8 @@
 import { createComponentState } from '@/ui/utilities/state/component-state/utils/createComponentState';

+/**
+ * @deprecated Use `isDropdownOpenComponentStateV2` instead.
+ */
 export const isDropdownOpenComponentState = createComponentState<boolean>({
  key: 'isDropdownOpenComponentState',
  defaultValue: false,
@@ -0,0 +1,8 @@
+import { DropdownComponentInstanceContext } from '@/ui/layout/dropdown/contexts/DropdownComponentInstanceContext';
+import { createComponentStateV2 } from '@/ui/utilities/state/component-state/utils/createComponentStateV2';
+
+export const isDropdownOpenComponentStateV2 = createComponentStateV2<boolean>({
+  key: 'isDropdownOpenComponentStateV2',
+  defaultValue: false,
+  componentInstanceContext: DropdownComponentInstanceContext,
+});
@@ -1,4 +1,5 @@
 import { createState } from 'twenty-ui/utilities';
+
 export const previousDropdownFocusIdState = createState<string | null>({
  key: 'previousDropdownFocusIdState',
  defaultValue: null,
@@ -0,0 +1,19 @@
+import { useComponentInstanceStateContext } from '@/ui/utilities/state/component-state/hooks/useComponentInstanceStateContext';
+import { ComponentInstanceStateContext } from '@/ui/utilities/state/component-state/types/ComponentInstanceStateContext';
+import { isNonEmptyString } from '@sniptt/guards';
+
+export const useAvailableComponentInstanceId = <
+  T extends { instanceId: string },
+>(
+  Context: ComponentInstanceStateContext<T>,
+): string | null => {
+  const instanceStateContext = useComponentInstanceStateContext(Context);
+
+  const instanceIdFromContext = instanceStateContext?.instanceId;
+
+  if (isNonEmptyString(instanceIdFromContext)) {
+    return instanceIdFromContext;
+  } else {
+    return null;
+  }
+};