docs(app): add setFocus to the public API

Author: brandyscarney

core/api.txt

@@ -143,6 +143,7 @@ ion-alert,css-prop,--width,ios
 ion-alert,css-prop,--width,md
 
 ion-app,none
+ion-app,method,setFocus,setFocus(elements: HTMLElement[]) => Promise<void>
 
 ion-avatar,shadow
 ion-avatar,css-prop,--border-radius,ios

core/src/components.d.ts

@@ -304,6 +304,9 @@ export namespace Components {
         "trigger": string | undefined;
     }
     interface IonApp {
+        /**
+          * Used to set focus on an element that uses `ion-focusable`. Do not use this if focusing the element as a result of a keyboard event as the focus utility should handle this for us. This method should be used when we want to programmatically focus an element as a result of another user action. (Ex: We focus the first element inside of a popover when the user presents it, but the popover is not always presented as a result of keyboard action.)
+         */
         "setFocus": (elements: HTMLElement[]) => Promise<void>;
     }
     interface IonAvatar {

core/src/components/app/app.tsx

@@ -61,7 +61,6 @@ export class App implements ComponentInterface {
   }
 
   /**
-   * @internal
    * Used to set focus on an element that uses `ion-focusable`.
    * Do not use this if focusing the element as a result of a keyboard
    * event as the focus utility should handle this for us. This method

packages/angular/src/directives/proxies.ts

@@ -188,6 +188,7 @@ Shorthand for ionAlertDidDismiss.
 
 
 @ProxyCmp({
+  methods: ['setFocus']
 })
 @Component({
   selector: 'ion-app',

packages/angular/standalone/src/directives/proxies.ts

@@ -266,7 +266,8 @@ Shorthand for ionAlertDidDismiss.
 
 
 @ProxyCmp({
-  defineCustomElementFn: defineIonApp
+  defineCustomElementFn: defineIonApp,
+  methods: ['setFocus']
 })
 @Component({
   selector: 'ion-app',