docs: add a reference to useWebshell hook

Author: jsamr

apps/website/docs/getting-started.mdx

@@ -65,6 +65,12 @@ object of options to their constructor. Sometimes, a feature options object
 might not have required fields, and you can skip the constructor argument if
 you are OK with the defaults.
 
+:::tip
+If you are developing functional components, you
+can use the hook variant instead: <APIReference reference="useWebshell" type="function" />
+
+:::
+
 In the bellow snippet,
 we are creating a component which augments <WebView /> with the two features
 previously mentioned, but of course any number of features could be instantiated!

apps/website/typedoc-sidebars.js

@@ -31,6 +31,7 @@ module.exports = [
       "api/interfaces/linkpressoptions",
       "api/interfaces/linkpresstarget",
       "api/interfaces/minimalwebviewprops",
+      "api/interfaces/usewebshellparams",
       "api/interfaces/visualviewportdimensions",
       "api/interfaces/webhandle",
       "api/interfaces/webhandlerdefinition",
@@ -82,7 +83,8 @@ module.exports = [
     "label": "Functions",
     "items": [
       "api/functions/makewebshell",
-      "api/functions/useautoheight"
+      "api/functions/useautoheight",
+      "api/functions/usewebshell"
     ]
   }
 ];

packages/webshell/etc/webshell.api.md

@@ -8,6 +8,7 @@ import type { ComponentPropsWithoutRef } from 'react';
 import type { ComponentType } from 'react';
 import type { ElementRef } from 'react';
 import type { ForwardRefExoticComponent } from 'react';
+import * as React_2 from 'react';
 import type { Ref } from 'react';
 import type { RefAttributes } from 'react';
 
@@ -337,6 +338,18 @@ export type PropsSpecs<N extends string, P> = {
 // @public
 export function useAutoheight<S extends WebshellProps<MinimalWebViewProps, [ExtractFeatureFromClass<typeof HandleHTMLDimensionsFeature>]>>(params: AutoheightParams<S>): AutoheightState<S>;
 
+// @public
+export function useWebshell<C extends ComponentType<any>, F extends Feature<{}, {}, {}>[]>({ features, props: webshellProps, webViewRef }: UseWebshellParams<React_2.ComponentProps<C>, F>): React_2.ComponentProps<C> & {
+    ref: ElementRef<C>;
+};
+
+// @public
+export interface UseWebshellParams<W extends MinimalWebViewProps, F extends Feature<{}, {}, {}>[]> {
+    features: F;
+    props: WebshellProps<W, F>;
+    webViewRef?: ElementRef<any>;
+}
+
 // @public
 export interface VisualViewportDimensions {
     isLegacy: boolean;