@nativescript/vite 8.0.0-alpha.1 → 8.0.0-alpha.3

package/hmr/shared/runtime/root-placeholder.js

@@ -1,70 +1,419 @@
+import { setHmrBootStage } from './dev-overlay.js';
+function isPlaceholderView(view, placeholderRoot) {
+    if (!view) {
+        return false;
+    }
+    if (placeholderRoot && view === placeholderRoot) {
+        return true;
+    }
+    try {
+        if (view.__ns_dev_placeholder) {
+            return true;
+        }
+    }
+    catch { }
+    return false;
+}
+function getCommittedRootView(application, placeholderRoot) {
+    try {
+        const root = application?.getRootView?.() || null;
+        if (!root) {
+            return null;
+        }
+        if (!isPlaceholderView(root, placeholderRoot)) {
+            return root;
+        }
+        const currentPage = root.currentPage || root._currentEntry?.resolvedPage || null;
+        if (currentPage && !isPlaceholderView(currentPage, placeholderRoot)) {
+            return root;
+        }
+    }
+    catch { }
+    return null;
+}
+function getPlaceholderWaitDiagnosticSnapshot(g, application, placeholderRoot) {
+    const snapshot = {
+        bootComplete: !!g.__NS_HMR_BOOT_COMPLETE__,
+        hasPlaceholderRoot: !!placeholderRoot,
+        hasPlaceholderFlag: !!g.__NS_DEV_PLACEHOLDER_ROOT_EARLY__,
+        hasAngularAppRef: !!g.__NS_ANGULAR_APP_REF__,
+        hasAngularReboot: typeof g.__reboot_ng_modules__ === 'function',
+    };
+    try {
+        snapshot.applicationType = application?.constructor?.name;
+        snapshot.hasLaunched = typeof application?.hasLaunched === 'function' ? !!application.hasLaunched() : undefined;
+        snapshot.rootViewType = application?.getRootView?.()?.constructor?.name;
+    }
+    catch { }
+    try {
+        const Frame = g.Frame;
+        const topmost = Frame?.topmost?.() || null;
+        snapshot.topmostFrameType = topmost?.constructor?.name;
+        snapshot.topmostPageType = topmost?.currentPage?.constructor?.name || topmost?._currentEntry?.resolvedPage?.constructor?.name;
+    }
+    catch { }
+    return snapshot;
+}
+function restoreOriginalApplicationRun(g) {
+    const originalRun = g['__NS_DEV_ORIGINAL_APP_RUN__'];
+    if (typeof originalRun !== 'function') {
+        return;
+    }
+    const application = g['__NS_DEV_PLACEHOLDER_APPLICATION__'] || g.Application;
+    try {
+        if (application) {
+            application.run = originalRun;
+        }
+    }
+    catch { }
+    try {
+        if (g.Application && g.Application !== application) {
+            g.Application.run = originalRun;
+        }
+    }
+    catch { }
+    try {
+        const proto = application ? Object.getPrototypeOf(application) : null;
+        if (proto && typeof proto.run === 'function' && proto.run !== originalRun) {
+            proto.run = originalRun;
+        }
+    }
+    catch { }
+    delete g['__NS_DEV_ORIGINAL_APP_RUN__'];
+}
+function clearPlaceholderGlobals(g) {
+    delete g['__NS_DEV_PLACEHOLDER_ROOT_VIEW__'];
+    delete g['__NS_DEV_PLACEHOLDER_ROOT_EARLY__'];
+    delete g['__NS_DEV_BOOT_STATUS_LABEL__'];
+    delete g['__NS_DEV_BOOT_ACTIVITY_INDICATOR__'];
+    delete g['__NS_DEV_PLACEHOLDER_LAUNCH_HANDLER__'];
+    delete g['__NS_DEV_PLACEHOLDER_APPLICATION__'];
+    const timer = g['__NS_DEV_PLACEHOLDER_RESTORE_TIMER__'];
+    if (timer) {
+        try {
+            clearTimeout(timer);
+        }
+        catch { }
+    }
+    delete g['__NS_DEV_PLACEHOLDER_RESTORE_TIMER__'];
+}
+export function tryFinalizeBootPlaceholder(reason, verbose) {
+    const g = globalThis;
+    const placeholderRoot = g['__NS_DEV_PLACEHOLDER_ROOT_VIEW__'] || null;
+    const hadPlaceholder = !!placeholderRoot || !!g['__NS_DEV_PLACEHOLDER_ROOT_EARLY__'] || !!g['__NS_DEV_BOOT_STATUS_LABEL__'] || !!g['__NS_DEV_BOOT_ACTIVITY_INDICATOR__'];
+    const application = g['__NS_DEV_PLACEHOLDER_APPLICATION__'] || g.Application;
+    const committedRoot = getCommittedRootView(application, placeholderRoot);
+    if (!committedRoot) {
+        return false;
+    }
+    let detachedPlaceholder = false;
+    if (hadPlaceholder) {
+        try {
+            const launchHandler = g['__NS_DEV_PLACEHOLDER_LAUNCH_HANDLER__'];
+            if (application && typeof application.off === 'function' && launchHandler) {
+                application.off(application.launchEvent, launchHandler);
+            }
+        }
+        catch { }
+        restoreOriginalApplicationRun(g);
+        clearPlaceholderGlobals(g);
+        detachedPlaceholder = true;
+    }
+    try {
+        g.__NS_HMR_BOOT_COMPLETE__ = true;
+    }
+    catch { }
+    if (detachedPlaceholder) {
+        setHmrBootStage('app-root-committed', {
+            detail: 'The real app root replaced the boot placeholder.',
+        });
+    }
+    if (verbose) {
+        try {
+            console.info('[ns-placeholder] real app root committed', {
+                reason,
+                rootType: committedRoot?.constructor?.name || typeof committedRoot,
+                detachedPlaceholder,
+            });
+        }
+        catch { }
+    }
+    return true;
+}
+function scheduleBootPlaceholderFinalize(reason, verbose) {
+    const g = globalThis;
+    if (g['__NS_DEV_PLACEHOLDER_RESTORE_TIMER__']) {
+        return;
+    }
+    const startedAt = Date.now();
+    const maxWaitMs = 20000;
+    let attempts = 0;
+    const tick = () => {
+        delete g['__NS_DEV_PLACEHOLDER_RESTORE_TIMER__'];
+        if (tryFinalizeBootPlaceholder(reason, verbose)) {
+            return;
+        }
+        attempts += 1;
+        if (Date.now() - startedAt >= maxWaitMs) {
+            if (verbose) {
+                try {
+                    console.info('[ns-placeholder] waiting for real root commit timed out', {
+                        reason,
+                        attempts,
+                        waitMs: Date.now() - startedAt,
+                        state: getPlaceholderWaitDiagnosticSnapshot(g, g['__NS_DEV_PLACEHOLDER_APPLICATION__'] || g.Application, g['__NS_DEV_PLACEHOLDER_ROOT_VIEW__'] || null),
+                    });
+                }
+                catch { }
+            }
+            return;
+        }
+        g['__NS_DEV_PLACEHOLDER_RESTORE_TIMER__'] = setTimeout(tick, attempts === 1 ? 0 : 100);
+    };
+    tick();
+}
 // Root placeholder installer used during dev HMR until HTTP ESM loads.
