diff --git a/packages/core/src/primitives/create-disclosure-state.ts b/packages/core/src/primitives/create-disclosure-state.ts
index ae251e0..59c1470 100644
--- a/packages/core/src/primitives/create-disclosure-state.ts
+++ b/packages/core/src/primitives/create-disclosure-state.ts
@@ -32,6 +32,8 @@ export function createDisclosureState(
     isOpen,
     open: () => setIsOpen(true),
     close: () => setIsOpen(false),
+    // Imperative-only: do not call toggle() inside a reactive computation (effect/memo),
+    // as isOpen() would create an unwanted reactive dependency there.
     toggle: () => setIsOpen(!isOpen()),
   };
 }