improve wording in jsdoc

Author: kantord

docs/mocks.md

@@ -103,7 +103,7 @@ interface AutoAPIMockInstance<T> {
   // Reset to default behavior (called automatically before each test)
   reset(): this;
 
-  // Internal handler used by MSW (don't call directly)
+  // MSW handler to use in handler registration. Respects overrides and scenarios.
   generatedHandler: HttpResponseResolver;
 }
 ```

src/mocks/autoAPIMock.ts

@@ -18,7 +18,7 @@ export interface ActivateScenarioOptions {
 }
 
 export interface AutoAPIMockInstance<T> {
-  /** Internal MSW handler - don't call directly */
+  /** MSW handler to use in handler registration. Respects overrides and scenarios. */
   generatedHandler: HttpResponseResolver;
 
   /** Override response data with type safety. Preferred for simple data changes. */