Integrate NavigationMenuItem with feature flag support (#17268)

## Implement Navigation Menu Items Frontend

Implements the frontend for navigation menu items, the new system
replacing favorites.

### Changes
- Added GraphQL fragments and queries for navigation menu items
- Added hooks for managing navigation menu items (create, update,
delete, sorting, filtering)
- Updated components to use navigation menu items instead of favorites
- Added test coverage for utility functions

### Migration Note
The favorites and navigation menu item modules currently exist in
parallel. The favorites code will be removed once all data has been
migrated to navigation menu items.

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Replaces Favorites with feature-flagged `NavigationMenuItem` across
frontend and backend, while keeping Favorites as fallback until
migration completes.
> 
> - UI: new `navigation-menu-item` components (folders, orphan items,
drag provider/droppable, icons, skeleton), dispatcher components to
switch from Favorites, and updated “Add to favorites” action to create
`NavigationMenuItem` when `IS_NAVIGATION_MENU_ITEM_ENABLED`
> - DnD: shared `validateAndExtractFolderId` and droppable id utils
moved to `ui/layout/draggable-list`; favorites DnD updated to use shared
utils
> - GraphQL (client): add fragments, queries, mutations, hooks
(create/update/delete/find), and generated types; added
`RecordIdentifier` and `targetRecordIdentifier` on `NavigationMenuItem`
> - Prefetch: new prefetch state/effect for navigation menu items; skip
favorites prefetch when flag enabled
> - Backend: add DTOs (`NavigationMenuItem`, `RecordIdentifier`),
resolver `targetRecordIdentifier` field, service logic to fetch record
identifiers with permission-aware access and image signing,
`getRecordImageIdentifier` util, entity relation to `view`, and
migration adding FK on `viewId`
> - Feature flags & seeding: add `IS_NAVIGATION_MENU_ITEM_ENABLED` to
enums, dev seeder enables it; standard app seeds workspace navigation
menu items instead of favorites when flag on
> - Tests: add unit tests for sorting/labels/folder id and related utils
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
c99746f08b9f84fc8cec4fcc3a7d7afb8ea92db7. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Félix Malfait <felix.malfait@gmail.com>
Co-authored-by: Aman Raj <92664006+araj00@users.noreply.github.com>
Co-authored-by: Félix Malfait <felix@twenty.com>
Co-authored-by: Paul Rastoin <45004772+prastoin@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions <github-actions@twenty.com>

packages/twenty-front/src/modules/ui/layout/draggable-list/utils/calculateNewPosition.ts

@@ -0,0 +1,34 @@
+type CalculateNewPositionParams = {
+  destinationIndex: number;
+  sourceIndex: number;
+  items: Array<{ position: number }>;
+};
+
+export const calculateNewPosition = ({
+  destinationIndex,
+  sourceIndex,
+  items,
+}: CalculateNewPositionParams): number => {
+  if (destinationIndex === 0) {
+    return items[0].position - 1;
+  }
+
+  if (destinationIndex === items.length) {
+    return items[items.length - 1].position + 1;
+  }
+
+  if (destinationIndex > sourceIndex) {
+    return (
+      items[destinationIndex].position +
+      (items[destinationIndex - 1].position -
+        items[destinationIndex].position) /
+        2
+    );
+  }
+
+  return (
+    items[destinationIndex].position -
+    (items[destinationIndex].position - items[destinationIndex - 1].position) /
+      2
+  );
+};

packages/twenty-front/src/modules/ui/layout/draggable-list/utils/folderDroppableIds.ts

@@ -0,0 +1,4 @@
+export const FOLDER_DROPPABLE_IDS = {
+  FOLDER_PREFIX: 'folder-',
+  FOLDER_HEADER_PREFIX: 'folder-header-',
+} as const;

packages/twenty-front/src/modules/ui/layout/draggable-list/utils/validateAndExtractFolderId.ts

@@ -0,0 +1,48 @@
+import { CustomError } from 'twenty-shared/utils';
+import { FOLDER_DROPPABLE_IDS } from './folderDroppableIds';
+
+type ValidateAndExtractFolderIdParams = {
+  droppableId: string;
+  // TODO: Remove orphanDroppableId prop when deleting all favorites code
+  orphanDroppableId: string;
+};
+
+export const validateAndExtractFolderId = ({
+  droppableId,
+  orphanDroppableId,
+}: ValidateAndExtractFolderIdParams): string | null => {
+  if (droppableId === orphanDroppableId) {
+    return null;
+  }
+
+  if (droppableId.startsWith(FOLDER_DROPPABLE_IDS.FOLDER_HEADER_PREFIX)) {
+    const folderId = droppableId.replace(
+      FOLDER_DROPPABLE_IDS.FOLDER_HEADER_PREFIX,
+      '',
+    );
+    if (!folderId)
+      throw new CustomError(
+        `Invalid folder header ID: ${droppableId}`,
+        'INVALID_FOLDER_HEADER_ID',
+      );
+    return folderId;
+  }
+
+  if (droppableId.startsWith(FOLDER_DROPPABLE_IDS.FOLDER_PREFIX)) {
+    const folderId = droppableId.replace(
+      FOLDER_DROPPABLE_IDS.FOLDER_PREFIX,
+      '',
+    );
+    if (!folderId)
+      throw new CustomError(
+        `Invalid folder ID: ${droppableId}`,
+        'INVALID_FOLDER_ID',
+      );
+    return folderId;
+  }
+
+  throw new CustomError(
+    `Invalid droppable ID format: ${droppableId}`,
+    'INVALID_DROPPABLE_ID_FORMAT',
+  );
+};

packages/twenty-front/src/modules/ui/navigation/navigation-drawer/states/currentNavigationMenuItemFolderIdState.ts

@@ -0,0 +1,6 @@
+import { atom } from 'recoil';
+
+export const currentNavigationMenuItemFolderIdState = atom<string | null>({
+  key: 'currentNavigationMenuItemFolderIdState',
+  default: null,
+});