@nativescript/core 9.1.0-next.3 → 9.1.0-next.4

package/native-window/native-window.android.d.ts

@@ -0,0 +1,59 @@
+import type { View } from '../ui/core/view';
+import { CoreTypes } from '../core-types';
+import { NativeWindow } from './native-window-common';
+import type { WindowRole } from './window-base';
+/**
+ * Android implementation of NativeWindow.
+ * Wraps an AppCompatActivity.
+ */
+export declare class AndroidNativeWindow extends NativeWindow {
+    private _activity;
+    private _componentCallbacks;
+    private _componentCallbacksActivity;
+    constructor(activity: androidx.appcompat.app.AppCompatActivity, id?: string, isPrimary?: boolean, role?: WindowRole);
+    /**
+     * @internal – bind a recreated activity to this window session after a detach.
+     */
+    _reattach(activity: androidx.appcompat.app.AppCompatActivity): void;
+    /**
+     * @internal – observe the activity's own configuration.
+     *
+     * Registered on the activity rather than the application context: in multi-window
+     * and multi-display setups each activity gets its own configuration, and only these
+     * callbacks report the one this window actually renders with.
+     */
+    _registerConfigurationCallbacks(): void;
+    /**
+     * @internal – drop the configuration callbacks, so a recreated activity does not
+     * leave the previous one registered.
+     */
+    _unregisterConfigurationCallbacks(): void;
+    _detach(): void;
+    /**
+     * The wrapped Android Activity (may be GC'd).
+     */
+    get activity(): androidx.appcompat.app.AppCompatActivity | undefined;
+    get android(): {
+        activity: androidx.appcompat.app.AppCompatActivity;
+    };
+    /**
+     * Platform-specific: apply the view as root content of this Activity.
+     */
+    protected _setNativeContent(view: View): void;
+    /**
+     * Close this window by finishing the activity.
+     */
+    close(): void;
+    protected _getOrientation(): 'portrait' | 'landscape' | 'unknown';
+    protected _getSystemAppearance(): 'light' | 'dark' | null;
+    protected _getLayoutDirection(): CoreTypes.LayoutDirectionType | null;
+    _getOrientationValue(configuration: android.content.res.Configuration): 'portrait' | 'landscape' | 'unknown';
+    _getSystemAppearanceValue(configuration: android.content.res.Configuration): 'dark' | 'light';
+    _getLayoutDirectionValue(configuration: android.content.res.Configuration): CoreTypes.LayoutDirectionType;
+    protected _onDestroy(): void;
+    /**
+     * Mints a window identity. Android has no stable activity id, so the value is kept
+     * in the activity saved state to survive recreation (rotation, theme change).
+     */
+    static newWindowId(): string;
+}

package/native-window/native-window.android.js

