catalyst-core 0.2.0-beta.1 → 0.2.0-beta.3

package/dist/native/iosnativeWebView/Sources/Core/WebView/WebView.swift

@@ -31,6 +31,10 @@ public struct WebView: UIViewRepresentable, Equatable {
 
         let totalTime = (CFAbsoluteTimeGetCurrent() - start) * 1000
         logWithTimestamp("🏗️ WebView init completed (total: \(String(format: "%.2f", totalTime))ms, protocol: \(String(format: "%.2f", protocolTime))ms)")
+        CatalystPerf.add([
+            "type": "boot-activity-created",
+            "durationMs": totalTime,
+        ])
     }
     
     public func makeUIView(context: Context) -> WKWebView {
@@ -38,6 +42,14 @@ public struct WebView: UIViewRepresentable, Equatable {
         logWithTimestamp("🔨 makeUIView() started")
 
         let configuration = WKWebViewConfiguration()
+        configuration.setURLSchemeHandler(
+            OfflineURLSchemeHandler.shared,
+            forURLScheme: OfflineCacheService.offlineHTTPScheme
+        )
+        configuration.setURLSchemeHandler(
+            OfflineURLSchemeHandler.shared,
+            forURLScheme: OfflineCacheService.offlineHTTPSScheme
+        )
 
         // Hook kept for legacy behavior; currently a no-op on iOS 15+.
         WebKitConfig.applySharedProcessPoolIfNeeded(to: configuration)
@@ -46,12 +58,33 @@ public struct WebView: UIViewRepresentable, Equatable {
         preferences.allowsContentJavaScript = true
         configuration.defaultWebpagePreferences = preferences
 
+        #if DEBUG
+        if ConfigConstants.Profiler.enabled {
+            configuration.userContentController.addUserScript(
+                WKUserScript(
+                    source: "window.__CATALYST_PROFILER_ENABLED = true;",
+                    injectionTime: .atDocumentStart,
+                    forMainFrameOnly: true
+                )
+            )
+        }
+        #endif
+
         let webViewCreateStart = CFAbsoluteTimeGetCurrent()
         let webView = WKWebView(frame: .zero, configuration: configuration)
         let webViewCreateTime = (CFAbsoluteTimeGetCurrent() - webViewCreateStart) * 1000
         logWithTimestamp("📦 WKWebView created (took \(String(format: "%.2f", webViewCreateTime))ms)")
+        CatalystPerf.add([
+            "type": "boot-webview-constructed",
+            "durationMs": webViewCreateTime,
+        ])
 
         webView.navigationDelegate = navigationDelegate
+        #if DEBUG
+        if ConfigConstants.Profiler.enabled {
+            webView.scrollView.delegate = context.coordinator
+        }
+        #endif
         webView.allowsBackForwardNavigationGestures = true
         webView.isOpaque = false
         webView.backgroundColor = .clear
@@ -93,17 +126,32 @@ public struct WebView: UIViewRepresentable, Equatable {
                 let request = URLRequest(url: url)
                 logWithTimestamp("🚀 Calling webView.load()")
                 let loadStart = CFAbsoluteTimeGetCurrent()
+                CatalystPerf.add([
+                    "type": "boot-load-url",
+                    "url": url.absoluteString,
+                ])
                 webView.load(request)
                 let loadTime = (CFAbsoluteTimeGetCurrent() - loadStart) * 1000
                 logWithTimestamp("✅ webView.load() returned (took \(String(format: "%.2f", loadTime))ms)")
             } else {
                 logWithTimestamp("📴 Device offline on launch, showing offline page")
-                _ = navigationDelegate.showOfflinePage(in: webView)
+                if OfflineCacheService.shared.loadSnapshot(in: webView, for: url) {
+                    viewModel.setLoading(false, fromCache: true)
+                } else if navigationDelegate.showOfflinePage(in: webView) {
+                    viewModel.setLoading(false, fromCache: true)
+                } else {
+                    viewModel.setLoading(false, fromCache: false)
+                }
             }
         }
 
         let makeUIViewTime = (CFAbsoluteTimeGetCurrent() - makeUIViewStart) * 1000
         logWithTimestamp("🔨 makeUIView() completed (took \(String(format: "%.2f", makeUIViewTime))ms)")
+        #if DEBUG
+        if ConfigConstants.Profiler.enabled {
+            context.coordinator.startKeyboardPerfTracking(webView)
+        }
+        #endif
 
         return webView
     }
@@ -131,6 +179,9 @@ public struct WebView: UIViewRepresentable, Equatable {
         }
 
         // Clean up native bridge
+        coordinator.stopPerfMonitoring()
+        coordinator.stopKeyboardPerfTracking()
+        webView.scrollView.delegate = nil
         coordinator.nativeBridge?.unregister()
         coordinator.nativeBridge = nil
         coordinator.pluginBridge?.unregister()
@@ -149,6 +200,10 @@ public struct WebView: UIViewRepresentable, Equatable {
         var pluginBridge: PluginBridge?
         var hostingController: UIViewController?
         var isObserverAdded = false
+        private weak var perfWebView: WKWebView?
+        private var keyboardObserverTokens: [NSObjectProtocol] = []
+        private var scrollSessionOpen = false
+        private var fpsMonitor: DisplayLinkPerfMonitor?
 
         public init(_ parent: WebView) {
             self.parent = parent
@@ -175,6 +230,17 @@ public struct WebView: UIViewRepresentable, Equatable {
             pluginBridge.register()
             self.nativeBridge = bridge
             self.pluginBridge = pluginBridge
+            #if DEBUG
+            if ConfigConstants.Profiler.enabled {
+                self.fpsMonitor = DisplayLinkPerfMonitor(webView: webView)
+                self.fpsMonitor?.start()
+            }
+            #endif
+        }
+
+        func stopPerfMonitoring() {
+            fpsMonitor?.stop()
+            fpsMonitor = nil
         }
         
         @objc func handleCameraPinch(_ gesture: UIPinchGestureRecognizer) {
@@ -204,9 +270,83 @@ public struct WebView: UIViewRepresentable, Equatable {
 
         deinit {
             // Ensure observer is removed even if dismantleUIView is skipped.
+            CatalystPerf.reset()
+            stopPerfMonitoring()
+            stopKeyboardPerfTracking()
             if isObserverAdded, let webView = nativeBridge?.webView {
                 webView.removeObserver(self, forKeyPath: #keyPath(WKWebView.estimatedProgress))
             }
         }
     }
 }
+
+extension WebView.Coordinator: UIScrollViewDelegate {
+    public func scrollViewWillBeginDragging(_ scrollView: UIScrollView) {
+        guard !scrollSessionOpen else { return }
+        scrollSessionOpen = true
+        CatalystPerf.emit([
+            "type": "scroll-start",
+            "nativeTime": CatalystPerf.nativeTimeMs(),
+        ], to: perfWebView)
+    }
+
+    public func scrollViewDidEndDragging(_ scrollView: UIScrollView, willDecelerate decelerate: Bool) {
+        if !decelerate {
+            closeScrollSession()
+        }
+    }
+
+    public func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
+        closeScrollSession()
+    }
+
+    private func closeScrollSession() {
+        guard scrollSessionOpen else { return }
+        scrollSessionOpen = false
+        CatalystPerf.emit([
+            "type": "scroll-end",
+            "nativeTime": CatalystPerf.nativeTimeMs(),
+        ], to: perfWebView)
+    }
+
+    func startKeyboardPerfTracking(_ webView: WKWebView) {
+        perfWebView = webView
+        stopKeyboardPerfTracking()
+
+        let center = NotificationCenter.default
+        keyboardObserverTokens = [
+            center.addObserver(
+                forName: UIResponder.keyboardWillShowNotification,
+                object: nil,
+                queue: .main
+            ) { [weak self] notification in
+                self?.emitKeyboardEvent("keyboard-show", notification: notification)
+            },
+            center.addObserver(
+                forName: UIResponder.keyboardWillHideNotification,
+                object: nil,
+                queue: .main
+            ) { [weak self] notification in
+                self?.emitKeyboardEvent("keyboard-hide", notification: notification)
+            },
+        ]
+    }
+
+    func stopKeyboardPerfTracking() {
+        let center = NotificationCenter.default
+        keyboardObserverTokens.forEach { center.removeObserver($0) }
+        keyboardObserverTokens.removeAll()
+        perfWebView = nil
+    }
+
+    private func emitKeyboardEvent(_ type: String, notification: Notification) {
+        let frame = notification.userInfo?[UIResponder.keyboardFrameEndUserInfoKey] as? CGRect
+        let durationSeconds = notification.userInfo?[UIResponder.keyboardAnimationDurationUserInfoKey] as? Double
+        CatalystPerf.emit([
+            "type": type,
+            "nativeTime": CatalystPerf.nativeTimeMs(),
+            "keyboardHeight": frame?.height ?? 0,
+            "durationMs": Int((durationSeconds ?? 0) * 1000),
+        ], to: perfWebView)
+    }
+}

package/dist/native/iosnativeWebView/Sources/Core/WebView/WebViewNavigationDelegate.swift

@@ -9,9 +9,13 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
     private let offlineFileName = "offline.html"
     private let offlineSubdirectory = "offline"
     private var offlinePageVisible = false
+    private var offlineSnapshotVisibleURL: String?
     private var lastTargetURL: URL?
     private let initialURL: URL?
     private weak var cameraManager: NativeCameraManager?
+    private var pageLoadStartMs: Int64?
+    private var didEmitColdStart = false
+    private var hasStartedProfilerNavigation = false
 
     init(viewModel: WebViewModel, initialURL: URL?, cameraManager: NativeCameraManager? = nil) {
         self.viewModel = viewModel
@@ -46,6 +50,7 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
         // Only inject on main frame to match Android behavior (not on subresources)
         let isMainFrame = navigationAction.targetFrame?.isMainFrame ?? false
         let isHttpScheme = ["http", "https"].contains(url.scheme?.lowercased() ?? "")
+        let isCatalystOfflineURL = OfflineCacheService.shared.originalURL(forOfflineURL: url) != nil
 
         if isMainFrame && isHttpScheme && httpMethod == "GET" {
             let safeAreaHeaders = viewModel.getSafeAreaHeaders()
@@ -86,7 +91,7 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
             return
         }
 
-        if URLWhitelistManager.shared.isAccessControlEnabled {
+        if URLWhitelistManager.shared.isAccessControlEnabled && !isCatalystOfflineURL {
 
             // Check if URL is an external domain
             let isExternal = URLWhitelistManager.shared.isExternalDomain(url)
@@ -107,8 +112,10 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
             }
 
             logger.info("✅ URL passed whitelist checks, allowing navigation: \(url.absoluteString)")
-        } else {
+        } else if !isCatalystOfflineURL {
             logger.info("⚠️ Access control disabled, allowing all navigation: \(url.absoluteString)")
+        } else {
+            logger.info("📴 Catalyst offline URL allowed: \(url.absoluteString)")
         }
 
         if ["http", "https"].contains(url.scheme?.lowercased() ?? "") {
@@ -120,16 +127,57 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
             let isCacheableMethod = httpMethod == "GET"
             logger.info("🔍 Cache check - Method: \(httpMethod), isCacheable: \(isCacheableMethod)")
 
+            if isMainFrame && isHttpScheme && isCacheableMethod {
+                if NetworkMonitor.shared.currentStatus.isOnline {
+                    let isOfflineRoute = await OfflineCacheService.shared.prepareActiveOfflineRoute(
+                        for: navigationAction.request,
+                        webView: webView
+                    )
+                    offlineSnapshotVisibleURL = nil
+                    if !isOfflineRoute {
+                        logger.info("⏭️ Main-frame route is not currently offline eligible: \(url.absoluteString)")
+                    }
+                    OfflineCacheService.shared.storeRouteSnapshot(
+                        for: navigationAction.request,
+                        webView: webView
+                    )
+                } else {
+                    let loadedSnapshot = await MainActor.run {
+                        loadCachedSnapshotIfNeeded(in: webView, for: url)
+                    }
+
+                    if loadedSnapshot {
+                        logger.info("📴 Serving cached offline route snapshot: \(url.absoluteString)")
+                        decisionHandler(.cancel)
+                        return
+                    }
+                    OfflineCacheService.shared.clearActiveOfflineRoute()
+                }
+            } else if isMainFrame && isHttpScheme {
+                OfflineCacheService.shared.clearActiveOfflineRoute()
+            }
+
             if isCacheableMethod && CacheManager.shared.shouldCacheURL(url) {
-                logger.info("🎯 URL matches cache pattern: \(url.absoluteString)")
+            logger.info("🎯 URL matches cache pattern: \(url.absoluteString)")
 
+                let cacheStartMs = CatalystPerf.nativeTimeMs()
                 let (cachedData, cacheState, mimeType) = await CacheManager.shared.getCachedResource(
                     for: navigationAction.request
                 )
+                let cacheDurationMs = CatalystPerf.nativeTimeMs() - cacheStartMs
                 
                 switch cacheState {
                 case .fresh, .stale:
                     logger.info("✅ Serving fresh/stale cached content")
+                    CatalystPerf.add([
+                        "type": "cache-hit-memory",
+                        "url": url.absoluteString,
+                        "resourceType": "document",
+                        "nativeTime": cacheStartMs,
+                        "nativeStartMs": cacheStartMs,
+                        "durationMs": cacheDurationMs,
+                        "source": cacheState == .fresh ? "fresh" : "stale",
+                    ])
 
                     if let cachedData = cachedData,
                        let mimeType = mimeType {
@@ -148,6 +196,14 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
                     
                 case .expired:
                     logger.info("♻️ Cache expired, fetching fresh content")
+                    CatalystPerf.add([
+                        "type": "cache-miss-fetch",
+                        "url": url.absoluteString,
+                        "resourceType": "document",
+                        "nativeTime": cacheStartMs,
+                        "nativeStartMs": cacheStartMs,
+                        "durationMs": cacheDurationMs,
+                    ])
                     break
                 }
             } else {
@@ -201,6 +257,25 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
     
     func webView(_ webView: WKWebView, didStartProvisionalNavigation navigation: WKNavigation!) {
         logWithTimestamp("📡 didStartProvisionalNavigation - loading started")
+        if hasStartedProfilerNavigation {
+            CatalystPerf.reset()
+        }
+        hasStartedProfilerNavigation = true
+        let nativeNow = CatalystPerf.nativeTimeMs()
+        pageLoadStartMs = nativeNow
+        CatalystPerf.injectNativeTimeOffset(into: webView)
+        if let url = webView.url?.absoluteString ?? lastTargetURL?.absoluteString {
+            CatalystPerf.add([
+                "type": "boot-page-started",
+                "nativeTime": nativeNow,
+                "url": url,
+            ])
+            CatalystPerf.add([
+                "type": "page-load-start",
+                "nativeTime": nativeNow,
+                "url": url,
+            ])
+        }
         // Stop camera on navigation — mirrors Android CustomWebview onPageStarted lambda
         cameraManager?.stop()
         Task { @MainActor in
@@ -227,6 +302,32 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
 
     func webView(_ webView: WKWebView, didFinish navigation: WKNavigation!) {
         logWithTimestamp("🎉 didFinish - page fully loaded")
+        let nativeNow = CatalystPerf.nativeTimeMs()
+        let url = webView.url?.absoluteString ?? lastTargetURL?.absoluteString ?? ""
+        let durationMs = pageLoadStartMs.map { nativeNow - $0 } ?? 0
+        CatalystPerf.add([
+            "type": "boot-page-finished",
+            "nativeTime": nativeNow,
+            "url": url,
+        ])
+        CatalystPerf.add([
+            "type": "page-load-end",
+            "nativeTime": nativeNow,
+            "url": url,
+            "durationMs": durationMs,
+        ])
+        if !didEmitColdStart {
+            didEmitColdStart = true
+            CatalystPerf.add([
+                "type": "cold-start",
+                "nativeTime": nativeNow,
+                "url": url,
+                "durationMs": nativeNow - AppBoot.nativeStartMs,
+            ])
+        }
+        CatalystPerf.memorySnapshot(to: nil, label: "page-finish")
+        CatalystPerf.scheduleFlush(webView)
+
         Task { @MainActor in
             if let url = webView.url {
                 if !isOfflinePageURL(url) {
@@ -253,12 +354,31 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
     }
 
     private func handleNavigationError(_ error: Error, webView: WKWebView?) {
+        CatalystPerf.emit([
+            "type": "page-load-error",
+            "nativeTime": CatalystPerf.nativeTimeMs(),
+            "url": webView?.url?.absoluteString ?? lastTargetURL?.absoluteString ?? "",
+            "description": error.localizedDescription,
+        ], to: webView)
+
         Task { @MainActor in
             viewModel.reset()
             logWithTimestamp("🔴 Navigation error: \(error.localizedDescription)")
             logger.error("Navigation failed: \(error.localizedDescription)")
 
             guard shouldShowOfflinePage(for: error), let webView else { return }
+            if let targetURL = lastTargetURL ?? webView.url,
+               isOfflineSnapshotVisible(for: targetURL) {
+                logger.info("📴 Ignoring repeated error for visible offline route snapshot")
+                return
+            }
+
+            if let targetURL = lastTargetURL ?? webView.url,
+               loadCachedSnapshotIfNeeded(in: webView, for: targetURL) {
+                logger.info("📴 Showing cached offline route snapshot")
+                return
+            }
+
             if showOfflinePage(in: webView) {
                 logger.info("📴 Showing offline fallback page")
             } else {
@@ -320,6 +440,8 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
         }
 
         offlinePageVisible = false
+        offlineSnapshotVisibleURL = nil
+        OfflineCacheService.shared.clearActiveOfflineRoute()
         logWithTimestamp("🔄 Retry requested, online. Reloading: \(targetURL.absoluteString)")
         webView.load(URLRequest(url: targetURL))
     }
@@ -351,8 +473,11 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
         }
 
         offlinePageVisible = true
+        offlineSnapshotVisibleURL = nil
+        OfflineCacheService.shared.clearActiveOfflineRoute()
         let readAccessURL = offlineURL.deletingLastPathComponent()
         webView.loadFileURL(offlineURL, allowingReadAccessTo: readAccessURL)
+        viewModel.setLoading(false, fromCache: true)
         return true
     }
     
@@ -396,4 +521,33 @@ class WebViewNavigationDelegate: NSObject, WKNavigationDelegate {
         
         return true
     }
+
+    private func loadCachedSnapshotIfNeeded(in webView: WKWebView, for url: URL) -> Bool {
+        let key = snapshotKey(for: url)
+        if offlineSnapshotVisibleURL == key {
+            return true
+        }
+
+        if OfflineCacheService.shared.loadSnapshot(in: webView, for: url) {
+            offlinePageVisible = false
+            offlineSnapshotVisibleURL = key
+            viewModel.setLoading(false, fromCache: true)
+            return true
+        }
+
+        offlineSnapshotVisibleURL = nil
+        return false
+    }
+
+    private func isOfflineSnapshotVisible(for url: URL) -> Bool {
+        offlineSnapshotVisibleURL == snapshotKey(for: url)
+    }
+
+    private func snapshotKey(for url: URL) -> String {
+        guard var components = URLComponents(url: url, resolvingAgainstBaseURL: false) else {
+            return url.absoluteString
+        }
+        components.fragment = nil
+        return components.url?.absoluteString ?? url.absoluteString
+    }
 }

package/dist/native/iosnativeWebView/iosnativeWebViewTests/BridgeMessageValidatorTests.swift

@@ -386,6 +386,19 @@ final class BridgeMessageValidatorTests: XCTestCase {
         XCTAssertEqual(result.command, "openCamera")
     }
 
+    func testTraceExportAvailabilityRequiresDebugProfiler() {
+        XCTAssertTrue(CatalystConstants.Bridge.isTraceExportEnabled(debugBuild: true, profilerEnabled: true))
+        XCTAssertFalse(CatalystConstants.Bridge.isTraceExportEnabled(debugBuild: false, profilerEnabled: true))
+        XCTAssertFalse(CatalystConstants.Bridge.isTraceExportEnabled(debugBuild: true, profilerEnabled: false))
+    }
+
+    func testTraceExportAllowlistMatchesAvailabilityGate() {
+        XCTAssertEqual(
+            CatalystConstants.Bridge.validCommands.contains("exportCatalystTrace"),
+            CatalystConstants.Bridge.isTraceExportEnabled()
+        )
+    }
+
     // ========================================
     // MARK: - Helper Methods
     // ========================================

package/dist/native/renameAndroidProject.js

@@ -56,9 +56,9 @@ const keystorePath=_path.default.join(tempDeploymentPath,"app","keystore.jks");i
 await cleanupTempDeployment(tempDeploymentPath);return{...aabResult,finalAabPath,finalAabName,outputDir};}catch(error){throw new Error(`Failed to finalize AAB: ${error.message}`);}}async function cleanupTempDeployment(tempDeploymentPath){if(!tempDeploymentPath||!_fs.default.existsSync(tempDeploymentPath)){return;}try{progress.log("Cleaning up temporary deployment files...","info");(0,_utils.runCommand)(`rm -rf "${tempDeploymentPath}"`);progress.log("Temporary files cleaned up successfully","success");}catch(error){progress.log(`Warning: Could not cleanup temporary directory: ${error.message}`,"warning");}}async function updateFileContents(projectPaths,androidConfig){const{newProjectPath}=projectPaths;const{oldProjectName,newProjectName,packageName}=androidConfig;progress.log("Updating file contents and names...","info");try{// STEP 1: Update packageName in build.gradle.kts and source files
 if(packageName){const OLD_PACKAGE="io.yourname.androidproject";progress.log(`Replacing package name: ${OLD_PACKAGE} → ${packageName}`,"info");// Update build.gradle.kts
 const buildGradlePath=_path.default.join(newProjectPath,"app","build.gradle.kts");if(_fs.default.existsSync(buildGradlePath)){let content=_fs.default.readFileSync(buildGradlePath,"utf8");content=content.replace(/namespace = "io\.yourname\.androidproject"/g,`namespace = "${packageName}"`);content=content.replace(/applicationId = "io\.yourname\.androidproject"/g,`applicationId = "${packageName}"`);_fs.default.writeFileSync(buildGradlePath,content,"utf8");progress.log(`✅ Updated build.gradle.kts with package: ${packageName}`,"success");}// Update source directory structure for all source sets
-const sourceSets=["main","test","noFcm","withFcm"];const newPackageParts=packageName.split(".");let totalUpdatedFiles=0;for(const sourceSet of sourceSets){const oldPackagePath=_path.default.join(newProjectPath,"app","src",sourceSet,"java","io","yourname","androidproject");if(_fs.default.existsSync(oldPackagePath)){const newPackagePath=_path.default.join(newProjectPath,"app","src",sourceSet,"java",...newPackageParts);// Create new package directory
+const sourceSets=["main","test","noFcm","withFcm"];const newPackageParts=packageName.split(".");let totalUpdatedFiles=0;for(const sourceSet of sourceSets){const oldPackagePath=_path.default.join(newProjectPath,"app","src",sourceSet,"java","io","yourname","androidproject");if(_fs.default.existsSync(oldPackagePath)){const newPackagePath=_path.default.join(newProjectPath,"app","src",sourceSet,"java",...newPackageParts);const packagePathChanged=_path.default.resolve(oldPackagePath)!==_path.default.resolve(newPackagePath);if(packagePathChanged){// Create new package directory
 const newPackageDir=_path.default.dirname(newPackagePath);_fs.default.mkdirSync(newPackageDir,{recursive:true})// Move source files
-;(0,_utils.runCommand)(`mv "${oldPackagePath}" "${newPackagePath}"`);progress.log(`✅ Moved ${sourceSet} source files to: ${newPackagePath}`,"success");// Update package declarations in source files
+;(0,_utils.runCommand)(`mv "${oldPackagePath}" "${newPackagePath}"`);progress.log(`✅ Moved ${sourceSet} source files to: ${newPackagePath}`,"success");}else{progress.log(`Package path unchanged for ${sourceSet}; skipping source directory move`,"info");}// Update package declarations in source files
 const findCommand=`find "${newPackagePath}" -type f \\( -name "*.kt" -o -name "*.java" \\)`;const sourceFiles=(0,_utils.runCommand)(findCommand).trim().split("\n").filter(f=>f.trim());let updatedCount=0;for(const file of sourceFiles){let content=_fs.default.readFileSync(file,"utf8");if(content.includes(OLD_PACKAGE)){content=content.replace(new RegExp(OLD_PACKAGE,"g"),packageName);_fs.default.writeFileSync(file,content,"utf8");updatedCount++;}}totalUpdatedFiles+=updatedCount;progress.log(`✅ Updated package declarations in ${updatedCount} ${sourceSet} files`,"success");// Clean up old empty directories
 try{;(0,_utils.runCommand)(`find "${_path.default.join(newProjectPath,"app","src",sourceSet,"java")}" -type d -empty -delete`);}catch(err){// Ignore cleanup errors
 }}}if(totalUpdatedFiles>0){progress.log(`✅ Total package declarations updated: ${totalUpdatedFiles} files`,"success");}// Update AndroidManifest.xml

package/dist/offline/catalyst-sw.js

@@ -0,0 +1 @@
+"use strict";/* eslint-disable no-restricted-globals */const MANIFEST_URL="/catalyst-offline-manifest.json";const OFFLINE_URL="/offline.html";const CACHE_PREFIX="catalyst-offline";const MANIFEST_CACHE=`${CACHE_PREFIX}-manifest`;self.addEventListener("install",event=>{event.waitUntil((async()=>{await loadManifest(true);await cacheOfflineFallback();await self.skipWaiting();})());});self.addEventListener("activate",event=>{event.waitUntil((async()=>{await cleanupOldCaches();await self.clients.claim();})());});self.addEventListener("fetch",event=>{const{request}=event;if(request.method!=="GET")return;if(request.mode==="navigate"||request.destination==="document"){event.respondWith(handleNavigation(request));return;}if(["script","style","font","image"].includes(request.destination)){event.respondWith(handleAsset(request));}});async function loadManifest(preferNetwork){const cache=await caches.open(MANIFEST_CACHE);if(preferNetwork){try{const response=await fetch(MANIFEST_URL,{cache:"no-store"});if(response.ok){await cache.put(MANIFEST_URL,response.clone());const manifest=await response.json();cleanupOldCaches(manifest);return manifest;}}catch(_){}}const cached=await cache.match(MANIFEST_URL);if(cached)return cached.json();return{buildId:"unknown",routes:[]};}async function cacheOfflineFallback(){try{const cache=await caches.open(`${CACHE_PREFIX}-fallback`);const response=await fetch(OFFLINE_URL,{cache:"no-store"});if(response.ok)await cache.put(OFFLINE_URL,response);}catch(_){}}function routeCacheName(manifest){return`${CACHE_PREFIX}-routes-${manifest.buildId}`;}function assetCacheName(manifest){return`${CACHE_PREFIX}-assets-${manifest.buildId}`;}async function cleanupOldCaches(manifest){manifest=manifest||(await loadManifest(false));if(!manifest.buildId||manifest.buildId==="unknown")return;const keep=new Set([MANIFEST_CACHE,`${CACHE_PREFIX}-fallback`,routeCacheName(manifest),assetCacheName(manifest)]);const cacheNames=await caches.keys();await Promise.all(cacheNames.filter(name=>name.startsWith(CACHE_PREFIX)&&!keep.has(name)).map(name=>caches.delete(name)));}function isOfflineRoute(url,manifest){const{pathname}=new URL(url);return(manifest.routes||[]).some(route=>{try{return new RegExp(route.regex).test(pathname);}catch(_){return false;}});}function canStore(response){return!!(response&&(response.ok||response.type==="opaque"));}async function handleNavigation(request){const manifest=await loadManifest(true);if(!isOfflineRoute(request.url,manifest))return fetch(request);const cache=await caches.open(routeCacheName(manifest));try{const response=await fetch(request);const contentType=response.headers.get("content-type")||"";if(canStore(response)&&contentType.includes("text/html")){await cache.put(request.url,response.clone());}return response;}catch(_){const cached=await cache.match(request.url);if(cached)return cached;const offlineResponse=await caches.match(OFFLINE_URL);if(offlineResponse)return offlineResponse;return fetch(OFFLINE_URL);}}async function handleAsset(request){const manifest=await loadManifest(false);const cache=await caches.open(assetCacheName(manifest));const cached=await cache.match(request);if(cached)return cached;const response=await fetch(request);if(canStore(response))await cache.put(request,response.clone());return response;}

package/dist/offline/registerServiceWorker.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.registerCatalystServiceWorker=registerCatalystServiceWorker;let registered=false;function isNativeWebView(){if(typeof window==="undefined")return false;return!!(window.NativeBridge||window.webkit?.messageHandlers?.NativeBridge);}function registerCatalystServiceWorker(){if(registered)return;if(typeof window==="undefined"||typeof navigator==="undefined")return;if(process.env.NODE_ENV!=="production")return;if(isNativeWebView())return;if(!("serviceWorker"in navigator))return;registered=true;const register=()=>{navigator.serviceWorker.register("/catalyst-sw.js",{scope:"/",updateViaCache:"none"}).catch(()=>{registered=false;});};if(document.readyState==="complete"){register();}else{window.addEventListener("load",register,{once:true});}}

package/dist/router/ClientRouter.js

@@ -1,3 +1,3 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;var _router=require("@tata1mg/router");const{preparedRoutes}=require(`${process.env.src_path}/src/js/routes/utils.js`);/**
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;var _router=require("@tata1mg/router");var _registerServiceWorker=require("../offline/registerServiceWorker.js");const{preparedRoutes}=require(`${process.env.src_path}/src/js/routes/utils.js`);(0,_registerServiceWorker.registerCatalystServiceWorker)();/**
  * @returns returns browsers routers (client routes)
  */const clientRouter=({store,routerInitialState})=>(0,_router.createBrowserRouter)(preparedRoutes({store,routerInitialState}));var _default=exports.default=clientRouter;

package/dist/scripts/build.js

@@ -1,3 +1,3 @@
 "use strict";const path=require("path");const{green,cyan,yellow}=require("picocolors");const{name}=require(`${process.cwd()}/package.json`);const{BUILD_OUTPUT_PATH}=require(`${process.cwd()}/config/config.json`);const{arrayToObject,printBundleInformation,runBuildCommands}=require("./scriptUtils.js");/**
  * @description - creates a production build of the application.
- */function build(){const isWindows=process.platform==="win32";const commandLineArguments=process.argv.slice(2);const argumentsObject=arrayToObject(commandLineArguments);const dirname=path.resolve(__dirname,"../../");const commands=["node ./dist/scripts/checkVersion",`${isWindows?"rd -r -fo":"rm -rf"} ${process.cwd()}/${BUILD_OUTPUT_PATH} & node ./dist/scripts/loadScriptsBeforeServerStarts.js`,`cross-env APPLICATION=${name||"catalyst_app"} webpack --config ./dist/webpack/production.client.babel.js --progress`,`cross-env APPLICATION=${name||"catalyst_app"} SSR=true webpack --config ./dist/webpack/production.ssr.babel.js`,`cross-env APPLICATION=${name||"catalyst_app"} npx babel ./dist/server --out-dir ${process.cwd()}/${BUILD_OUTPUT_PATH} --ignore '**/*.test.js,./dist/server/renderer/handler.js' --quiet`,`cross-env APPLICATION=${name||"catalyst_app"} npx babel ${process.cwd()}/server --out-dir ${process.cwd()}/${BUILD_OUTPUT_PATH} --quiet`];console.log("Creating an optimized production build...");runBuildCommands({commands,cwd:dirname,env:{...process.env,src_path:process.cwd(),BUILD_OUTPUT_PATH:BUILD_OUTPUT_PATH,NODE_ENV:"production",IS_DEV_COMMAND:false,...argumentsObject}});console.log(green("Compiled successfully."));console.log("\nFile sizes after gzip:\n");printBundleInformation();console.log(`\nThe ${cyan(BUILD_OUTPUT_PATH)} folder is ready to be deployed.`);console.log("You may serve it with a serve command:");console.log(cyan("\n npm run serve"));console.log("\nFind out more about deployment here:");console.log(yellow("\n https://catalyst.1mg.com/public_docs/content/Deployment%20and%20Production/deployment\n"));}build();
+ */function build(){const isWindows=process.platform==="win32";const commandLineArguments=process.argv.slice(2);const argumentsObject=arrayToObject(commandLineArguments);const dirname=path.resolve(__dirname,"../../");const commands=["node ./dist/scripts/checkVersion",`${isWindows?"rd -r -fo":"rm -rf"} ${process.cwd()}/${BUILD_OUTPUT_PATH} & node ./dist/scripts/loadScriptsBeforeServerStarts.js`,`cross-env APPLICATION=${name||"catalyst_app"} webpack --config ./dist/webpack/production.client.babel.js --progress`,`cross-env APPLICATION=${name||"catalyst_app"} SSR=true webpack --config ./dist/webpack/production.ssr.babel.js`,`cross-env APPLICATION=${name||"catalyst_app"} node ./dist/scripts/generateOfflineManifest.js`,`cross-env APPLICATION=${name||"catalyst_app"} npx babel ./dist/server --out-dir ${process.cwd()}/${BUILD_OUTPUT_PATH} --extensions .js,.ts,.jsx,.tsx --ignore '**/*.test.js,./dist/server/renderer/handler.js' --quiet`,`cross-env APPLICATION=${name||"catalyst_app"} npx babel ${process.cwd()}/server --out-dir ${process.cwd()}/${BUILD_OUTPUT_PATH} --extensions .js,.ts,.jsx,.tsx --quiet`];console.log("Creating an optimized production build...");runBuildCommands({commands,cwd:dirname,env:{...process.env,src_path:process.cwd(),BUILD_OUTPUT_PATH:BUILD_OUTPUT_PATH,NODE_ENV:"production",IS_DEV_COMMAND:false,...argumentsObject}});console.log(green("Compiled successfully."));console.log("\nFile sizes after gzip:\n");printBundleInformation();console.log(`\nThe ${cyan(BUILD_OUTPUT_PATH)} folder is ready to be deployed.`);console.log("You may serve it with a serve command:");console.log(cyan("\n npm run serve"));console.log("\nFind out more about deployment here:");console.log(yellow("\n https://catalyst.1mg.com/public_docs/content/Deployment%20and%20Production/deployment\n"));}build();

package/dist/scripts/devBuild.js

@@ -1,3 +1,3 @@
 "use strict";const path=require("path");const{green,cyan,yellow}=require("picocolors");const{name}=require(`${process.cwd()}/package.json`);const{BUILD_OUTPUT_PATH}=require(`${process.cwd()}/config/config.json`);const{arrayToObject,printBundleInformation,runBuildCommands}=require("./scriptUtils.js");/**
  * @description - creates a production build of the application.
- */function devBuild(){const isWindows=process.platform==="win32";const commandLineArguments=process.argv.slice(2);const argumentsObject=arrayToObject(commandLineArguments);const dirname=path.resolve(__dirname,"../../");const commands=["node ./dist/scripts/checkVersion",`${isWindows?"rd -r -fo":"rm -rf"} ${process.cwd()}/${BUILD_OUTPUT_PATH} & node ./dist/scripts/loadScriptsBeforeServerStarts.js`,`cross-env APPLICATION=${name||"catalyst_app"} webpack --config ./dist/webpack/production.client.babel.js --progress`,` cross-env APPLICATION=${name||"catalyst_app"} SSR=true webpack --config ./dist/webpack/production.ssr.babel.js`,`cross-env APPLICATION=${name||"catalyst_app"} npx babel ./dist/server --out-dir ${process.cwd()}/${BUILD_OUTPUT_PATH} --ignore '**/*.test.js,./dist/server/renderer/handler.js' --quiet`,`cross-env APPLICATION=${name||"catalyst_app"} npx babel ${process.cwd()}/server --out-dir ${process.cwd()}/${BUILD_OUTPUT_PATH} --quiet`];console.log("Creating an optimized local build...");runBuildCommands({commands,cwd:dirname,env:{...process.env,src_path:process.cwd(),BUILD_OUTPUT_PATH:BUILD_OUTPUT_PATH,NODE_ENV:"production",IS_DEV_COMMAND:true,...argumentsObject}});console.log(green("Compiled successfully."));console.log("\nFile sizes after gzip:\n");printBundleInformation();console.log(`\nThe ${cyan(BUILD_OUTPUT_PATH)} folder is ready to be deployed.`);console.log("You may serve it with a serve command:");console.log(cyan("\n npm run devServe"));console.log("\nFind out more about deployment here:");console.log(yellow("\n https://catalyst.1mg.com/public_docs/content/Deployment%20and%20Production/deployment\n"));}devBuild();
+ */function devBuild(){const isWindows=process.platform==="win32";const commandLineArguments=process.argv.slice(2);const argumentsObject=arrayToObject(commandLineArguments);const dirname=path.resolve(__dirname,"../../");const commands=["node ./dist/scripts/checkVersion",`${isWindows?"rd -r -fo":"rm -rf"} ${process.cwd()}/${BUILD_OUTPUT_PATH} & node ./dist/scripts/loadScriptsBeforeServerStarts.js`,`cross-env APPLICATION=${name||"catalyst_app"} webpack --config ./dist/webpack/production.client.babel.js --progress`,`cross-env APPLICATION=${name||"catalyst_app"} SSR=true webpack --config ./dist/webpack/production.ssr.babel.js`,`cross-env APPLICATION=${name||"catalyst_app"} node ./dist/scripts/generateOfflineManifest.js`,`cross-env APPLICATION=${name||"catalyst_app"} npx babel ./dist/server --out-dir ${process.cwd()}/${BUILD_OUTPUT_PATH} --ignore '**/*.test.js,./dist/server/renderer/handler.js' --quiet`,`cross-env APPLICATION=${name||"catalyst_app"} npx babel ${process.cwd()}/server --out-dir ${process.cwd()}/${BUILD_OUTPUT_PATH} --quiet`];console.log("Creating an optimized local build...");runBuildCommands({commands,cwd:dirname,env:{...process.env,src_path:process.cwd(),BUILD_OUTPUT_PATH:BUILD_OUTPUT_PATH,NODE_ENV:"production",IS_DEV_COMMAND:true,...argumentsObject}});console.log(green("Compiled successfully."));console.log("\nFile sizes after gzip:\n");printBundleInformation();console.log(`\nThe ${cyan(BUILD_OUTPUT_PATH)} folder is ready to be deployed.`);console.log("You may serve it with a serve command:");console.log(cyan("\n npm run devServe"));console.log("\nFind out more about deployment here:");console.log(yellow("\n https://catalyst.1mg.com/public_docs/content/Deployment%20and%20Production/deployment\n"));}devBuild();

package/dist/scripts/generateOfflineManifest.js

@@ -0,0 +1 @@
+"use strict";const fs=require("fs");const path=require("path");function toRoutePath(basePath,routePath,isIndex){if(isIndex||routePath===undefined||routePath===null||routePath===""){return basePath||"/";}const nextPath=String(routePath).startsWith("/")?routePath:`${basePath}/${routePath}`;return`/${nextPath}`.replace(/\/+/g,"/").replace(/\/$/,"")||"/";}function routeRegex(pattern,exact=false){if(pattern==="*"||pattern==="/*")return"^/.*$";if(pattern==="/")return exact?"^/$":"^/.*$";const parts=pattern.split("/").filter(Boolean);const regex=parts.map(part=>{if(part==="*")return".*";if(part.startsWith(":"))return"[^/]+";return part.replace(/[|\\{}()[\]^$+?.]/g,"\\$&");}).join("/");return exact?`^/${regex}$`:`^/${regex}(?:/.*)?$`;}function collectOfflineRoutes(routes,basePath="",parentOffline=false,result=[]){for(const route of Array.isArray(routes)?routes:[]){if(!route||typeof route!=="object")continue;const offline=Object.prototype.hasOwnProperty.call(route,"offline")?route.offline===true:parentOffline;const isIndexRoute=route.index===true||route.path==="";const pattern=toRoutePath(basePath,route.path,isIndexRoute);const regex=routeRegex(pattern,isIndexRoute);if(offline&&!result.some(item=>item.pattern===pattern&&item.regex===regex)){result.push({pattern,regex});}collectOfflineRoutes(route.children,pattern,offline,result);}return result;}function loadAppRoutes(){require("./loadScriptsBeforeServerStarts.js");const emptyModule=()=>null;[".css",".scss",".sass",".less",".png",".jpg",".jpeg",".gif",".svg",".webp"].forEach(ext=>{require.extensions[ext]=emptyModule;});require("@babel/register")({babelrc:false,extensions:[".js",".jsx",".ts",".tsx"],ignore:[/node_modules/],presets:[["@babel/preset-env",{targets:{node:"current"}}],["@babel/preset-react",{runtime:"automatic"}],["@babel/preset-typescript",{isTSX:true,allExtensions:true}]],plugins:["@loadable/babel-plugin"]});const{getRoutes}=require(path.join(process.env.src_path,"src/js/routes/utils.js"));return typeof getRoutes==="function"?getRoutes():[];}function copyIfExists(source,destination){if(fs.existsSync(source))fs.copyFileSync(source,destination);}function main(){const appConfig=require(path.join(process.env.src_path,"config/config.json"));const publicDir=path.join(process.env.src_path,process.env.BUILD_OUTPUT_PATH||appConfig.BUILD_OUTPUT_PATH,"public");const routes=collectOfflineRoutes(loadAppRoutes());fs.mkdirSync(publicDir,{recursive:true});fs.writeFileSync(path.join(publicDir,"catalyst-offline-manifest.json"),`${JSON.stringify({schemaVersion:1,buildId:Date.now().toString(36),routes},null,2)}\n`);copyIfExists(path.join(process.env.src_path,"public/offline.html"),path.join(publicDir,"offline.html"));fs.copyFileSync(path.join(__dirname,"../offline/catalyst-sw.js"),path.join(publicDir,"catalyst-sw.js"));console.log(`Catalyst offline manifest generated: ${routes.length} route(s)`);}main();

package/dist/server/expressServer.js

@@ -1,4 +1,5 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;var _path=_interopRequireDefault(require("path"));var _express=_interopRequireDefault(require("express"));var _bodyParser=_interopRequireDefault(require("body-parser"));var _compression=_interopRequireDefault(require("compression"));var _cookieParser=_interopRequireDefault(require("cookie-parser"));var _expressStaticGzip=_interopRequireDefault(require("express-static-gzip"));var _renderer=_interopRequireDefault(require("@catalyst/server/renderer"));var _server=require("@catalyst/template/server/server.js");var _validator=require("@catalyst/server/utils/validator");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}const env=process.env.NODE_ENV||"development";const app=(0,_express.default)();app.use(_bodyParser.default.json({limit:"100kb"}));// Handles "bytestream array" content types sent as raw application/* bodies
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;var _path=_interopRequireDefault(require("path"));var _fs=_interopRequireDefault(require("fs"));var _express=_interopRequireDefault(require("express"));var _bodyParser=_interopRequireDefault(require("body-parser"));var _compression=_interopRequireDefault(require("compression"));var _cookieParser=_interopRequireDefault(require("cookie-parser"));var _expressStaticGzip=_interopRequireDefault(require("express-static-gzip"));var _renderer=_interopRequireDefault(require("@catalyst/server/renderer"));var _server=require("@catalyst/template/server/server.js");var _validator=require("@catalyst/server/utils/validator");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}const env=process.env.NODE_ENV||"development";const app=(0,_express.default)();const sendBuiltPublicFile=(res,fileName,headers={})=>{const publicFilePath=_path.default.join(process.env.src_path,`./${process.env.BUILD_OUTPUT_PATH}/public`,fileName);if(!_fs.default.existsSync(publicFilePath)){res.status(404).end();return;}res.set(headers);res.sendFile(publicFilePath);};app.get("/catalyst-sw.js",(_req,res)=>{sendBuiltPublicFile(res,"catalyst-sw.js",{"Content-Type":"application/javascript; charset=utf-8","Cache-Control":"no-cache, no-store, must-revalidate","Service-Worker-Allowed":"/"});});app.get("/catalyst-offline-manifest.json",(_req,res)=>{sendBuiltPublicFile(res,"catalyst-offline-manifest.json",{"Content-Type":"application/json; charset=utf-8","Cache-Control":"no-cache, no-store, must-revalidate"});});app.get("/offline.html",(_req,res)=>{sendBuiltPublicFile(res,"offline.html",{"Content-Type":"text/html; charset=utf-8","Cache-Control":"no-cache, no-store, must-revalidate"});});// This middleware is being used to extract the body of the request
+app.use(_bodyParser.default.json({limit:"100kb"}));// Handles "bytestream array" content types sent as raw application/* bodies
 app.use(_bodyParser.default.raw({type:"application/*",limit:"100kb"}));app.use((0,_cookieParser.default)());if((0,_validator.validateMiddleware)(_server.addMiddlewares))(0,_server.addMiddlewares)(app);app.use((0,_compression.default)());// Serve pre-compressed static assets (brotli preferred) from the build output directory
 if(env==="production"){app.use(process.env.PUBLIC_STATIC_ASSET_PATH,(0,_expressStaticGzip.default)(_path.default.join(process.env.src_path,`./${process.env.BUILD_OUTPUT_PATH}/public`),{enableBrotli:true,orderPreference:["br","gzip","deflate"]}));}else{app.use(process.env.PUBLIC_STATIC_ASSET_PATH,_express.default.static(_path.default.join(process.env.src_path,`./${process.env.BUILD_OUTPUT_PATH}/public`)));}// Catch-all: every non-asset request is handled by the SSR renderer
 app.use("*",_renderer.default);var _default=exports.default=app;

package/dist/server/renderer/document/Body.js

@@ -5,7 +5,7 @@
  * @param {object} firstFoldCss - style elements extracted for initial page load
  * @param {object} fetcherData - contains data from executing serverFetcher function
  * @param {object} children - contains any child elements defined within the component
- */const DEFAULT_SAFE_AREA={top:0,right:0,bottom:0,left:0};function Body({jsx="",initialState={},fetcherData={},children,safeArea=DEFAULT_SAFE_AREA}){return/*#__PURE__*/(0,_jsxRuntime.jsxs)("body",{children:[/*#__PURE__*/(0,_jsxRuntime.jsx)("script",{/* eslint-disable-next-line risxss/catch-potential-xss-react */dangerouslySetInnerHTML:{__html:`window.__SAFE_AREA_INITIAL__ = ${JSON.stringify(safeArea)}`}}),jsx,/*#__PURE__*/(0,_jsxRuntime.jsx)("script",{/* eslint-disable */dangerouslySetInnerHTML:{__html:`
+ */const DEFAULT_SAFE_AREA={top:0,right:0,bottom:0,left:0};function Body({jsx="",initialState={},fetcherData={},children,safeArea=DEFAULT_SAFE_AREA,nativeWebView=false}){return/*#__PURE__*/(0,_jsxRuntime.jsxs)("body",{children:[/*#__PURE__*/(0,_jsxRuntime.jsx)("script",{/* eslint-disable-next-line risxss/catch-potential-xss-react */dangerouslySetInnerHTML:{__html:`window.__SAFE_AREA_INITIAL__ = ${JSON.stringify(safeArea)}; window.__CATALYST_NATIVE_WEBVIEW__ = ${nativeWebView?"true":"false"}`}}),jsx,/*#__PURE__*/(0,_jsxRuntime.jsx)("script",{/* eslint-disable */dangerouslySetInnerHTML:{__html:`
                     window.__INITIAL_STATE__ = ${JSON.stringify(initialState)}
                     window.__ROUTER_INITIAL_DATA__ = ${JSON.stringify(fetcherData)}
             `}}),children]});}