clarification needed: should useApi export full loader or should useLoaderSuccess JSDoc be updated?

[VldMrgnn]

Currently, the JSDoc for useLoaderSuccess suggests using the loader from useApi, but useApi does not return the full loader object, which causes confusion when trying to use useLoaderSuccess with useApi.

return { ...loader, trigger, action };
vs.
const { loader, trigger } = useApi(createUser);

There seem to be two possible approaches to resolve this:

1. Export the full loader object so it can be used seamlessly with useLoaderSuccess. This would look like:

return { ...loader, loader, trigger, action };

2. Update the JSDoc for useLoaderSuccess. For example:

/**
 * useLoaderSuccess 
 * ....
 * const View = () => {
 *   const { trigger } = useApi(createUser);
 *   const loader = useLoader(createUser); // Use useLoader to get the full loader
 *   const onSubmit = () => {
 *     trigger({ name: 'bob' });
 *   };
 * ```

I think this issue should be addressed in some manner to avoid confusion.