@@ -0,0 +1,175 @@
+import { CoreTypes } from '../core-types';
+import { CALLBACKS } from '../ui/frame/frame-constants';
+import { NativeWindow } from './native-window-common';
+/**
+ * Android implementation of NativeWindow.
+ * Wraps an AppCompatActivity.
+ */
+export class AndroidNativeWindow extends NativeWindow {
+    constructor(activity, id, isPrimary = false, role = 'application') {
+        super(id, isPrimary, role);
+        this._activity = new WeakRef(activity);
+    }
+    /**
+     * @internal – bind a recreated activity to this window session after a detach.
+     */
+    _reattach(activity) {
+        this._activity = new WeakRef(activity);
+        this._setState('attached');
+    }
+    /**
+     * @internal – observe the activity's own configuration.
+     *
+     * Registered on the activity rather than the application context: in multi-window
+     * and multi-display setups each activity gets its own configuration, and only these
+     * callbacks report the one this window actually renders with.
+     */
+    _registerConfigurationCallbacks() {
+        const activity = this.activity;
+        if (!activity || this._componentCallbacks) {
+            return;
+        }
+        const callbacks = new android.content.ComponentCallbacks2({
+            onLowMemory() {
+                // Handled application-wide.
+            },
+            onTrimMemory(level) {
+                // Handled application-wide.
+            },
+            onConfigurationChanged: (newConfiguration) => {
+                this._setOrientation(this._getOrientationValue(newConfiguration));
+                this._setSystemAppearance(this._getSystemAppearanceValue(newConfiguration));
+                this._setLayoutDirection(this._getLayoutDirectionValue(newConfiguration));
+            },
+        });
+        activity.registerComponentCallbacks(callbacks);
+        this._componentCallbacks = callbacks;
+        this._componentCallbacksActivity = new WeakRef(activity);
+    }
+    /**
+     * @internal – drop the configuration callbacks, so a recreated activity does not
+     * leave the previous one registered.
+     */
+    _unregisterConfigurationCallbacks() {
+        const callbacks = this._componentCallbacks;
+        if (!callbacks) {
+            return;
+        }
+        this._componentCallbacks = null;
+        this._componentCallbacksActivity?.deref()?.unregisterComponentCallbacks(callbacks);
+        this._componentCallbacksActivity = null;
+    }
+    _detach() {
+        this._unregisterConfigurationCallbacks();
+        super._detach();
+    }
+    /**
+     * The wrapped Android Activity (may be GC'd).
+     */
+    get activity() {
+        return this._activity?.deref();
+    }
+    get android() {
+        const activity = this.activity;
+        if (!activity) {
+            return undefined;
+        }
+        return { activity };
+    }
+    /**
+     * Platform-specific: apply the view as root content of this Activity.
+     */
+    _setNativeContent(view) {
+        const activity = this.activity;
+        if (!activity) {
+            throw new Error('NativeWindow: Activity is no longer available.');
+        }
+        const callbacks = activity[CALLBACKS];
+        if (!callbacks) {
+            throw new Error('NativeWindow: Cannot find activity callbacks.');
+        }
+        callbacks.resetActivityContent(activity, view);
+    }
+    /**
+     * Close this window by finishing the activity.
+     */
+    close() {
+        if (this.isPrimary) {
+            console.log('NativeWindow: Cannot close the primary window.');
+            return;
+        }
+        const activity = this.activity;
+        if (activity) {
+            activity.finish();
+        }
+    }
+    // --- Platform getters ---
+    _getOrientation() {
+        const activity = this.activity;
+        if (!activity) {
+            return 'unknown';
+        }
+        const configuration = activity.getResources().getConfiguration();
+        return this._getOrientationValue(configuration);
+    }
+    _getSystemAppearance() {
+        const activity = this.activity;
+        if (!activity) {
+            return null;
+        }
+        const configuration = activity.getResources().getConfiguration();
+        return this._getSystemAppearanceValue(configuration);
+    }
+    _getLayoutDirection() {
+        const activity = this.activity;
+        if (!activity) {
+            return null;
+        }
+        const configuration = activity.getResources().getConfiguration();
+        return this._getLayoutDirectionValue(configuration);
+    }
+    // --- Value converters ---
+    _getOrientationValue(configuration) {
+        switch (configuration.orientation) {
+            case android.content.res.Configuration.ORIENTATION_LANDSCAPE:
+                return 'landscape';
+            case android.content.res.Configuration.ORIENTATION_PORTRAIT:
+                return 'portrait';
+            default:
+                return 'unknown';
+        }
+    }
+    _getSystemAppearanceValue(configuration) {
+        const mode = configuration.uiMode & android.content.res.Configuration.UI_MODE_NIGHT_MASK;
+        switch (mode) {
+            case android.content.res.Configuration.UI_MODE_NIGHT_YES:
+                return 'dark';
+            case android.content.res.Configuration.UI_MODE_NIGHT_NO:
+            case android.content.res.Configuration.UI_MODE_NIGHT_UNDEFINED:
+            default:
+                return 'light';
+        }
+    }
+    _getLayoutDirectionValue(configuration) {
+        switch (configuration.getLayoutDirection()) {
+            case android.view.View.LAYOUT_DIRECTION_RTL:
+                return CoreTypes.LayoutDirection.rtl;
+            case android.view.View.LAYOUT_DIRECTION_LTR:
+            default:
+                return CoreTypes.LayoutDirection.ltr;
+        }
+    }
+    _onDestroy() {
+        this._unregisterConfigurationCallbacks();
+        super._onDestroy();
+        this._activity = null;
+    }
+    /**
+     * Mints a window identity. Android has no stable activity id, so the value is kept
+     * in the activity saved state to survive recreation (rotation, theme change).
+     */
+    static newWindowId() {
+        return `window-${java.util.UUID.randomUUID().toString()}`;
+    }
+}
+//# sourceMappingURL=native-window.android.js.map

