docs(core): exposing usePerspective and updating tsDoc

packages/sanity/src/core/perspective/usePerspective.ts

@@ -4,7 +4,17 @@ import {PerspectiveContext} from 'sanity/_singletons'
 import {type PerspectiveContextValue} from './types'
 
 /**
- * @internal
+ * React hook that returns the current studio perspective and perspective stack.
+ *
+ * @public
+ * @returns See {@link PerspectiveContextValue}
+ * @example Reading the current perspective stack
+ * ```ts
+ * function MyComponent() {
+ *  const {perspectiveStack} = usePerspective()
+ *  // ... do something with the perspective stack ...
+ * }
+ * ```
  */
 export function usePerspective(): PerspectiveContextValue {
   const context = useContext(PerspectiveContext)