From e7e2a2fda70230ea02d6ac6e184c8bc9ffb48373 Mon Sep 17 00:00:00 2001
From: plebeius <tom@plebbit.com>
Date: Fri, 7 Nov 2025 12:49:58 +0100
Subject: [PATCH] perf(hooks): document stable reference optimization in
 useDefaultSubplebbits

---
 src/hooks/use-default-subplebbits.ts | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/hooks/use-default-subplebbits.ts b/src/hooks/use-default-subplebbits.ts
index c8861698..ecea1d94 100644
--- a/src/hooks/use-default-subplebbits.ts
+++ b/src/hooks/use-default-subplebbits.ts
@@ -158,7 +158,9 @@ export const useDefaultSubplebbits = () => {
     };
   }, []);
 
-  // To maintain backward compatibility, return the subplebbits array directly
+  // Always prefer cacheSubplebbits (module-level, stable reference) when available
+  // Only use state.subplebbits during initial load before cache is populated
+  // This ensures a stable reference for memoization in consuming hooks
   return cacheSubplebbits || state.subplebbits;
 };