package/native-window/native-window.android.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-window.android.js","sourceRoot":"","sources":["../../../../packages/core/native-window/native-window.android.ts"],"names":[],"mappings":"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"}

package/native-window/native-window.ios.d.ts

@@ -0,0 +1,57 @@
+import type { View } from '../ui/core/view';
+import { CoreTypes } from '../core-types';
+import { NativeWindow } from './native-window-common';
+import type { WindowRole } from './window-base';
+/**
+ * iOS implementation of NativeWindow.
+ * Wraps a UIWindow and, when the app is scene-based, the UIWindowScene hosting it.
+ */
+export declare class IOSNativeWindow extends NativeWindow {
+    private _scene;
+    private _window;
+    /**
+     * @internal – set while a scene session destruction request is in flight, so the
+     * following scene disconnect is read as a close rather than a detach.
+     */
+    _closeRequested: boolean;
+    /**
+     * @internal – whether the id comes from a scene session identity. Without one the
+     * window cannot be matched to a reconnecting session or to a discarded one.
+     */
+    _hasSessionIdentity: boolean;
+    constructor(scene: UIWindowScene | undefined, window: UIWindow, id?: string, isPrimary?: boolean, role?: WindowRole);
+    /**
+     * @internal – bind a new scene/window pair to this window session after a detach.
+     */
+    _reattach(scene: UIWindowScene, uiWindow: UIWindow): void;
+    get ios(): {
+        scene: UIWindowScene;
+        uiWindow: UIWindow;
+    };
+    /**
+     * Platform-specific: set the view as root content of this UIWindow.
+     */
+    protected _setNativeContent(view: View): void;
+    /**
+     * Close this window/scene.
+     */
+    close(): void;
+    protected _getOrientation(): 'portrait' | 'landscape' | 'unknown';
+    protected _getSystemAppearance(): 'light' | 'dark' | null;
+    protected _getLayoutDirection(): CoreTypes.LayoutDirectionType | null;
+    private _getOrientationValue;
+    _getSystemAppearanceValue(userInterfaceStyle: number): 'dark' | 'light';
+    _getLayoutDirectionValue(layoutDirection: number): CoreTypes.LayoutDirectionType;
+    private _getViewController;
+    private _setViewControllerView;
+    protected _onReleaseRootView(rootView: View): void;
+    protected _onDestroy(): void;
+    /**
+     * The window identity of a scene: the session persistent identifier, which iOS keeps
+     * across a disconnect and hands back when it reconnects the same session.
+     *
+     * Returns `undefined` when the scene carries no session identity — such a window gets
+     * a minted id and will not be recognised on reconnect.
+     */
+    static getSceneId(scene: UIWindowScene): string | undefined;
+}

package/native-window/native-window.ios.js

