feat(fairies): add zodiac signs, viewport movement, and refactorings (tldraw#7238)

This PR adds zodiac sign support for fairies, implements viewport
movement controls for agents, and includes comprehensive code quality
improvements through refactoring.

**Key changes:**
- Added zodiac sign generation for fairies with all 12 signs (aquarius,
aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius,
capricorn, pisces)
- Implemented MovePositionAction to allow agents to control their
viewport position
- Enhanced fairy project view and task management
- Added fairy manual panel with improved UI labels and content
- Improved max shapes handling on document
- Refactored sprite system to use modular components
(FairyHatSpritePart, FairyBodySpritePart, FairyWingsSpritePart)
- Updated sprite poses and animations with refined timing and visual
polish
- Improved fairy manager initialization and lifecycle
- Standardized module naming: moved files to `fairy-*` namespace
convention
- Refactored FairyListSidebar to use hook-based entry logic
- Replaced useReactor with useQuickReactor in Fairy components for
better performance
- Added escape key handling to close context menus
- Refactored fairy interaction layer with updated rules section

### Change type

- [x] `feature`
- [x] `improvement`

### Test plan

1. Create a fairy and verify it has a zodiac sign assigned
2. Test agent viewport movement with MovePositionAction
3. Verify fairy project management workflows
4. Test max shapes handling
5. Verify sprite animations and poses render correctly
6. Check that all fairy module imports work correctly after file renames
7. Test escape key handling in context menus
8. Verify performance improvements from useQuickReactor changes

- [ ] Unit tests
- [ ] End to end tests

### Release notes

- Added zodiac sign support for fairies
- Added agent viewport movement controls
- Improved fairy sprite component modularity and animations
- Enhanced fairy manual UI and content
- Improved fairy component performance
- Standardized fairy module file naming conventions

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Add zodiac signs, agent viewport movement, and a major modular
refactor of fairies with new UI/manual, sprites, and performance
improvements.
> 
> - **Core/Architecture**
> - Introduce manager-based `fairy-agent` (chat, request, mode,
position, wait, usage, todo, gesture) and global atoms in
`fairy-globals`.
> - Replace legacy HUD/menus/sidebar with new `fairy-ui` (hooks, menus,
project, manual, chat history).
>   - Standardize paths to `fairy-*`; remove deprecated components.
> - **Actions/Schema**
> - Add `MovePositionAction` (move viewport center) and wire to manager.
>   - Extend focused shapes; disallow image creation via `create`.
>   - Update mode parts: add `sign` part; tweak prompt flags/rules.
> - **Features**
>   - Add zodiac sign support (`getRandomFairySign`, sign prompt part).
> - Feature flag to enable/disable fairies; hide watermark accordingly.
> - **UI/UX**
> - New Fairy Manual panel; refined labels (“Guide”, “Select/Deselect”,
“Go to”, etc.).
> - Rebuilt sidebar with hook-based grouping; improved
HUD/header/menu/context menu.
>   - Close context menus on Escape; follow/summon/select-all actions.
> - **Sprites/Animations**
> - Modular sprite parts (hat/body/wings); new poses (reviewing,
panicking) and wing cycles; timing polish.
> - **Performance/Behavior**
> - Use `useQuickReactor` for position updates; improved pointer
interaction and long-press feedback.
> - Handle max shapes by interrupting agents; refined wait/notify flows.
> - **Tooling/i18n**
> - ESLint rule exempts fairy files and blocks `fairy-shared` imports
outside.
>   - Update/enrich locales; add concise menu strings.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
d150dbe. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Kostya Farber <kostya.farber@gmail.com>
Co-authored-by: Steve Ruiz <steveruizok@gmail.com>
Co-authored-by: Mime Čuvalo <mimecuvalo@gmail.com>

Author: 4 people

apps/dotcom/client/public/tla/locales-compiled/en.json

@@ -63,6 +63,12 @@
       "value": "This file has reached its size limit and changes might no longer be saved. Remove some content or start a new file."
     }
   ],
+  "0ab1ef22a3": [
+    {
+      "type": 0,
+      "value": "Speak to the group…"
+    }
+  ],
   "0b27918290": [
     {
       "type": 0,
@@ -123,12 +129,6 @@
       "value": "Export as"
     }
   ],
-  "141c7239d3": [
-    {
-      "type": 0,
-      "value": "Fairy customization"
-    }
-  ],
   "146ffe2fd9": [
     {
       "type": 0,
@@ -159,18 +159,6 @@
       "value": "Today"
     }
   ],
-  "1fe250ea06": [
-    {
-      "type": 0,
-      "value": "Instruct the group…"
-    }
-  ],
-  "20dfc4f904": [
-    {
-      "type": 0,
-      "value": "Locate"
-    }
-  ],
   "23f879f41a": [
     {
       "type": 0,
@@ -219,12 +207,6 @@
       "value": "My files"
     }
   ],
-  "2db683a1fe": [
-    {
-      "type": 0,
-      "value": "Join selected fairies"
-    }
-  ],
   "30cd34258a": [
     {
       "type": 0,
@@ -281,12 +263,6 @@
       "value": "Please try refreshing the page."
     }
   ],
-  "33f9ea6fe8": [
-    {
-      "type": 0,
-      "value": "Disband group"
-    }
-  ],
   "34140869c6": [
     {
       "type": 0,
@@ -317,24 +293,12 @@
       "value": "Unfollow"
     }
   ],
-  "37169d1dc0": [
-    {
-      "type": 0,
-      "value": "Sleep fairies"
-    }
-  ],
   "3903aab323": [
     {
       "type": 0,
       "value": "Follow"
     }
   ],