+//
+// Architecture:
+//   1. Install a launchEvent handler that provides a placeholder Frame/Page
+//   2. Call Application.run() to start the iOS lifecycle (required or app terminates)
+//   3. Inside the handler (after root is set), patch Application.run so subsequent
+//      calls (from the real app module) become Application.resetRootView()
+//
+// This means the app's entry (e.g., index.ts) can call Application.run({ create })
+// exactly as it would in production — the patch intercepts it and does a clean
+// root replacement instead of fighting the already-running lifecycle.
 export function installRootPlaceholder(verbose) {
     const g = globalThis;
     if (g['__NS_DEV_PLACEHOLDER_ROOT_EARLY__'])
         return;
     g['__NS_DEV_PLACEHOLDER_ROOT_EARLY__'] = true;
+    g['__NS_DEV_RESTORE_PLACEHOLDER__'] = (reason) => {
+        if (!tryFinalizeBootPlaceholder(reason, verbose)) {
+            scheduleBootPlaceholderFinalize(reason, verbose);
+        }
+    };
     try {
+        const resolveModule = (moduleIds) => {
+            for (const moduleId of moduleIds) {
+                try {
+                    if (typeof g.moduleExists === 'function' && g.moduleExists(moduleId) && typeof g.loadModule === 'function') {
+                        const mod = g.loadModule(moduleId);
+                        if (mod)
+                            return { value: (mod.default ?? mod) || mod, via: 'loadModule', moduleId };
+                    }
+                }
+                catch { }
+                try {
+                    const reg = g.__nsVendorRegistry;
+                    if (reg?.has?.(moduleId)) {
+                        const mod = reg.get(moduleId);
+                        if (mod)
+                            return { value: (mod.default ?? mod) || mod, via: '__nsVendorRegistry', moduleId };
+                    }
+                }
+                catch { }
+                try {
+                    const req = g.__nsVendorRequire || g.__nsRequire || g.require;
+                    if (typeof req === 'function') {
+                        const mod = req(moduleId);
+                        if (mod)
+                            return { value: (mod.default ?? mod) || mod, via: 'require', moduleId };
+                    }
+                }
+                catch { }
+                try {
+                    const nr = g.__nativeRequire;
+                    if (typeof nr === 'function') {
+                        const mod = nr(moduleId, '/');
+                        if (mod)
+                            return { value: (mod.default ?? mod) || mod, via: '__nativeRequire', moduleId };
+                    }
+                }
+                catch { }
+            }
+            return undefined;
+        };
         const getCore = (name) => {
-            try {
-                const reg = g.__nsVendorRegistry;
-                const req = reg?.get ? g.__nsVendorRequire || g.__nsRequire || g.require : g.__nsRequire || g.require;
-                let mod = null;
-                if (reg && reg.has('@nativescript/core'))
-                    mod = reg.get('@nativescript/core');
-                else if (typeof req === 'function') {
-                    try {
-                        mod = req('@nativescript/core');
+            if (name === 'Application' && g.Application && (typeof g.Application.run === 'function' || typeof g.Application.on === 'function' || typeof g.Application.resetRootView === 'function')) {
+                return { value: g.Application, source: 'globalThis.Application' };
+            }
+            const pickApplicationApi = (candidate, source) => {
+                if (!candidate)
+                    return null;
+                const candidates = [
+                    { value: candidate, source },
+                    { value: candidate.Application, source: `${source}#Application` },
+                    { value: candidate.app, source: `${source}#app` },
+                    { value: candidate.application, source: `${source}#application` },
+                ];
+                for (const entry of candidates) {
+                    if (entry.value && (typeof entry.value.run === 'function' || typeof entry.value.on === 'function' || typeof entry.value.resetRootView === 'function')) {
+                        return entry;
                     }
-                    catch { }
                 }
-                const ns = (mod && (mod.default ?? mod)) || mod;
-                if (name === 'Application' && ns && (ns.Application || ns))
-                    return ns.Application || ns;
-                if (ns && ns[name])
-                    return ns[name];
+                return null;
+            };
+            if (name === 'Application') {
+                const applicationModule = resolveModule(['@nativescript/core/application']);
+                const pickedFromAppModule = pickApplicationApi(applicationModule?.value, applicationModule ? `${applicationModule.via}:${applicationModule.moduleId}` : '@nativescript/core/application');
+                if (pickedFromAppModule)
+                    return pickedFromAppModule;
             }
-            catch { }
-            try {
-                const nr = g.__nativeRequire;
-                if (typeof nr === 'function') {
-                    try {
-                        const mod = nr('@nativescript/core', '/');
-                        const ns = (mod && (mod.default ?? mod)) || mod;
-                        if (name === 'Application' && ns && (ns.Application || ns))
-                            return ns.Application || ns;
-                        if (ns && ns[name])
-                            return ns[name];
+            const primary = resolveModule(['@nativescript/core']);
+            if (name === 'Application' && primary?.value) {
+                const pickedFromPrimary = pickApplicationApi(primary.value, `${primary.via}:${primary.moduleId}`);
+                if (pickedFromPrimary)
+                    return pickedFromPrimary;
+            }
+            if (primary?.value && primary.value[name])
+                return { value: primary.value[name], source: `${primary.via}:${primary.moduleId}` };
+            const ui = resolveModule(['@nativescript/core/ui']);
+            if (ui?.value && ui.value[name])
+                return { value: ui.value[name], source: `${ui.via}:${ui.moduleId}` };
+            return { value: undefined, source: 'unresolved' };
+        };
+        const applicationResolved = getCore('Application');
+        const frameResolved = getCore('Frame');
+        const pageResolved = getCore('Page');
+        const labelResolved = getCore('Label');
+        const activityResolved = getCore('ActivityIndicator');
+        const Application = applicationResolved.value;
+        const Frame = frameResolved.value;
+        const Page = pageResolved.value;
+        const Label = labelResolved.value;
+        const ActivityIndicator = activityResolved.value;
+        if (!Application) {
+            if (verbose) {
+                console.warn('[ns-placeholder] Application unavailable', {
+                    resolution: {
+                        Application: applicationResolved.source,
+                        Frame: frameResolved.source,
+                        Page: pageResolved.source,
+                        Label: labelResolved.source,
+                    },
+                    moduleApis: {
+                        moduleExists: typeof g.moduleExists === 'function',
+                        loadModule: typeof g.loadModule === 'function',
+                        uiModuleRegistered: typeof g.moduleExists === 'function' ? !!g.moduleExists('@nativescript/core/ui') : false,
+                    },
+                });
+            }
+            return;
+        }
+        g['__NS_DEV_PLACEHOLDER_APPLICATION__'] = Application;
+        const isAndroid = !!(g.__ANDROID__ || typeof g.android !== 'undefined');
+        if (!isAndroid && typeof Application.resetRootView === 'function' && !g['__NS_DEV_PATCHED_RESET_ROOT_VIEW__']) {
+            const __ns_dev_original_reset_root_view = Application.resetRootView.bind(Application);
+            const __ns_dev_patched_reset_root_view = function __ns_dev_patched_reset_root_view(entry) {
+                const result = __ns_dev_original_reset_root_view(entry);
+                try {
+                    const restore = g['__NS_DEV_RESTORE_PLACEHOLDER__'];
+                    if (typeof restore === 'function') {
+                        restore('Application.resetRootView');
                     }
-                    catch { }
+                }
+                catch { }
+                return result;
+            };
+            Application.resetRootView = __ns_dev_patched_reset_root_view;
+            try {
+                if (g.Application && g.Application !== Application) {
+                    g.Application.resetRootView = __ns_dev_patched_reset_root_view;
                 }
             }
             catch { }
-            return undefined;
-        };
-        const Application = getCore('Application');
-        const Frame = getCore('Frame');
-        const Page = getCore('Page');
-        const Label = getCore('Label');
-        if (!Application || !Frame || !Page || !Label) {
             try {
-                console.warn('[ns-entry] (early) core classes unavailable for placeholder');
+                const proto = Object.getPrototypeOf(Application);
+                if (proto && typeof proto.resetRootView === 'function' && proto.resetRootView !== __ns_dev_patched_reset_root_view) {
+                    proto.resetRootView = __ns_dev_patched_reset_root_view;
+                }
             }
             catch { }
+            g['__NS_DEV_PATCHED_RESET_ROOT_VIEW__'] = true;
         }
+        const canCreatePlaceholderRoot = !!Frame && !!Page && !!Label;
+        if (!canCreatePlaceholderRoot && verbose) {
+            console.warn('[ns-placeholder] visual placeholder unavailable; starting lifecycle without placeholder root', {
+                resolution: {
+                    Application: applicationResolved.source,
+                    Frame: frameResolved.source,
+                    Page: pageResolved.source,
+                    Label: labelResolved.source,
+                    ActivityIndicator: activityResolved.source,
+                },
+                moduleApis: {
+                    moduleExists: typeof g.moduleExists === 'function',
+                    loadModule: typeof g.loadModule === 'function',
+                    uiModuleRegistered: typeof g.moduleExists === 'function' ? !!g.moduleExists('@nativescript/core/ui') : false,
+                },
+            });
+        }
+        let handlerFired = false;
+        // launchEvent handler: provides a placeholder root, then patches Application.run
         const __ns_launch_handler = (args) => {
+            if (verbose) {
+                try {
+                    console.info('[ns-placeholder] launch handler fired', {
+                        hasArgs: !!args,
+                        hasExistingRoot: !!args?.root,
+                        hasLaunched: typeof Application.hasLaunched === 'function' ? !!Application.hasLaunched() : undefined,
+                        started: !!Application.started,
+                    });
+                }
+                catch { }
+            }
             try {
                 const prev = args?.root;
-                if (verbose)
-                    console.info('[ns-entry] (early) launchEvent fired; existing root:', !!prev);
-                if (!prev && Frame && Page && Label) {
+                if (!prev && canCreatePlaceholderRoot && Frame && Page && Label) {
+                    const StackLayout = getCore('StackLayout').value;
                     const page = new Page();
                     page.actionBarHidden = true;
-                    const label = new Label();
-                    label.text = 'Starting NativeScript + Vite dev server…';
-                    label.textAlignment = 'center';
-                    label.padding = 12;
-                    page.content = label;
+                    const titleLabel = new Label();
+                    titleLabel.text = 'NativeScript Vite preparing dev session...';
+                    titleLabel.textAlignment = 'center';
+                    titleLabel.textWrap = true;
+                    titleLabel.fontSize = 20;
+                    const statusLabel = new Label();
+                    statusLabel.text = 'Preparing the HTTP HMR bootstrap (4%)';
+                    statusLabel.textAlignment = 'center';
+                    statusLabel.textWrap = true;
+                    statusLabel.fontSize = 14;
+                    statusLabel.marginTop = 12;
+                    const activityIndicator = ActivityIndicator
+                        ? (() => {
+                            const indicator = new ActivityIndicator();
+                            indicator.busy = true;
+                            indicator.marginTop = 16;
+                            indicator.width = 28;
+                            indicator.height = 28;
+                            indicator.horizontalAlignment = 'center';
+                            return indicator;
+                        })()
+                        : null;
+                    if (StackLayout) {
+                        const root = new StackLayout();
+                        root.padding = 24;
+                        root.verticalAlignment = 'middle';
+                        root.horizontalAlignment = 'center';
+                        root.addChild(titleLabel);
+                        root.addChild(statusLabel);
+                        if (activityIndicator) {
+                            root.addChild(activityIndicator);
+                        }
+                        page.content = root;
+                    }
+                    else {
+                        // Fallback: just show the title label centered
+                        titleLabel.verticalAlignment = 'middle';
+                        titleLabel.horizontalAlignment = 'center';
+                        titleLabel.width = 280;
+                        titleLabel.padding = 12;
+                        page.content = titleLabel;
+                    }
+                    // Store refs so the overlay API can update the status label
+                    g['__NS_DEV_BOOT_STATUS_LABEL__'] = statusLabel;
+                    g['__NS_DEV_BOOT_ACTIVITY_INDICATOR__'] = activityIndicator;
                     const frame = new Frame();
                     frame.navigate({ create: () => page, clearHistory: true, animated: false });
                     try {
@@ -73,70 +422,221 @@ export function installRootPlaceholder(verbose) {
                         g['__NS_DEV_PLACEHOLDER_ROOT_VIEW__'] = frame;
                     }
                     catch { }
+                    if (verbose) {
+                        try {
+                            console.info('[ns-placeholder] assigned placeholder root', {
+                                frameType: frame?.constructor?.name,
+                                pageType: page?.constructor?.name,
+                                hasStackLayout: !!StackLayout,
+                                hasActivityIndicator: !!activityIndicator,
+                            });
+                        }
+                        catch { }
+                    }
                     if (args)
                         args.root = frame;
-                    if (verbose)
-                        console.info('[ns-entry] (early) temporary root provided via launch args');
                 }
             }
             catch (e) {
+                console.error('[ns-placeholder] root error', e);
+            }
+            if (!handlerFired) {
+                handlerFired = true;
+                // Patch Application.run() → resetRootView() for subsequent calls.
+                // The app lifecycle is now running — a second run() is undefined
+                // behavior, but resetRootView() is the documented API for
+                // replacing the root of a running app.
+                //
+                // Patch on ALL possible references. The vendor-registry Application,
+                // globalThis.Application, and the prototype may be different objects.
                 try {
-                    console.error('[ns-entry] (early) temp root error', e);
+                    if (Application && typeof Application.run === 'function') {
+                        const _originalRun = Application.run.bind(Application);
+                        g['__NS_DEV_ORIGINAL_APP_RUN__'] = _originalRun;
+                        const __ns_dev_patched_run = function __ns_dev_patched_run(entry) {
+                            try {
+                                // Detach the launch handler, but keep placeholder refs until the
+                                // real app root is actually committed.
+                                try {
+                                    if (Application && Application.off) {
+                                        Application.off(Application.launchEvent, __ns_launch_handler);
+                                    }
+                                }
+                                catch { }
+                                // When entry is undefined/null, the calling framework (e.g. Angular)
+                                // manages root views itself via launch events and resetRootView().
+                                // Don't attempt resetRootView(undefined) which throws "Main entry is missing".
+                                if (!entry) {
+                                    if (verbose)
+                                        console.info('[ns-placeholder] patched run() called with no entry; framework manages root view');
+                                    return;
+                                }
+                                const isModuleNameEntry = entry && entry.moduleName && !entry.create;
+                                if (isModuleNameEntry) {
+                                    if (typeof Application.resetRootView === 'function') {
+                                        Application.resetRootView(entry);
+                                    }
+                                }
+                                else {
+                                    // Framework path: two-phase boot with dominative document
+                                    Application._rootView = null;
+                                    try {
+                                        const domModule = g.__nsVendorRegistry?.get?.('dominative') ||
+                                            (typeof require === 'function'
+                                                ? (() => {
+                                                    try {
+                                                        return require('dominative');
+                                                    }
+                                                    catch {
+                                                        return null;
+                                                    }
+                                                })()
+                                                : null);
+                                        const doc = domModule?.document;
+                                        if (doc && typeof Application.resetRootView === 'function') {
+                                            Application.resetRootView({ create: () => doc });
+                                            if (entry && typeof entry.create === 'function') {
+                                                entry.create();
+                                            }
+                                        }
+                                        else {
+                                            if (typeof Application.resetRootView === 'function') {
+                                                Application.resetRootView(entry);
+                                            }
+                                        }
+                                    }
+                                    catch (e2) {
+                                        if (verbose)
+                                            console.warn('[ns-placeholder] two-phase boot failed:', e2?.message || e2);
+                                        try {
+                                            if (typeof Application.resetRootView === 'function') {
+                                                Application.resetRootView(entry);
+                                            }
+                                        }
+                                        catch { }
+                                    }
+                                }
+                            }
+                            catch (e) {
+                                console.warn('[ns-placeholder] patched run() error:', e);
+                            }
+                        };
+                        Application.run = __ns_dev_patched_run;
+                        if (verbose) {
+                            try {
+                                console.info('[ns-placeholder] patched Application.run');
+                            }
+                            catch { }
+                        }
+                        if (g.Application && g.Application !== Application) {
+                            g.Application.run = __ns_dev_patched_run;
+                        }
+                        try {
+                            const proto = Object.getPrototypeOf(Application);
+                            if (proto && typeof proto.run === 'function' && proto.run !== __ns_dev_patched_run) {
+                                proto.run = __ns_dev_patched_run;
+                            }
+                        }
+                        catch { }
+                    }
                 }
                 catch { }
             }
         };
+        g['__NS_DEV_PLACEHOLDER_LAUNCH_HANDLER__'] = __ns_launch_handler;
         try {
-            g['__NS_DEV_LAUNCH_HANDLER__'] = __ns_launch_handler;
-        }
-        catch { }
-        try {
-            if (!g['__NS_DEV_LAUNCH_ATTACHED__'] && Application && Application.on) {
+            if (Application && Application.on) {
                 Application.on(Application.launchEvent, __ns_launch_handler);
-                g['__NS_DEV_LAUNCH_ATTACHED__'] = true;
             }
         }
         catch { }
+        // Determine boot path
         try {
-            g['__NS_DEV_RESTORE_PLACEHOLDER__'] = () => {
+            const appAny = Application;
+            const methodState = {
+                hasRun: typeof appAny?.run === 'function',
+                hasOn: typeof appAny?.on === 'function',
+                hasOff: typeof appAny?.off === 'function',
+                hasHasLaunched: typeof appAny?.hasLaunched === 'function',
+                hasGetRootView: typeof appAny?.getRootView === 'function',
+                hasResetRootView: typeof appAny?.resetRootView === 'function',
+                hasRunAsMainApp: typeof appAny?.runAsMainApp === 'function',
+                type: appAny?.constructor?.name,
+            };
+            if (verbose) {
                 try {
-                    if (g['__NS_DEV_LAUNCH_HANDLER__'] && Application && Application.off) {
-                        Application.off(Application.launchEvent, g['__NS_DEV_LAUNCH_HANDLER__']);
-                    }
+                    console.info('[ns-placeholder] application methods', methodState);
+                    console.info('[ns-placeholder] application source', applicationResolved.source);
                 }
                 catch { }
-                // Clear flags and drop any retained placeholder Frame reference
+            }
+            if (!appAny || typeof appAny.run !== 'function') {
+                console.warn('[ns-placeholder] Application.run unavailable', {
+                    ...methodState,
+                    source: applicationResolved.source,
+                });
+                return;
+            }
+            const hasLaunched = typeof appAny.hasLaunched === 'function' ? !!appAny.hasLaunched() : false;
+            const hasRootView = typeof appAny.getRootView === 'function' ? !!appAny.getRootView() : false;
+            const started = !!appAny.started;
+            const nativeApp = appAny.nativeApp;
+            const iosNativeApp = appAny.ios?.nativeApp;
+            const canRunAsMainApp = typeof appAny.runAsMainApp === 'function';
+            if (verbose) {
                 try {
-                    delete g['__NS_DEV_PLACEHOLDER_ROOT_EARLY__'];
+                    console.info('[ns-placeholder] boot state', {
+                        hasLaunched,
+                        hasRootView,
+                        started,
+                        nativeApp: !!nativeApp,
+                        iosNativeApp: !!iosNativeApp,
+                        canRunAsMainApp,
+                        hasResetRootView: typeof appAny.resetRootView === 'function',
+                    });
                 }
                 catch { }
+            }
+            if (hasLaunched || hasRootView) {
+                // App lifecycle is already active. Skip starting it again and only install
+                // the placeholder root/patching behavior for the existing instance.
+                if (verbose) {
+                    try {
+                        console.info('[ns-placeholder] boot branch: existing lifecycle');
+                    }
+                    catch { }
+                }
                 try {
-                    delete g['__NS_DEV_LAUNCH_ATTACHED__'];
+                    __ns_launch_handler();
                 }
                 catch { }
-                try {
-                    const fr = g['__NS_DEV_PLACEHOLDER_ROOT_VIEW__'];
-                    if (fr && typeof fr._removeFromSuperview === 'function') {
-                        try {
-                            fr._removeFromSuperview();
-                        }
-                        catch { }
+            }
+            else if (canRunAsMainApp) {
+                if (verbose) {
+                    try {
+                        console.info('[ns-placeholder] boot branch: runAsMainApp');
                     }
+                    catch { }
                 }
-                catch { }
-                try {
-                    delete g['__NS_DEV_PLACEHOLDER_ROOT_VIEW__'];
+                appAny.started = true;
+                appAny.runAsMainApp();
+            }
+            else {
+                if (verbose) {
+                    try {
+                        console.info('[ns-placeholder] boot branch: Application.run');
+                    }
+                    catch { }
                 }
-                catch { }
-            };
+                appAny.run();
+            }
+        }
+        catch (e) {
+            console.warn('[ns-placeholder] boot error', e);
         }
-        catch { }
     }
     catch (e) {
-        try {
-            console.error('[ns-entry] (early) failed to install launchEvent handler', e);
-        }
-        catch { }
+        console.error('[ns-placeholder] install failed', e);
     }
 }
 //# sourceMappingURL=root-placeholder.js.map