@@ -0,0 +1,208 @@
+import { IOSHelper } from '../ui/core/view/view-helper';
+import { SDK_VERSION } from '../utils/constants';
+import { CoreTypes } from '../core-types';
+import { Trace } from '../trace';
+import { NativeWindow } from './native-window-common';
+/**
+ * iOS implementation of NativeWindow.
+ * Wraps a UIWindow and, when the app is scene-based, the UIWindowScene hosting it.
+ */
+export class IOSNativeWindow extends NativeWindow {
+    constructor(scene, window, id, isPrimary = false, role = 'application') {
+        super(id, isPrimary, role);
+        /**
+         * @internal – set while a scene session destruction request is in flight, so the
+         * following scene disconnect is read as a close rather than a detach.
+         */
+        this._closeRequested = false;
+        this._hasSessionIdentity = !!id;
+        this._scene = scene;
+        this._window = window;
+    }
+    /**
+     * @internal – bind a new scene/window pair to this window session after a detach.
+     */
+    _reattach(scene, uiWindow) {
+        this._scene = scene;
+        this._window = uiWindow;
+        this._setState('attached');
+    }
+    get ios() {
+        return {
+            scene: this._scene,
+            uiWindow: this._window,
+        };
+    }
+    /**
+     * Platform-specific: set the view as root content of this UIWindow.
+     */
+    _setNativeContent(view) {
+        const controller = this._getViewController(view);
+        this._setViewControllerView(view);
+        if (this.role === 'embedded') {
+            // The host app owns this UIWindow: its rootViewController and key/visible state
+            // are not ours to change, so the content is handed over as a view controller.
+            NativeScriptEmbedder.sharedInstance().delegate?.presentNativeScriptApp(controller);
+        }
+        else {
+            const haveController = this._window.rootViewController !== null;
+            this._window.rootViewController = controller;
+            if (!haveController) {
+                this._window.makeKeyAndVisible();
+            }
+        }
+        // Listen for trait collection changes per-window
+        view.on(IOSHelper.traitCollectionColorAppearanceChangedEvent, () => {
+            const userInterfaceStyle = controller.traitCollection.userInterfaceStyle;
+            this._setSystemAppearance(this._getSystemAppearanceValue(userInterfaceStyle));
+        });
+        view.on(IOSHelper.traitCollectionLayoutDirectionChangedEvent, () => {
+            const layoutDirection = controller.traitCollection.layoutDirection;
+            this._setLayoutDirection(this._getLayoutDirectionValue(layoutDirection));
+        });
+    }
+    /**
+     * Close this window/scene.
+     */
+    close() {
+        if (this.isPrimary) {
+            console.log('NativeWindow: Cannot close the primary window.');
+            return;
+        }
+        const session = this._scene?.session;
+        if (!session) {
+            console.log('NativeWindow: Scene has no session to destroy.');
+            return;
+        }
+        const app = UIApplication.sharedApplication;
+        if (app.requestSceneSessionDestructionOptionsErrorHandler) {
+            this._closeRequested = true;
+            app.requestSceneSessionDestructionOptionsErrorHandler(session, null, (error) => {
+                if (error) {
+                    this._closeRequested = false;
+                    console.log('NativeWindow: Error destroying scene session:', error.localizedDescription);
+                }
+            });
+        }
+        else {
+            console.log('NativeWindow: Scene destruction API not available on this iOS version.');
+        }
+    }
+    // --- Platform getters ---
+    _getOrientation() {
+        if (__VISIONOS__) {
+            return this._getOrientationValue(NativeScriptEmbedder.sharedInstance().windowScene?.interfaceOrientation);
+        }
+        if (this._scene) {
+            return this._getOrientationValue(this._scene.interfaceOrientation);
+        }
+        return this._getOrientationValue(UIApplication.sharedApplication.statusBarOrientation);
+    }
+    _getSystemAppearance() {
+        if (!__VISIONOS__ && SDK_VERSION <= 11) {
+            return null;
+        }
+        const rootVC = this._window?.rootViewController;
+        if (!rootVC) {
+            return null;
+        }
+        return this._getSystemAppearanceValue(rootVC.traitCollection.userInterfaceStyle);
+    }
+    _getLayoutDirection() {
+        const rootVC = this._window?.rootViewController;
+        if (!rootVC) {
+            return null;
+        }
+        return this._getLayoutDirectionValue(rootVC.traitCollection.layoutDirection);
+    }
+    // --- Value converters ---
+    _getOrientationValue(orientation) {
+        switch (orientation) {
+            case 3 /* UIInterfaceOrientation.LandscapeRight */:
+            case 4 /* UIInterfaceOrientation.LandscapeLeft */:
+                return 'landscape';
+            case 2 /* UIInterfaceOrientation.PortraitUpsideDown */:
+            case 1 /* UIInterfaceOrientation.Portrait */:
+                return 'portrait';
+            case 0 /* UIInterfaceOrientation.Unknown */:
+            default:
+                return 'unknown';
+        }
+    }
+    _getSystemAppearanceValue(userInterfaceStyle) {
+        switch (userInterfaceStyle) {
+            case 2 /* UIUserInterfaceStyle.Dark */:
+                return 'dark';
+            case 1 /* UIUserInterfaceStyle.Light */:
+            case 0 /* UIUserInterfaceStyle.Unspecified */:
+            default:
+                return 'light';
+        }
+    }
+    _getLayoutDirectionValue(layoutDirection) {
+        switch (layoutDirection) {
+            case 1 /* UITraitEnvironmentLayoutDirection.RightToLeft */:
+                return CoreTypes.LayoutDirection.rtl;
+            case 0 /* UITraitEnvironmentLayoutDirection.LeftToRight */:
+            default:
+                return CoreTypes.LayoutDirection.ltr;
+        }
+    }
+    // --- ViewController helpers ---
+    _getViewController(rootView) {
+        let viewController = rootView.viewController || rootView.ios;
+        if (!(viewController instanceof UIViewController)) {
+            viewController = IOSHelper.UILayoutViewController.initWithOwner(new WeakRef(rootView));
+            rootView.viewController = viewController;
+        }
+        return viewController;
+    }
+    _setViewControllerView(view) {
+        const viewController = view.viewController || view.ios;
+        const nativeView = view.ios || view.nativeViewProtected;
+        if (!nativeView || !viewController) {
+            throw new Error('Root should be either UIViewController or UIView');
+        }
+        if (viewController instanceof IOSHelper.UILayoutViewController) {
+            viewController.view.addSubview(nativeView);
+        }
+    }
+    _onReleaseRootView(rootView) {
+        rootView.off(IOSHelper.traitCollectionColorAppearanceChangedEvent);
+        rootView.off(IOSHelper.traitCollectionLayoutDirectionChangedEvent);
+        // An embedded window belongs to the host app, so its rootViewController is not ours
+        // to clear — `_setNativeContent` never set it in the first place.
+        if (this.role !== 'embedded' && this._window?.rootViewController) {
+            // The controller's view is moving into another window's hierarchy; leaving it
+            // installed here has UIKit holding a controller it no longer hosts.
+            this._window.rootViewController = null;
+        }
+    }
+    _onDestroy() {
+        // The trait collection listeners live on the root view, so they have to go
+        // before the base drops the reference to it.
+        if (this._rootView) {
+            this._rootView.off(IOSHelper.traitCollectionColorAppearanceChangedEvent);
+            this._rootView.off(IOSHelper.traitCollectionLayoutDirectionChangedEvent);
+        }
+        super._onDestroy();
+        this._scene = null;
+        this._window = null;
+    }
+    /**
+     * The window identity of a scene: the session persistent identifier, which iOS keeps
+     * across a disconnect and hands back when it reconnects the same session.
+     *
+     * Returns `undefined` when the scene carries no session identity — such a window gets
+     * a minted id and will not be recognised on reconnect.
+     */
+    static getSceneId(scene) {
+        const persistentIdentifier = scene?.session?.persistentIdentifier;
+        if (persistentIdentifier) {
+            return `${persistentIdentifier}`;
+        }
+        Trace.write('NativeWindow: scene has no session persistentIdentifier; window identity will not survive a reconnect.', Trace.categories.NativeLifecycle, Trace.messageType.error);
+        return undefined;
+    }
+}
+//# sourceMappingURL=native-window.ios.js.map