-  "3a77f951ca": [
-    {
-      "type": 0,
-      "value": "Add a new task…"
-    }
-  ],
   "3b6c2b4caa": [
     {
       "type": 0,
@@ -425,6 +389,12 @@
       "value": "Name"
     }
   ],
+  "4c41e0bd95": [
+    {
+      "type": 0,
+      "value": "Select all"
+    }
+  ],
   "4d0d3ddec9": [
     {
       "type": 0,
@@ -621,16 +591,10 @@
       "value": "you"
     }
   ],
-  "64ebe56d8c": [
+  "6602bbeb29": [
     {
       "type": 0,
-      "value": "Click to remove or drag to move"
-    }
-  ],
-  "65709fd250": [
-    {
-      "type": 0,
-      "value": "Task list"
+      "value": "Guide"
     }
   ],
   "6609dd239e": [
@@ -783,12 +747,6 @@
       "value": "A fairy is a little guy that can work with you on the canvas. Fairies can work alone or as a team. There is no limit to what a fairy can do. Nobody knows where they came from."
     }
   ],
-  "7a3113b0ba": [
-    {
-      "type": 0,
-      "value": "Drag to canvas"
-    }
-  ],
   "7b1329f5ca": [
     {
       "type": 0,
@@ -909,12 +867,6 @@
       "value": " .tldr files."
     }
   ],
-  "86a7df7572": [
-    {
-      "type": 0,
-      "value": "Summon fairies"
-    }
-  ],
   "86c66437fd": [
     {
       "type": 0,
@@ -993,10 +945,10 @@
       "value": "Copied invite link"
     }
   ],
-  "93dfe9fbbe": [
+  "94186070ef": [
     {
       "type": 0,
-      "value": "Deselect fairy"
+      "value": "Deselect"
     }
   ],
   "94966d9074": [
@@ -1035,12 +987,6 @@
       "value": "Add file link"
     }
   ],
-  "98e528aac6": [
-    {
-      "type": 0,
-      "value": "Switch to fairy chat"
-    }
-  ],
   "9914a0ce04": [
     {
       "type": 0,
@@ -1127,10 +1073,10 @@
       "value": "Export image"
     }
   ],
-  "a2f0372a75": [
+  "a286d9991c": [
     {
       "type": 0,
-      "value": "Switch to task list"
+      "value": "Join"
     }
   ],
   "a3debabee7": [
@@ -1473,12 +1419,6 @@
       "value": "Theme"
     }
   ],
-  "d7bc9d5a2e": [
-    {
-      "type": 0,
-      "value": "Delete task"
-    }
-  ],
   "d876a9fe1a": [
     {
       "type": 0,
@@ -1497,6 +1437,12 @@
       "value": "Go here to see the content"
     }
   ],
+  "d9bfb9789a": [
+    {
+      "type": 0,
+      "value": "Enable fairies"
+    }
+  ],
   "d9e35d0f55": [
     {
       "type": 0,
@@ -1553,6 +1499,12 @@
       "value": "App debug flags"
     }
   ],
+  "e062622261": [
+    {
+      "type": 0,
+      "value": "Select"
+    }
+  ],
   "e0c88179b3": [
     {
       "type": 0,
@@ -1589,22 +1541,22 @@
       "value": "Terms of service"
     }
   ],
-  "e81c4e4f2b": [
+  "e43ec38a93": [
     {
       "type": 0,
-      "value": "or"
+      "value": "Go to"
     }
   ],
-  "ea0626ac5a": [
+  "e81c4e4f2b": [
     {
       "type": 0,
-      "value": "Danger zone"
+      "value": "or"
     }
   ],
-  "ea181d98ca": [
+  "ea0626ac5a": [
     {
       "type": 0,
-      "value": "Select fairy"
+      "value": "Danger zone"
     }
   ],
   "ea4788705e": [
@@ -1663,22 +1615,22 @@
       "value": " to learn more."
     }
   ],
-  "ef53538ae4": [
+  "eee6f05922": [
     {
       "type": 0,
-      "value": "Members"
+      "value": "Disband"
     }
   ],
-  "ef7de3f485": [
+  "ef53538ae4": [
     {
       "type": 0,
-      "value": "selected"
+      "value": "Members"
     }
   ],
-  "efb2d9d471": [
+  "ef7de3f485": [
     {
       "type": 0,
-      "value": "Todo list"
+      "value": "selected"
     }
   ],
   "efde983742": [
@@ -1699,12 +1651,6 @@
       "value": "User settings"
     }
   ],
-  "f23056da60": [
-    {
-      "type": 0,
-      "value": "New project"
-    }
-  ],
   "f2569594b2": [
     {
       "type": 0,
@@ -1729,12 +1675,6 @@
       "value": "Are you sure you want to leave this group?"
     }
   ],
-  "f7d5ee6855": [
-    {
-      "type": 0,
-      "value": "Select a leader first…"
-    }
-  ],
   "fa2ead697d": [
     {
       "type": 0,
@@ -1747,24 +1687,12 @@
       "value": "Viewer"
     }
   ],
-  "fd11eafb92": [
-    {
-      "type": 0,
-      "value": "Disband projects"
-    }
-  ],
   "fd1be3efcf": [
     {
       "type": 0,
       "value": "Are you sure you want to delete this file?"
     }
   ],
-  "fe0a4f9d0a": [
-    {
-      "type": 0,
-      "value": "Clear chats"
-    }
-  ],
   "fed5ec05eb": [
     {
       "type": 0,