@nativescript/core 9.1.0-dev.0 → 9.1.0-next.0

package/application/application.ios.d.ts

@@ -2,6 +2,9 @@ import type { View } from '../ui/core/view';
 import type { NavigationEntry } from '../ui/frame/frame-interfaces';
 import { ApplicationCommon } from './application-common';
 import type { iOSApplication as IiOSApplication } from './application';
+import { IOSNativeWindow } from '../native-window/native-window.ios';
+import { NativeWindow } from '../native-window/native-window-common';
+import type { WindowOpenOptions } from '../native-window/native-window-interfaces';
 import { CommonA11YServiceEnabledObservable } from '../accessibility/accessibility-common';
 import { CoreTypes } from '../core-types';
 declare class NotificationObserver extends NSObject {
@@ -30,25 +33,50 @@ export declare class iOSApplication extends ApplicationCommon implements IiOSApp
     private _delegate;
     private _delegateHandlers;
     private _rootView;
-    private launchEventCalled;
+    /** Set when a background launch defers the primary window's content until the app first becomes active. */
+    private _pendingWindowContentResolve;
     private _sceneDelegate;
-    private _windowSceneMap;
-    private _primaryScene;
-    private _openedScenesById;
+    /**
+     * User-provided callback to intercept scene configuration.
+     * Called for every new scene session. Return a UISceneConfiguration to handle
+     * the scene yourself, or return null/undefined to let NativeScript handle it
+     * (only for UIWindowSceneSessionRoleApplication scenes).
+     * @internal
+     */
+    _onSceneConfiguration: ((application: UIApplication, connectingSceneSession: UISceneSession, options: UISceneConnectionOptions) => UISceneConfiguration | null | undefined) | null;
+    private _mirroredWindow;
     private _notificationObservers;
+    private _softRebootAppDelegate;
+    private _softRebootSceneDelegates;
     displayedOnce: boolean;
     displayedLinkTarget: CADisplayLinkTarget;
     displayedLink: CADisplayLink;
+    /**
+     * @deprecated Has no effect. Application initialization is signalled by the 'ready' event, which is never deferred.
+     */
     shouldDelayLaunchEvent: boolean;
     /**
      * @internal - should not be constructed by the user.
      */
     constructor();
     getRootView(): View;
-    resetRootView(view?: View): void;
+    resetRootView(entry?: NavigationEntry | string): void;
     run(entry?: string | NavigationEntry): void;
     private runAsMainApp;
     private runAsEmbeddedApp;
+    /**
+     * After an in-process soft reboot (NativeScriptRuntime.reloadApplication /
+     * restartWithConfig), the Objective-C delegate classes created by the
+     * previous JS isolate still exist and UIKit keeps dispatching to their
+     * now-inert instances: their method callbacks bail out because the isolate
+     * that implemented them is gone. Notification-center observers are
+     * re-registered by the new isolate, but delegate-based dispatch (custom
+     * UIApplicationDelegate methods like push-token/openURL callbacks, and the
+     * UIScene delegates used by scene-lifecycle apps) stays pinned to the old
+     * bundle. Recreate those delegates from this bundle's classes and re-point
+     * UIKit at them.
+     */
+    private _reattachNativeDelegatesAfterSoftReboot;
     private getViewController;
     private setViewControllerView;
     setMaxRefreshRate(options?: {
@@ -74,54 +102,103 @@ export declare class iOSApplication extends ApplicationCommon implements IiOSApp
     protected getOrientation(): "portrait" | "landscape" | "unknown";
     private getOrientationValue;
     private notifyAppStarted;
-    _notifySceneAppStarted(): void;
     _onLivesync(context?: ModuleContext): void;
     private setWindowContent;
+    /**
+     * Attaches content to the raw `UIWindow`. Every launch path registers a primary
+     * NativeWindow, so this only runs when no window is left to own the content.
+     */
+    private setWindowContentFallback;
     private didFinishLaunchingWithOptions;
     private didBecomeActive;
     private didEnterBackground;
     private willTerminate;
     private didReceiveMemoryWarning;
     private didChangeStatusBarOrientation;
-    private sceneWillConnect;
-    private sceneDidActivate;
-    private sceneWillEnterForeground;
-    private sceneDidEnterBackground;
-    private sceneDidDisconnect;
-    _setWindowForScene(window: UIWindow, scene: UIScene): void;
-    _removeWindowForScene(scene: UIScene): void;
-    _getWindowForScene(scene: UIScene): UIWindow | undefined;
-    _setupWindowForScene(window: UIWindow, scene: UIWindowScene): void;
+    /**
+     * Keeps the app-level root view state (`getRootView()`, the global root view and the
+     * `initRootView` event) following whatever the primary window shows.
+     */
+    private mirrorPrimaryWindow;
+    private onPrimaryWindowContentLoaded;
+    private adoptRootView;
+    /**
+     * @internal - iOS reports discarded sessions for windows this JS context may never
+     * have seen (they can arrive on a later launch), so unknown ids are ignored.
+     */
+    _onSceneSessionsDiscarded(sessions: NSSet<UISceneSession>): void;
+    /**
+     * @internal - Get a NativeWindow by its scene.
+     */
+    _getWindowForScene(scene: UIWindowScene): IOSNativeWindow | undefined;
+    protected _onWindowRegistered(nativeWindow: NativeWindow): void;
+    protected _onPrimaryWindowPromoted(nativeWindow: NativeWindow): void;
+    /**
+     * Register a callback to intercept scene configuration.
+     *
+     * Called for every new scene session. Return a `UISceneConfiguration` to handle
+     * the scene yourself (e.g. CarPlay, external display), or return `null`/`undefined`
+     * to let NativeScript handle it with the default SceneDelegate.
+     *
+     * NativeScript only auto-manages `UIWindowSceneSessionRoleApplication` scenes.
+     * All other scene roles are ignored unless you provide a configuration here.
+     *
+     * @example
+     * ```ts
+     * Application.ios.onSceneConfiguration = (app, session, options) => {
+     *   if (session.role === CPTemplateApplicationSceneSessionRoleApplication) {
+     *     const config = UISceneConfiguration.configurationWithNameSessionRole('CarPlay', session.role);
+     *     config.delegateClass = MyCarPlaySceneDelegate;
+     *     return config;
+     *   }
+     *   // Return null to let NativeScript handle the default window scene
+     *   return null;
+     * };
+     * ```
+     */
+    set onSceneConfiguration(handler: ((application: UIApplication, connectingSceneSession: UISceneSession, options: UISceneConnectionOptions) => UISceneConfiguration | null | undefined) | null);
+    get onSceneConfiguration(): ((application: UIApplication, connectingSceneSession: UISceneSession, options: UISceneConnectionOptions) => UISceneConfiguration | null | undefined) | null;
     get sceneDelegate(): UIWindowSceneDelegate;
     set sceneDelegate(value: UIWindowSceneDelegate);
     /**
      * Multi-window support
      */
     /**
-     * Opens a new window with the specified data.
-     * @param data The data to pass to the new window.
+     * Opens a new window (scene).
+     *
+     * @param options Options for the new window. `options.data` is serialized into the
+     * activating scene's `NSUserActivity.userInfo`.
      */
-    openWindow(data: Record<any, any>): void;
+    openWindow(options?: WindowOpenOptions): void;
     /**
      * Closes a secondary window/scene.
-     * Usage examples:
-     *  - Application.ios.closeWindow() // best-effort close of a non-primary scene
-     *  - Application.ios.closeWindow(button) // from a tap handler within the scene
-     *  - Application.ios.closeWindow(window)
-     *  - Application.ios.closeWindow(scene)
-     *  - Application.ios.closeWindow('scene-id')
-     */
-    closeWindow(target?: View | UIWindow | UIWindowScene | string): void;
+     * Accepts a NativeWindow, View, UIWindow, UIWindowScene, or string id.
+     */
+    closeWindow(target?: NativeWindow | View | UIWindow | UIWindowScene | string): void;
+    /**
+     * @deprecated Use `getWindows()` instead.
+     */
     getAllWindows(): UIWindow[];
+    /**
+     * @deprecated Use `getWindows()` instead.
+     */
     getAllScenes(): UIScene[];
+    /**
+     * @deprecated Use `getWindows()` instead.
+     */
     getWindowScenes(): UIWindowScene[];
+    /**
+     * @deprecated Use `primaryWindow?.ios?.uiWindow` instead.
+     */
     getPrimaryWindow(): UIWindow;
+    /**
+     * @deprecated Use `primaryWindow?.ios?.scene` instead.
+     */
     getPrimaryScene(): UIWindowScene | null;
     supportsScenes(): boolean;
     supportsMultipleScenes(): boolean;
     isUsingSceneLifecycle(): boolean;
     configureForScenes(): void;
-    private _getSceneId;
     private _resolveScene;
     private createSceneWithLegacyAPI;
     /**
@@ -133,6 +210,7 @@ export declare class iOSApplication extends ApplicationCommon implements IiOSApp
     get ios(): this;
 }
 export * from './application-common';
+export * from './application-interfaces';
 export declare const Application: iOSApplication;
 export declare const AndroidApplication: any;
 export declare function getCurrentFontScale(): number;
@@ -143,6 +221,6 @@ export declare function getAndroidAccessibilityManager(): null;
 export declare class AccessibilityServiceEnabledObservable extends CommonA11YServiceEnabledObservable {
     constructor();
 }
-export declare function ensureClasses(): void;
+export declare function ensureA11yClasses(): void;
 export declare function updateCurrentHelperClasses(applyRootCssClass: (cssClasses: string[], newCssClass: string) => void): void;
 export declare function initAccessibilityCssHelper(): void;