package/native-window/native-window.ios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-window.ios.js","sourceRoot":"","sources":["../../../../packages/core/native-window/native-window.ios.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAItD;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAgBhD,YAAY,KAAgC,EAAE,MAAgB,EAAE,EAAW,EAAE,SAAS,GAAG,KAAK,EAAE,OAAmB,aAAa;QAC/H,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAb5B;;;WAGG;QACH,oBAAe,GAAG,KAAK,CAAC;QAUvB,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAoB,EAAE,QAAkB;QACjD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,GAAG;QACN,OAAO;YACN,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,QAAQ,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACH,CAAC;IAED;;OAEG;IACO,iBAAiB,CAAC,IAAU;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAElC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9B,gFAAgF;YAChF,8EAA8E;YAC9E,oBAAoB,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;QACpF,CAAC;aAAM,CAAC;YACP,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,KAAK,IAAI,CAAC;YAChE,IAAI,CAAC,OAAO,CAAC,kBAAkB,GAAG,UAAU,CAAC;YAE7C,IAAI,CAAC,cAAc,EAAE,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAClC,CAAC;QACF,CAAC;QAED,iDAAiD;QACjD,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClE,MAAM,kBAAkB,GAAG,UAAU,CAAC,eAAe,CAAC,kBAAkB,CAAC;YACzE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,yBAAyB,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClE,MAAM,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC,eAAe,CAAC;YACnE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,wBAAwB,CAAC,eAAe,CAAC,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACJ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;YAC9D,OAAO;QACR,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;YAC9D,OAAO;QACR,CAAC;QAED,MAAM,GAAG,GAAG,aAAa,CAAC,iBAAiB,CAAC;QAC5C,IAAI,GAAG,CAAC,iDAAiD,EAAE,CAAC;YAC3D,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC5B,GAAG,CAAC,iDAAiD,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,KAAc,EAAE,EAAE;gBACvF,IAAI,KAAK,EAAE,CAAC;oBACX,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;oBAC7B,OAAO,CAAC,GAAG,CAAC,+CAA+C,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC;gBAC1F,CAAC;YACF,CAAC,CAAC,CAAC;QACJ,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;QACvF,CAAC;IACF,CAAC;IAED,2BAA2B;IAEjB,eAAe;QACxB,IAAI,YAAY,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,cAAc,EAAE,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;QAC3G,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,IAAI,CAAC,oBAAoB,CAAC,aAAa,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;IACxF,CAAC;IAES,oBAAoB;QAC7B,IAAI,CAAC,YAAY,IAAI,WAAW,IAAI,EAAE,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QACb,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC;QAChD,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;IAClF,CAAC;IAES,mBAAmB;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC;QAChD,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;IAC9E,CAAC;IAED,2BAA2B;IAEnB,oBAAoB,CAAC,WAAmB;QAC/C,QAAQ,WAAW,EAAE,CAAC;YACrB,mDAA2C;YAC3C;gBACC,OAAO,WAAW,CAAC;YACpB,uDAA+C;YAC/C;gBACC,OAAO,UAAU,CAAC;YACnB,4CAAoC;YACpC;gBACC,OAAO,SAAS,CAAC;QACnB,CAAC;IACF,CAAC;IAED,yBAAyB,CAAC,kBAA0B;QACnD,QAAQ,kBAAkB,EAAE,CAAC;YAC5B;gBACC,OAAO,MAAM,CAAC;YACf,wCAAgC;YAChC,8CAAsC;YACtC;gBACC,OAAO,OAAO,CAAC;QACjB,CAAC;IACF,CAAC;IAED,wBAAwB,CAAC,eAAuB;QAC/C,QAAQ,eAAe,EAAE,CAAC;YACzB;gBACC,OAAO,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC;YACtC,2DAAmD;YACnD;gBACC,OAAO,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC;QACvC,CAAC;IACF,CAAC;IAED,iCAAiC;IAEzB,kBAAkB,CAAC,QAAc;QACxC,IAAI,cAAc,GAAqB,QAAQ,CAAC,cAAc,IAAI,QAAQ,CAAC,GAAG,CAAC;QAE/E,IAAI,CAAC,CAAC,cAAc,YAAY,gBAAgB,CAAC,EAAE,CAAC;YACnD,cAAc,GAAG,SAAS,CAAC,sBAAsB,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAqB,CAAC;YAC3G,QAAQ,CAAC,cAAc,GAAG,cAAc,CAAC;QAC1C,CAAC;QAED,OAAO,cAAc,CAAC;IACvB,CAAC;IAEO,sBAAsB,CAAC,IAAU;QACxC,MAAM,cAAc,GAAqB,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,GAAG,CAAC;QACzE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,mBAAmB,CAAC;QAExD,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,cAAc,YAAY,SAAS,CAAC,sBAAsB,EAAE,CAAC;YAChE,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;IACF,CAAC;IAES,kBAAkB,CAAC,QAAc;QAC1C,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,0CAA0C,CAAC,CAAC;QACnE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,0CAA0C,CAAC,CAAC;QAEnE,oFAAoF;QACpF,kEAAkE;QAClE,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,CAAC;YAClE,8EAA8E;YAC9E,oEAAoE;YACpE,IAAI,CAAC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;QACxC,CAAC;IACF,CAAC;IAES,UAAU;QACnB,2EAA2E;QAC3E,6CAA6C;QAC7C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,0CAA0C,CAAC,CAAC;YACzE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,0CAA0C,CAAC,CAAC;QAC1E,CAAC;QACD,KAAK,CAAC,UAAU,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACrB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,KAAoB;QACrC,MAAM,oBAAoB,GAAG,KAAK,EAAE,OAAO,EAAE,oBAAoB,CAAC;QAClE,IAAI,oBAAoB,EAAE,CAAC;YAC1B,OAAO,GAAG,oBAAoB,EAAE,CAAC;QAClC,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,wGAAwG,EAAE,KAAK,CAAC,UAAU,CAAC,eAAe,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAEjL,OAAO,SAAS,CAAC;IAClB,CAAC;CACD"}

