feat: graduate list collaboration to stable

CONTEXT.md

@@ -0,0 +1,24 @@
+# Domain Context
+
+## List collaboration
+
+- **List owner**: the user who owns a list. Ownership is not a collaborator membership and is never inherited.
+- **Collaborator**: a non-owner user with accepted access to a manual list as `viewer` or `editor`.
+- **Direct grant**: a collaborator membership attached to one specific list.
+- **Recursive grant**: a direct grant whose role may be inherited by descendants of that list, including descendants created or moved into the subtree later.
+- **Inherited access**: effective access to a list obtained from the nearest ancestor direct grant for the same user whose recursive flag is enabled.
+- **Effective role**: the role used for authorization on a list. A direct grant on the list wins. Otherwise the nearest recursive ancestor grant wins. Otherwise the user has no collaborator access.
+- **Invitation**: a pending offer for a direct grant. Invitations may request viewer/editor access and may optionally request recursive sharing.
+- **Invitation expiry**: a pending invitation is valid for 30 days from `invitedAt`. Resending renews `invitedAt` for another 30 days.
+- **Public access**: anonymous read-only access to a list through its public-list mechanism. Public access never creates collaborator membership and is independent from collaboration.
+- **Contributed bookmark membership**: a bookmark-to-list association created through a collaborator membership. Removing that direct membership removes associations tied to it, but never deletes the underlying bookmark.
+
+## Permission rules
+
+- Collaboration applies only to manual lists.
+- Viewers are read-only. Editors can add/remove bookmark memberships. Only owners manage list metadata and collaborators.
+- Recursive sharing is opt-in per direct grant and defaults off.
+- Current and future descendants can inherit a recursive grant.
+- Moving a descendant out of a recursively shared subtree removes access that existed only through that inheritance.
+- Explicit direct access on a descendant overrides an inherited role on that descendant. Descendants inherit from the nearest recursive direct grant available on their own ancestor chain.
+- Public sharing and collaborator sharing can coexist on the same list.

apps/mobile/app/dashboard/(tabs)/(lists)/index.tsx

@@ -79,13 +79,14 @@ export default function Lists() {
   const api = useTRPC();
   const queryClient = useQueryClient();
   const { data: listStats } = useQuery(api.lists.stats.queryOptions());
+  const { data: pendingInvitations } = useQuery(
+    api.lists.getPendingInvitations.queryOptions(),
+  );
 
-  // Check if there are any shared lists
   const hasSharedLists = useMemo(() => {
     return lists?.data.some((list) => list.userRole !== "owner") ?? false;
   }, [lists?.data]);
 
-  // Check if any list has children to determine if we need chevron spacing
   const hasAnyListsWithChildren = useMemo(() => {
     const checkForChildren = (node: ZBookmarkListTreeNode): boolean => {
       if (node.children && node.children.length > 0) return true;
@@ -111,6 +112,7 @@ export default function Lists() {
   const onRefresh = () => {
     queryClient.invalidateQueries(api.lists.list.pathFilter());
     queryClient.invalidateQueries(api.lists.stats.pathFilter());
+    queryClient.invalidateQueries(api.lists.getPendingInvitations.pathFilter());
   };
 
   const links: ListLink[] = [
@@ -134,9 +136,19 @@ export default function Lists() {
     },
   ];
 
-  // Add shared lists section if there are any
+  if (pendingInvitations && pendingInvitations.length > 0) {
+    links.push({
+      id: "pending-invitations",
+      logo: "✉️",
+      name: `List Invitations (${pendingInvitations.length})`,
+      href: "/dashboard/lists/invitations",
+      level: 0,
+      numChildren: 0,
+      collapsed: false,
+    });
+  }
+
   if (hasSharedLists) {
-    // Count shared lists to determine if section has children
     const sharedListsCount = Object.values(lists.root).filter(
       (list) => list.item.userRole !== "owner",
     ).length;
@@ -152,7 +164,6 @@ export default function Lists() {
       isSharedSection: true,
     });
 
-    // Add shared lists as children if section is expanded
     if (showChildrenOf["shared-section"]) {
       Object.values(lists.root).forEach((list) => {
         if (list.item.userRole !== "owner") {
@@ -169,7 +180,6 @@ export default function Lists() {
     }
   }
 
-  // Add owned lists only
   Object.values(lists.root).forEach((list) => {
     if (list.item.userRole === "owner") {
       traverseTree(list, links, showChildrenOf, listStats?.stats);