package/native-window/window-base.d.ts

@@ -0,0 +1,103 @@
+import { Observable } from '../data/observable';
+import type { NativeWindowEventName, WindowBaseEventData, WindowLayoutDirectionChangedEventData, WindowOrientationChangedEventData, WindowSystemAppearanceChangedEventData } from './native-window-interfaces';
+import type { AndroidActivityEventData, AndroidActivityBundleEventData, AndroidActivityResultEventData, AndroidActivityBackPressedEventData, AndroidActivityNewIntentEventData, AndroidActivityRequestPermissionsEventData, SceneEventData, SceneOpenURLContextsEventData, SceneContinueUserActivityEventData, ScenePerformActionForShortcutItemEventData } from '../application/application-interfaces';
+/**
+ * The purpose a window surface serves.
+ *
+ * - `application` – a regular app window (iOS application scene, Android activity).
+ * - `embedded` – a window hosted inside another app or container.
+ * - `carplay` – a CarPlay template scene.
+ * - `externalDisplay` – an external/secondary display scene.
+ */
+export type WindowRole = 'application' | 'embedded' | 'carplay' | 'externalDisplay';
+/**
+ * The lifecycle state of a window surface.
+ *
+ * - `attached` – connected to a live native surface.
+ * - `detached` – the native surface went away but the window may be reconnected.
+ * - `closed` – permanently torn down.
+ */
+export type WindowState = 'attached' | 'detached' | 'closed';
+/**
+ * Cross-platform base for any window surface.
+ *
+ * Carries identity, role, state, lifecycle events and the native accessors.
+ * Surfaces that host a NativeScript view tree extend {@link NativeWindow} instead.
+ */
+export declare abstract class WindowBase extends Observable {
+    private _id;
+    private _role;
+    private _state;
+    private _isPrimary;
+    constructor(id?: string, isPrimary?: boolean, role?: WindowRole);
+    get id(): string;
+    get role(): WindowRole;
+    get state(): WindowState;
+    get isPrimary(): boolean;
+    /**
+     * @internal - used by the Application to promote a window to primary.
+     */
+    _setIsPrimary(value: boolean): void;
+    /**
+     * @internal
+     */
+    _setState(value: WindowState): void;
+    get ios(): {
+        readonly scene?: UIWindowScene;
+        readonly uiWindow: UIWindow;
+    } | undefined;
+    get android(): {
+        readonly activity: androidx.appcompat.app.AppCompatActivity;
+    } | undefined;
+    /**
+     * Close this window.
+     */
+    abstract close(): void;
+    on(event: 'activate', callback: (data: WindowBaseEventData) => void, thisArg?: any): void;
+    on(event: 'deactivate', callback: (data: WindowBaseEventData) => void, thisArg?: any): void;
+    on(event: 'background', callback: (data: WindowBaseEventData) => void, thisArg?: any): void;
+    on(event: 'foreground', callback: (data: WindowBaseEventData) => void, thisArg?: any): void;
+    on(event: 'close', callback: (data: WindowBaseEventData) => void, thisArg?: any): void;
+    on(event: 'attached', callback: (data: WindowBaseEventData) => void, thisArg?: any): void;
+    on(event: 'detached', callback: (data: WindowBaseEventData) => void, thisArg?: any): void;
+    on(event: 'displayed', callback: (data: WindowBaseEventData) => void, thisArg?: any): void;
+    on(event: 'orientationChanged', callback: (data: WindowOrientationChangedEventData) => void, thisArg?: any): void;
+    on(event: 'systemAppearanceChanged', callback: (data: WindowSystemAppearanceChangedEventData) => void, thisArg?: any): void;
+    on(event: 'layoutDirectionChanged', callback: (data: WindowLayoutDirectionChangedEventData) => void, thisArg?: any): void;
+    on(event: 'activityCreated', callback: (args: AndroidActivityBundleEventData) => void, thisArg?: any): void;
+    on(event: 'activityDestroyed', callback: (args: AndroidActivityEventData) => void, thisArg?: any): void;
+    on(event: 'activityStarted', callback: (args: AndroidActivityEventData) => void, thisArg?: any): void;
+    on(event: 'activityPaused', callback: (args: AndroidActivityEventData) => void, thisArg?: any): void;
+    on(event: 'activityResumed', callback: (args: AndroidActivityEventData) => void, thisArg?: any): void;
+    on(event: 'activityStopped', callback: (args: AndroidActivityEventData) => void, thisArg?: any): void;
+    on(event: 'saveActivityState', callback: (args: AndroidActivityBundleEventData) => void, thisArg?: any): void;
+    on(event: 'activityResult', callback: (args: AndroidActivityResultEventData) => void, thisArg?: any): void;
+    on(event: 'activityBackPressed', callback: (args: AndroidActivityBackPressedEventData) => void, thisArg?: any): void;
+    on(event: 'activityNewIntent', callback: (args: AndroidActivityNewIntentEventData) => void, thisArg?: any): void;
+    on(event: 'activityRequestPermissions', callback: (args: AndroidActivityRequestPermissionsEventData) => void, thisArg?: any): void;
+    on(event: 'sceneWillConnect', callback: (args: SceneEventData) => void, thisArg?: any): void;
+    on(event: 'sceneDidActivate', callback: (args: SceneEventData) => void, thisArg?: any): void;
+    on(event: 'sceneWillResignActive', callback: (args: SceneEventData) => void, thisArg?: any): void;
+    on(event: 'sceneWillEnterForeground', callback: (args: SceneEventData) => void, thisArg?: any): void;
+    on(event: 'sceneDidEnterBackground', callback: (args: SceneEventData) => void, thisArg?: any): void;
+    on(event: 'sceneDidDisconnect', callback: (args: SceneEventData) => void, thisArg?: any): void;
+    on(event: 'sceneOpenURLContexts', callback: (args: SceneOpenURLContextsEventData) => void, thisArg?: any): void;
+    on(event: 'sceneContinueUserActivity', callback: (args: SceneContinueUserActivityEventData) => void, thisArg?: any): void;
+    on(event: 'scenePerformActionForShortcutItem', callback: (args: ScenePerformActionForShortcutItemEventData) => void, thisArg?: any): void;
+    on(eventName: string, callback: (data: WindowBaseEventData) => void, thisArg?: any): void;
+    /**
+     * @internal – emit a window lifecycle event.
+     */
+    _notifyEvent(eventName: NativeWindowEventName): void;
+    /**
+     * @internal – ends the window session for good.
+     *
+     * Listeners stay live through the whole teardown and are dropped last, so handlers
+     * registered on this instance can still observe `close` yet never outlive the window.
+     */
+    _destroy(): void;
+    /**
+     * Teardown hook for subclasses. Runs while the listeners are still registered.
+     */
+    protected _onDestroy(): void;
+}