@rdlabo/ionic-theme-ios27 0.1.0 → 0.2.1-beta.pr185.sha0793981f6cf4

package/ios/Sources/IonicNativeUIShellPlugin/IonicNativeUIShellPlugin.swift

@@ -8,6 +8,7 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
     public let jsName = "IonicNativeUIShell"
     public let pluginMethods: [CAPPluginMethod] = [
         CAPPluginMethod(name: "configure", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getWebViewMetrics", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "update", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "clear", returnType: CAPPluginReturnPromise)
     ]
@@ -19,6 +20,8 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
     private var revision = 0
     private var sequence = 0
     private var keyboardVisible = false
+    private var pendingTabSelections: [String: ShellTabBar.PendingSelection] = [:]
+    private var pendingTabExpiryWorks: [String: DispatchWorkItem] = [:]
     private var restoreTopEdge: (() -> Void)?
     private var observers: [NSObjectProtocol] = []
 
@@ -38,13 +41,21 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
                     }
                 }
                 if !keyboard { self.host?.isHidden = true }
+                var searchOwnsKeyboard = false
                 if #available(iOS 26.0, *) {
                     self.searchControllers.values.forEach {
                         guard let controller = $0 as? ShellSearchController else { return }
+                        if controller.ownsKeyboardChrome { searchOwnsKeyboard = true }
                         if !keyboard { controller.surface.isHidden = true }
                     }
                 }
-                if keyboard { self.bridge?.triggerWindowJSEvent(eventName: "nativeUIShellRefresh") }
+                if keyboard {
+                    if !searchOwnsKeyboard {
+                        self.bridge?.triggerWindowJSEvent(eventName: "nativeUIShellRefresh")
+                    }
+                } else if name == UIDevice.orientationDidChangeNotification {
+                    self.notifyWebViewMetricsChange()
+                }
             })
         }
         for name in [UIApplication.didBecomeActiveNotification, UIResponder.keyboardDidHideNotification,
@@ -52,6 +63,7 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
             observers.append(NotificationCenter.default.addObserver(forName: name, object: nil, queue: .main) { [weak self] _ in
                 if name == UIResponder.keyboardDidHideNotification { self?.keyboardVisible = false }
                 self?.bridge?.triggerWindowJSEvent(eventName: "nativeUIShellRefresh", data: name == UIApplication.didBecomeActiveNotification ? "{\"retireSearch\":true}" : "{}")
+                if name == UIApplication.didBecomeActiveNotification { self?.notifyWebViewMetricsChange() }
             })
         }
     }
@@ -60,6 +72,31 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
         observers.forEach(NotificationCenter.default.removeObserver)
     }
 
+    private func webViewMetrics() -> JSObject? {
+        guard #available(iOS 26.0, *), let webView = bridge?.webView else { return nil }
+        webView.layoutIfNeeded()
+        return ["radius": Double(webView.effectiveRadius(corner: .topLeft))]
+    }
+
+    private func notifyWebViewMetricsChange() {
+        guard let metrics = webViewMetrics() else { return }
+        notifyListeners("webViewMetricsChange", data: metrics)
+    }
+
+    @objc func getWebViewMetrics(_ call: CAPPluginCall) {
+        DispatchQueue.main.async { [weak self] in
+            guard #available(iOS 26.0, *) else {
+                call.resolve(["radius": 0])
+                return
+            }
+            guard let metrics = self?.webViewMetrics() else {
+                call.reject("WebView unavailable")
+                return
+            }
+            call.resolve(metrics)
+        }
+    }
+
     @objc func configure(_ call: CAPPluginCall) {
         DispatchQueue.main.async { [weak self] in
             // A new JS context starts revision numbering again (live reload / navigation).
@@ -101,6 +138,8 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
         }
         if let control = controls.removeValue(forKey: id) { ShellCrossfade.retire(control, duration: duration) }
         fingerprints.removeValue(forKey: id)
+        pendingTabSelections.removeValue(forKey: id)
+        pendingTabExpiryWorks.removeValue(forKey: id)?.cancel()
     }
 
     private func removeControls(duration: TimeInterval = 0) {
@@ -108,6 +147,36 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
         host?.removeFromSuperview()
         host = nil
         rendering.clear()
+        pendingTabSelections.removeAll()
+        pendingTabExpiryWorks.values.forEach { $0.cancel() }
+        pendingTabExpiryWorks.removeAll()
+    }
+
+    private func syncTabBar(_ tabBar: UITabBar, id: String, node: ShellControl) {
+        var pending = pendingTabSelections[id]
+        ShellTabBar.update(tabBar, node: node, rendering: rendering, pendingSelection: &pending)
+        if let pending {
+            pendingTabSelections[id] = pending
+        } else {
+            pendingTabSelections.removeValue(forKey: id)
+            pendingTabExpiryWorks.removeValue(forKey: id)?.cancel()
+        }
+    }
+
+    private func schedulePendingTabExpiry(_ id: String, until: CFAbsoluteTime) {
+        pendingTabExpiryWorks[id]?.cancel()
+        let delay = max(0, until - CFAbsoluteTimeGetCurrent()) + 0.02
+        let work = DispatchWorkItem { [weak self] in
+            guard let self else { return }
+            self.pendingTabExpiryWorks.removeValue(forKey: id)
+            guard let pending = self.pendingTabSelections[id],
+                  CFAbsoluteTimeGetCurrent() >= pending.until,
+                  let tabBar = self.controls[id] as? UITabBar,
+                  let node = self.fingerprints[id] else { return }
+            self.syncTabBar(tabBar, id: id, node: node)
+        }
+        pendingTabExpiryWorks[id] = work
+        DispatchQueue.main.asyncAfter(deadline: .now() + delay, execute: work)
     }
 
     @objc func update(_ call: CAPPluginCall) {
@@ -145,7 +214,7 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
             }
             var rejectedControls: [String] = []
             var fabs: [(ShellFab, ShellControl)] = []
-            var searches: [(ShellSearchController, ShellControl, CGRect, CGRect)] = []
+            var searches: [(ShellSearchController, ShellControl, CGRect, CGRect, UIView?, Bool)] = []
             var rejectedSearches: [String] = []
             UIView.performWithoutAnimation {
                 if host.superview !== parent { parent.addSubview(host) }
@@ -173,9 +242,11 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
                     if let search = node.search {
                         guard let owner = self.bridge?.viewController else { rejectedSearches.append(id); continue }
                         let controller: ShellSearchController
-                        if let existing = self.searchControllers[id] as? ShellSearchController { controller = existing }
+                        let previousCover = self.controls[id]
+                        let replacing = self.searchControllers[id] as? ShellSearchController
+                        if let existing = replacing { controller = existing }
                         else {
-                            self.removeControl(id)
+                            // Keep the ordinary UITabBar cover until the search controller applies.
                             controller = ShellSearchController()
                             controller.activate = { [weak self] id in self?.activate(id) }
                             controller.changed = { [weak self] id, phase, value, composing, valueVersion in
@@ -194,7 +265,7 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
                             y: webView.bounds.minY + local.minY * scale, width: local.width * scale, height: local.height * scale), to: owner.view)
                         let triggerFrame = webView.convert(CGRect(x: webView.bounds.minX + trigger.minX * scale,
                             y: webView.bounds.minY + trigger.minY * scale, width: trigger.width * scale, height: trigger.height * scale), to: owner.view)
-                        searches.append((controller, node, searchBarFrame, triggerFrame))
+                        searches.append((controller, node, searchBarFrame, triggerFrame, previousCover, replacing == nil))
                         continue
                     } else if self.searchControllers[id] != nil {
                         self.removeControl(id)
@@ -208,7 +279,7 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
                         } else if let segment = self.controls[id] as? ShellSegment, node.kind == ShellSegment.kind {
                             segment.update(node, scale: scale, rendering: self.rendering)
                         } else if let tabBar = self.controls[id] as? UITabBar, node.kind == ShellTabBar.kind {
-                            ShellTabBar.update(tabBar, node: node, rendering: self.rendering)
+                            self.syncTabBar(tabBar, id: id, node: node)
                         } else {
                             guard let control = ShellComponents.make(node, scale: scale, rendering: self.rendering, tabDelegate: self,
                                 activate: { [weak self] id in self?.activate(id) }) else { reject(); continue }
@@ -217,6 +288,9 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
                             host.addSubview(control)
                         }
                         self.fingerprints[id] = node
+                    } else if let tabBar = self.controls[id] as? UITabBar, self.pendingTabSelections[id] != nil {
+                        // Resolve an in-flight native tap even when other fingerprint fields are unchanged.
+                        self.syncTabBar(tabBar, id: id, node: node)
                     }
                     guard let control = self.controls[id] else { reject(); continue }
                     if let tabBar = control as? UITabBar {
@@ -234,13 +308,29 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
             for (fab, node) in fabs {
                 fab.apply(node, scale: scale, rendering: self.rendering, activate: { [weak self] id in self?.activate(id) })
             }
-            for (controller, node, frame, triggerFrame) in searches {
+            for (controller, node, frame, triggerFrame, previousCover, created) in searches {
+                let id = node.id
                 let webFrame = webView.convert(webView.bounds, to: controller.surface.superview)
                 if !controller.apply(node, webFrame: webFrame, barFrame: frame, triggerFrame: triggerFrame, rendering: self.rendering) {
-                    let id = node.id
-                    self.removeControl(id)
+                    if created {
+                        self.searchControllers.removeValue(forKey: id)
+                        controller.detach()
+                        if let previousCover, previousCover.superview != nil {
+                            self.controls[id] = previousCover
+                        } else {
+                            self.controls.removeValue(forKey: id)?.removeFromSuperview()
+                            self.fingerprints.removeValue(forKey: id)
+                            self.pendingTabSelections[id] = nil
+                            self.pendingTabExpiryWorks.removeValue(forKey: id)?.cancel()
+                        }
+                    } else {
+                        self.removeControl(id)
+                    }
                     rejectedSearches.append(id)
                 } else {
+                    if created, let previousCover, previousCover !== controller.surface {
+                        previousCover.removeFromSuperview()
+                    }
                     controller.surface.isHidden = self.keyboardVisible && !controller.ownsKeyboard
                 }
             }
@@ -256,8 +346,13 @@ public class IonicNativeUIShellPlugin: CAPPlugin, CAPBridgedPlugin, UITabBarDele
     }
 
     public func tabBar(_ tabBar: UITabBar, didSelect item: UITabBarItem) {
-        guard item.isEnabled, let id = item.accessibilityIdentifier else { return }
-        activate(id)
+        guard item.isEnabled, let itemId = item.accessibilityIdentifier else { return }
+        if let controlId = controls.first(where: { $0.value === tabBar })?.key {
+            let pending = ShellTabBar.PendingSelection.start(itemId)
+            pendingTabSelections[controlId] = pending
+            schedulePendingTabExpiry(controlId, until: pending.until)
+        }
+        activate(itemId)
     }
 
     private func activate(_ id: String) {

package/ios/Tests/IonicNativeUIShellPluginTests/ShellSnapshotTests.swift

@@ -237,8 +237,8 @@ final class ShellSnapshotTests: XCTestCase {
             let node = try XCTUnwrap(decode([control(["kind": "ion-tab-bar", "search": search,
                 "items": [item(["id": "first", "selected": true]), item(["id": "second"]) ]])]).controls.first)
             XCTAssertTrue(controller.apply(node, webFrame: CGRect(x: 0, y: 0, width: 390, height: 844),
-                barFrame: CGRect(x: 18, y: 730, width: 280, height: 62),
-                triggerFrame: CGRect(x: 320, y: 730, width: 56, height: 56), rendering: rendering))
+            barFrame: CGRect(x: 18, y: 730, width: 280, height: 62),
+            triggerFrame: CGRect(x: 320, y: 730, width: 56, height: 56), rendering: rendering))
         }
         try apply("old-search", value: "initial")
         let navigation = try XCTUnwrap(controller.tabs.last?.viewController as? UINavigationController)
@@ -292,4 +292,260 @@ final class ShellSnapshotTests: XCTestCase {
         }
     }
 
+    @MainActor
+    func testTabTitleLayoutWarmupRestoresSelection() throws {
+        let image = UIGraphicsImageRenderer(size: CGSize(width: 24, height: 24)).image { context in
+            UIColor.black.setFill()
+            context.fill(CGRect(x: 0, y: 0, width: 24, height: 24))
+        }.pngData()!.base64EncodedString()
+        let items = [
+            item(["id": "first", "label": "Index", "selected": true, "icon": image, "iconWidth": 24.0, "iconHeight": 24.0]),
+            item(["id": "second", "label": "Docs", "icon": image, "iconWidth": 24.0, "iconHeight": 24.0]),
+            item(["id": "third", "label": "Library", "icon": image, "iconWidth": 24.0, "iconHeight": 24.0]),
+        ]
+        let node = try XCTUnwrap(decode([control(["kind": "ion-tab-bar", "width": 280.0, "height": 62.0, "items": items])]).controls.first)
+        let bar = UITabBar()
+        ShellTabBar.update(bar, node: node, rendering: ShellRendering())
+        XCTAssertTrue(ShellTabBar.fit(bar, node: node, bounds: CGRect(x: 20, y: 700, width: 280, height: 62)))
+        XCTAssertEqual(bar.selectedItem?.accessibilityIdentifier, "first")
+        // A second fit without content changes must not leave a pending warmup.
+        XCTAssertTrue(ShellTabBar.fit(bar, node: node, bounds: CGRect(x: 20, y: 700, width: 280, height: 62)))
+        XCTAssertEqual(bar.selectedItem?.accessibilityIdentifier, "first")
+    }
+
+    @MainActor
+    func testTabPendingSelectionIgnoresStaleDomEcho() throws {
+        let first = item(["id": "first", "selected": true])
+        let second = item(["id": "second"])
+        let bar = UITabBar()
+        let initial = try XCTUnwrap(decode([control(["kind": "ion-tab-bar", "items": [first, second]])]).controls.first)
+        ShellTabBar.update(bar, node: initial, rendering: ShellRendering())
+        XCTAssertEqual(bar.selectedItem?.accessibilityIdentifier, "first")
+
+        var pending: ShellTabBar.PendingSelection? = .start("second")
+        // Stale Web echo still reports the previous tab.
+        ShellTabBar.update(bar, node: initial, rendering: ShellRendering(), pendingSelection: &pending)
+        XCTAssertEqual(pending?.id, "second")
+        XCTAssertEqual(bar.selectedItem?.accessibilityIdentifier, "second")
+
+        let echoed = try XCTUnwrap(decode([control(["kind": "ion-tab-bar", "items": [
+            item(["id": "first"]), item(["id": "second", "selected": true]),
+        ]])]).controls.first)
+        ShellTabBar.update(bar, node: echoed, rendering: ShellRendering(), pendingSelection: &pending)
+        XCTAssertNil(pending)
+        XCTAssertEqual(bar.selectedItem?.accessibilityIdentifier, "second")
+    }
+
+    @MainActor
+    func testTabPendingSelectionFallsBackWhenDomRejects() throws {
+        let first = item(["id": "first", "selected": true])
+        let second = item(["id": "second"])
+        let bar = UITabBar()
+        let node = try XCTUnwrap(decode([control(["kind": "ion-tab-bar", "items": [first, second]])]).controls.first)
+        ShellTabBar.update(bar, node: node, rendering: ShellRendering())
+        bar.selectedItem = bar.items?.first { $0.accessibilityIdentifier == "second" }
+
+        var pending: ShellTabBar.PendingSelection? = ShellTabBar.PendingSelection(id: "second", until: CFAbsoluteTimeGetCurrent() - 1)
+        ShellTabBar.update(bar, node: node, rendering: ShellRendering(), pendingSelection: &pending)
+        XCTAssertNil(pending)
+        XCTAssertEqual(bar.selectedItem?.accessibilityIdentifier, "first")
+
+        pending = .start("second")
+        let disabled = try XCTUnwrap(decode([control(["kind": "ion-tab-bar", "items": [
+            item(["id": "first", "selected": true]), item(["id": "second", "disabled": true]),
+        ]])]).controls.first)
+        bar.selectedItem = bar.items?.first { $0.accessibilityIdentifier == "second" }
+        ShellTabBar.update(bar, node: disabled, rendering: ShellRendering(), pendingSelection: &pending)
+        XCTAssertNil(pending)
+        XCTAssertEqual(bar.selectedItem?.accessibilityIdentifier, "first")
+    }
+
+    @MainActor
+    func testSearchOptimisticTabSelectionIgnoresStaleDomEcho() throws {
+        guard #available(iOS 26.0, *) else { throw XCTSkip("Requires UISearchTab") }
+        let controller = ShellSearchController()
+        let rendering = ShellRendering()
+        let resting = CGRect(x: 0, y: 0, width: 390, height: 844)
+        let bar = CGRect(x: 18, y: 730, width: 280, height: 62)
+        let trigger = CGRect(x: 320, y: 730, width: 56, height: 56)
+        func node(selected: String) throws -> ShellControl {
+            let search: JSObject = ["id": "search", "field": item(), "trigger": item(["id": "trigger"]),
+                "closeId": "close", "active": false, "available": true, "focused": false,
+                "value": "", "placeholder": "Search", "disabled": false, "editSequence": 0, "valueVersion": 0]
+            return try XCTUnwrap(decode([control(["kind": "ion-tab-bar", "search": search,
+                "items": [item(["id": "first", "selected": selected == "first"]),
+                          item(["id": "second", "selected": selected == "second"])]])]).controls.first)
+        }
+        _ = controller.apply(try node(selected: "first"), webFrame: resting, barFrame: bar, triggerFrame: trigger, rendering: rendering)
+        let second = try XCTUnwrap(controller.tabs.first { $0.identifier == "second" })
+        var activated: [String] = []
+        controller.activate = { activated.append($0) }
+        XCTAssertTrue(controller.tabBarController(controller, shouldSelectTab: second))
+        XCTAssertEqual(activated, ["second"])
+        XCTAssertEqual(controller.selectedTab?.identifier, "second")
+        // Stale Web echo still reports the previous tab.
+        _ = controller.apply(try node(selected: "first"), webFrame: resting, barFrame: bar, triggerFrame: trigger, rendering: rendering)
+        XCTAssertEqual(controller.selectedTab?.identifier, "second")
+        // Web catches up — clear pending without bouncing selection.
+        _ = controller.apply(try node(selected: "second"), webFrame: resting, barFrame: bar, triggerFrame: trigger, rendering: rendering)
+        XCTAssertEqual(controller.selectedTab?.identifier, "second")
+    }
+
+    @MainActor
+    func testSearchLocksProjectionWhileActiveAndKeepsApplicationValue() throws {
+        guard #available(iOS 26.0, *) else { throw XCTSkip("Requires UISearchTab") }
+        let controller = ShellSearchController()
+        let rendering = ShellRendering()
+        let resting = CGRect(x: 0, y: 0, width: 390, height: 844)
+        let shrunk = CGRect(x: 0, y: 0, width: 390, height: 500)
+        func node(active: Bool, focused: Bool, value: String = "", valueVersion: Int = 0) throws -> ShellControl {
+            let search: JSObject = ["id": "search", "field": item(), "trigger": item(["id": "trigger"]),
+                "closeId": "close", "active": active, "available": true, "focused": focused,
+                "value": value, "placeholder": "Search", "disabled": false, "editSequence": 0, "valueVersion": valueVersion]
+            return try XCTUnwrap(decode([control(["kind": "ion-tab-bar", "search": search,
+                "items": [item(["id": "first", "selected": true]), item(["id": "second"])]])]).controls.first)
+        }
+        // Resting layout may reject without a full window hierarchy; surface is still assigned.
+        _ = controller.apply(try node(active: false, focused: false), webFrame: resting,
+            barFrame: CGRect(x: 18, y: 730, width: 280, height: 62),
+            triggerFrame: CGRect(x: 320, y: 730, width: 56, height: 56), rendering: rendering)
+        controller.surface.frame = resting
+        // Active (even before focus) freezes Web layout for the whole search session.
+        XCTAssertTrue(controller.apply(try node(active: true, focused: false), webFrame: resting,
+            barFrame: CGRect(x: 18, y: 730, width: 280, height: 62),
+            triggerFrame: CGRect(x: 320, y: 730, width: 56, height: 56), rendering: rendering))
+        XCTAssertEqual(controller.surface.frame, resting)
+        XCTAssertTrue(controller.apply(try node(active: true, focused: false), webFrame: shrunk,
+            barFrame: CGRect(x: 18, y: 730, width: 280, height: 62),
+            triggerFrame: CGRect(x: 320, y: 730, width: 56, height: 56), rendering: rendering))
+        XCTAssertEqual(controller.surface.frame, resting)
+        // Application realtime value updates still cross the lock.
+        XCTAssertTrue(controller.apply(try node(active: true, focused: true, value: "external", valueVersion: 2), webFrame: shrunk,
+            barFrame: CGRect(x: 18, y: 730, width: 280, height: 62),
+            triggerFrame: CGRect(x: 320, y: 730, width: 56, height: 56), rendering: rendering))
+        XCTAssertEqual(controller.surface.frame, resting)
+        let navigation = try XCTUnwrap(controller.tabs.last?.viewController as? UINavigationController)
+        let searchBar = try XCTUnwrap(navigation.topViewController?.navigationItem.searchController?.searchBar)
+        XCTAssertEqual(searchBar.text, "external")
+        // Blur request returns to presented (active, not focused) without unlocking projection.
+        XCTAssertTrue(controller.apply(try node(active: true, focused: false, value: "external", valueVersion: 2), webFrame: shrunk,
+            barFrame: CGRect(x: 18, y: 730, width: 280, height: 62),
+            triggerFrame: CGRect(x: 320, y: 730, width: 56, height: 56), rendering: rendering))
+        XCTAssertEqual(controller.surface.frame, resting)
+        XCTAssertFalse(searchBar.searchTextField.isFirstResponder)
+        let tabsBeforeLeave = controller.tabs.map(\.identifier)
+        // Leave re-fits; without a window hierarchy fit may reject while still restoring selection.
+        _ = controller.apply(try node(active: false, focused: false, value: "external", valueVersion: 2), webFrame: resting,
+            barFrame: CGRect(x: 18, y: 730, width: 280, height: 62),
+            triggerFrame: CGRect(x: 320, y: 730, width: 56, height: 56), rendering: rendering)
+        XCTAssertEqual(controller.surface.frame, resting)
+        // Leave must reassign tabs even when identifiers match (UISearchTab morph cleanup).
+        XCTAssertEqual(controller.tabs.map(\.identifier), tabsBeforeLeave)
+        XCTAssertEqual(controller.tabs.count, 3) // first, second, search
+        XCTAssertEqual(controller.selectedTab?.identifier, "first")
+        // Switching ordinary tabs after leave must keep resting chrome (no deferred morph expand).
+        func nodeSelecting(_ id: String) throws -> ShellControl {
+            let search: JSObject = ["id": "search", "field": item(), "trigger": item(["id": "trigger"]),
+                "closeId": "close", "active": false, "available": true, "focused": false,
+                "value": "external", "placeholder": "Search", "disabled": false, "editSequence": 0, "valueVersion": 2]
+            return try XCTUnwrap(decode([control(["kind": "ion-tab-bar", "search": search,
+                "items": [item(["id": "first", "selected": id == "first"]),
+                          item(["id": "second", "selected": id == "second"])]])]).controls.first)
+        }
+        let tabsAfterLeave = controller.tabs.map(\.identifier)
+        _ = controller.apply(try nodeSelecting("second"), webFrame: resting,
+            barFrame: CGRect(x: 18, y: 730, width: 280, height: 62),
+            triggerFrame: CGRect(x: 320, y: 730, width: 56, height: 56), rendering: rendering)
+        XCTAssertEqual(controller.selectedTab?.identifier, "second")
+        XCTAssertEqual(controller.tabs.map(\.identifier), tabsAfterLeave)
+        _ = controller.apply(try nodeSelecting("first"), webFrame: resting,
+            barFrame: CGRect(x: 18, y: 730, width: 280, height: 62),
+            triggerFrame: CGRect(x: 320, y: 730, width: 56, height: 56), rendering: rendering)
+        XCTAssertEqual(controller.selectedTab?.identifier, "first")
+        XCTAssertEqual(controller.tabs.map(\.identifier), tabsAfterLeave)
+    }
+
+    @MainActor
+    func testSearchRelocksProjectionWidthAfterRotation() throws {
+        guard #available(iOS 26.0, *) else { throw XCTSkip("Requires UISearchTab") }
+        let controller = ShellSearchController()
+        let rendering = ShellRendering()
+        let portrait = CGRect(x: 0, y: 0, width: 390, height: 844)
+        let landscape = CGRect(x: 0, y: 0, width: 844, height: 390)
+        let keyboardShrunk = CGRect(x: 0, y: 0, width: 844, height: 200)
+        func node(active: Bool) throws -> ShellControl {
+            let search: JSObject = ["id": "search", "field": item(), "trigger": item(["id": "trigger"]),
+                "closeId": "close", "active": active, "available": true, "focused": false,
+                "value": "", "placeholder": "Search", "disabled": false, "editSequence": 0, "valueVersion": 0]
+            return try XCTUnwrap(decode([control(["kind": "ion-tab-bar", "search": search,
+                "items": [item(["id": "first", "selected": true]), item(["id": "second"])]])]).controls.first)
+        }
+        let bar = CGRect(x: 18, y: 730, width: 280, height: 62)
+        let trigger = CGRect(x: 320, y: 730, width: 56, height: 56)
+        _ = controller.apply(try node(active: false), webFrame: portrait, barFrame: bar, triggerFrame: trigger, rendering: rendering)
+        controller.surface.frame = portrait
+        XCTAssertTrue(controller.apply(try node(active: true), webFrame: portrait, barFrame: bar, triggerFrame: trigger, rendering: rendering))
+        XCTAssertEqual(controller.surface.frame, portrait)
+        // Rotation must adopt the new width instead of keeping the portrait lock.
+        XCTAssertTrue(controller.apply(try node(active: true), webFrame: landscape, barFrame: bar, triggerFrame: trigger, rendering: rendering))
+        XCTAssertEqual(controller.surface.frame, landscape)
+        // Keyboard shrink at the same width must still be ignored.
+        XCTAssertTrue(controller.apply(try node(active: true), webFrame: keyboardShrunk, barFrame: bar, triggerFrame: trigger, rendering: rendering))
+        XCTAssertEqual(controller.surface.frame, landscape)
+    }
+
+    @MainActor
+    func testSearchPendingSelectionExpiresWithoutLaterApply() throws {
+        guard #available(iOS 26.0, *) else { throw XCTSkip("Requires UISearchTab") }
+        let controller = ShellSearchController()
+        let rendering = ShellRendering()
+        let resting = CGRect(x: 0, y: 0, width: 390, height: 844)
+        let bar = CGRect(x: 18, y: 730, width: 280, height: 62)
+        let trigger = CGRect(x: 320, y: 730, width: 56, height: 56)
+        let search: JSObject = ["id": "search", "field": item(), "trigger": item(["id": "trigger"]),
+            "closeId": "close", "active": false, "available": true, "focused": false,
+            "value": "", "placeholder": "Search", "disabled": false, "editSequence": 0, "valueVersion": 0]
+        let node = try XCTUnwrap(decode([control(["kind": "ion-tab-bar", "search": search,
+            "items": [item(["id": "first", "selected": true]), item(["id": "second"])]])]).controls.first)
+        _ = controller.apply(node, webFrame: resting, barFrame: bar, triggerFrame: trigger, rendering: rendering)
+        let second = try XCTUnwrap(controller.tabs.first { $0.identifier == "second" })
+        XCTAssertTrue(controller.tabBarController(controller, shouldSelectTab: second))
+        XCTAssertEqual(controller.selectedTab?.identifier, "second")
+        let expectation = expectation(description: "pending selection expires back to DOM")
+        DispatchQueue.main.asyncAfter(deadline: .now() + 1.15) {
+            XCTAssertEqual(controller.selectedTab?.identifier, "first")
+            expectation.fulfill()
+        }
+        wait(for: [expectation], timeout: 2)
+    }
+
+    @MainActor
+    func testSearchEmitsInputAfterRestingToActive() throws {
+        guard #available(iOS 26.0, *) else { throw XCTSkip("Requires UISearchTab") }
+        let controller = ShellSearchController()
+        let rendering = ShellRendering()
+        let resting = CGRect(x: 0, y: 0, width: 390, height: 844)
+        let bar = CGRect(x: 18, y: 730, width: 280, height: 62)
+        let trigger = CGRect(x: 320, y: 730, width: 56, height: 56)
+        func node(active: Bool) throws -> ShellControl {
+            let search: JSObject = ["id": "search", "field": item(), "trigger": item(["id": "trigger"]),
+                "closeId": "close", "active": active, "available": true, "focused": active,
+                "value": "", "placeholder": "Search", "disabled": false, "editSequence": 0, "valueVersion": 0]
+            return try XCTUnwrap(decode([control(["kind": "ion-tab-bar", "search": search,
+                "items": [item(["id": "first", "selected": true]), item(["id": "second"])]])]).controls.first)
+        }
+        // Resting must not permanently close the editing bridge.
+        _ = controller.apply(try node(active: false), webFrame: resting, barFrame: bar, triggerFrame: trigger, rendering: rendering)
+        var phases: [String] = []
+        controller.changed = { _, phase, _, _, _ in
+            phases.append(phase.rawValue)
+            return phases.count
+        }
+        XCTAssertTrue(controller.apply(try node(active: true), webFrame: resting, barFrame: bar, triggerFrame: trigger, rendering: rendering))
+        let navigation = try XCTUnwrap(controller.tabs.last?.viewController as? UINavigationController)
+        let searchBar = try XCTUnwrap(navigation.topViewController?.navigationItem.searchController?.searchBar)
+        controller.searchBar(searchBar, textDidChange: "query")
+        XCTAssertEqual(phases, ["input"])
+    }
+
 }

package/node_modules/@rdlabo/ionic-theme-utils/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Masahiko Sakakibara
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/node_modules/@rdlabo/ionic-theme-utils/README.md

@@ -0,0 +1,28 @@
+# @rdlabo/ionic-theme-utils
+
+Shared, theme-neutral utilities for Rdlabo Ionic themes.
+
+TypeScript and Sass sources are exported directly. Consumers are expected to
+compile them as part of an Angular/Ionic application build.
+
+```typescript
+import { createIosTransitionAnimation, getPopoverPosition } from '@rdlabo/ionic-theme-utils';
+```
+
+```scss
+@use 'pkg:@rdlabo/ionic-theme-utils/styles/structured-list';
+```
+
+The package currently contains shared iOS transition construction, popover
+positioning, searchable tab-bar utilities, and structured-list Sass mixins.
+
+## Development
+
+```shell
+npm install
+npm run build
+npm run lint
+```
+
+Use `npm link` while developing this package together with a theme repository.
+Theme repositories should use a tagged Git dependency for reproducible installs.

package/node_modules/@rdlabo/ionic-theme-utils/dist/dom.d.ts

@@ -0,0 +1,3 @@
+export declare const getElementRoot: (el: HTMLElement, fallback?: HTMLElement) => HTMLElement | ShadowRoot;
+export declare const raf: (h: FrameRequestCallback) => any;
+//# sourceMappingURL=dom.d.ts.map

package/node_modules/@rdlabo/ionic-theme-utils/dist/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,GAAI,IAAI,WAAW,EAAE,WAAU,WAAgB,6BAEzE,CAAC;AAEF,eAAO,MAAM,GAAG,GAAI,GAAG,oBAAoB,QAQ1C,CAAC"}

package/node_modules/@rdlabo/ionic-theme-utils/dist/dom.js

@@ -0,0 +1,13 @@
+export const getElementRoot = (el, fallback = el) => {
+    return el.shadowRoot || fallback;
+};
+export const raf = (h) => {
+    if (typeof __zone_symbol__requestAnimationFrame === 'function') {
+        return __zone_symbol__requestAnimationFrame(h);
+    }
+    if (typeof requestAnimationFrame === 'function') {
+        return requestAnimationFrame(h);
+    }
+    return setTimeout(h);
+};
+//# sourceMappingURL=dom.js.map

package/node_modules/@rdlabo/ionic-theme-utils/dist/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAe,EAAE,WAAwB,EAAE,EAAE,EAAE;IAC5E,OAAO,EAAE,CAAC,UAAU,IAAI,QAAQ,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAuB,EAAE,EAAE;IAC7C,IAAI,OAAO,oCAAoC,KAAK,UAAU,EAAE,CAAC;QAC/D,OAAO,oCAAoC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,OAAO,qBAAqB,KAAK,UAAU,EAAE,CAAC;QAChD,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC,CAAC"}

package/node_modules/@rdlabo/ionic-theme-utils/dist/focus-controller.d.ts

@@ -0,0 +1,6 @@
+export interface FocusController {
+    saveViewFocus(referenceEl?: HTMLElement): void;
+    setViewFocus(referenceEl: HTMLElement): void;
+}
+export declare const createFocusController: () => FocusController;
+//# sourceMappingURL=focus-controller.d.ts.map

package/node_modules/@rdlabo/ionic-theme-utils/dist/focus-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-controller.d.ts","sourceRoot":"","sources":["../src/focus-controller.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/C,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;CAC9C;AAED,eAAO,MAAM,qBAAqB,QAAO,eAuBvC,CAAC"}

package/node_modules/@rdlabo/ionic-theme-utils/dist/focus-controller.js

@@ -0,0 +1,37 @@
+import { config } from './theme';
+const LAST_FOCUS = 'ion-last-focus';
+const moveFocus = (element) => {
+    element.tabIndex = -1;
+    element.focus();
+};
+const isVisible = (element) => element.offsetParent !== null;
+export const createFocusController = () => ({
+    saveViewFocus: (referenceEl) => {
+        if (!config.get('focusManagerPriority', false))
+            return;
+        const activeEl = document.activeElement;
+        if (activeEl && referenceEl?.contains(activeEl))
+            activeEl.setAttribute(LAST_FOCUS, 'true');
+    },
+    setViewFocus: (referenceEl) => {
+        const priorities = config.get('focusManagerPriority', false);
+        if (!Array.isArray(priorities) || referenceEl.contains(document.activeElement))
+            return;
+        const lastFocus = referenceEl.querySelector(`[${LAST_FOCUS}]`);
+        if (lastFocus && isVisible(lastFocus))
+            return moveFocus(lastFocus);
+        const selectors = {
+            content: 'main, [role="main"]',
+            heading: 'h1, [role="heading"][aria-level="1"]',
+            banner: 'header, [role="banner"]',
+        };
+        for (const priority of priorities) {
+            const selector = selectors[String(priority)];
+            const candidate = selector ? referenceEl.querySelector(selector) : null;
+            if (candidate && isVisible(candidate))
+                return moveFocus(candidate);
+        }
+        moveFocus(referenceEl);
+    },
+});
+//# sourceMappingURL=focus-controller.js.map

package/node_modules/@rdlabo/ionic-theme-utils/dist/focus-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-controller.js","sourceRoot":"","sources":["../src/focus-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,UAAU,GAAG,gBAAgB,CAAC;AACpC,MAAM,SAAS,GAAG,CAAC,OAAoB,EAAE,EAAE;IACzC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACtB,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC,CAAC;AACF,MAAM,SAAS,GAAG,CAAC,OAAoB,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,KAAK,IAAI,CAAC;AAO1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAoB,EAAE,CAAC,CAAC;IAC3D,aAAa,EAAE,CAAC,WAAW,EAAE,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,CAAC;YAAE,OAAO;QACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC;QACxC,IAAI,QAAQ,IAAI,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC;YAAE,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC7F,CAAC;IACD,YAAY,EAAE,CAAC,WAAW,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAU,sBAAsB,EAAE,KAAK,CAAC,CAAC;QACtE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC;YAAE,OAAO;QACvF,MAAM,SAAS,GAAG,WAAW,CAAC,aAAa,CAAc,IAAI,UAAU,GAAG,CAAC,CAAC;QAC5E,IAAI,SAAS,IAAI,SAAS,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC;QACnE,MAAM,SAAS,GAA2B;YACxC,OAAO,EAAE,qBAAqB;YAC9B,OAAO,EAAE,sCAAsC;YAC/C,MAAM,EAAE,yBAAyB;SAClC,CAAC;QACF,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAc,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACrF,IAAI,SAAS,IAAI,SAAS,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC;QACrE,CAAC;QACD,SAAS,CAAC,WAAW,CAAC,CAAC;IACzB,CAAC;CACF,CAAC,CAAC"}

package/node_modules/@rdlabo/ionic-theme-utils/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { createIosTransitionAnimation, shadow, type IosTransitionAnimationConfig, type IosTransitionAnimationOptions, } from './transition/ios.transition';
+export type { PopoverInterface, PopoverOptions, PopoverSize, TriggerAction, PositionReference, PositionSide, PositionAlign, } from './popover/popover-interface';
+export { POPOVER_IOS_BODY_MARGIN, getPopoverDimensions, configureDismissInteraction, configureTriggerInteraction, getIndexOfItem, getNextItem, getPrevItem, getPopoverPosition, calculateWindowAdjustment, type ReferenceCoordinates, type PopoverStyles, } from './popover/utils';
+export { createCalloutSurface } from './popover/callout-surface';
+export { iosEnterAnimation as iosPopoverEnterAnimation } from './popover/animations/ios.enter';
+export { iosLeaveAnimation as iosPopoverLeaveAnimation } from './popover/animations/ios.leave';
+export { cloneElement, getStep, changeSelectedElement, Config, config } from './theme';
+export { getElementRoot, raf } from './dom';
+export { createFocusController, type FocusController } from './focus-controller';
+export type { EffectScales, registeredEffect, AnimationPosition } from './sheets-of-glass';
+export { TabBarSearchableType, type TabBarSearchableFunction, type SearchableEventCache, type ElementSizes, type ElementReferences, } from './tab-bar-searchable/interfaces';
+export { ANIMATION_DURATION, ANIMATION_DELAY_BASE, ANIMATION_DELAY_CLOSE_BUTTONS, ANIMATION_EASING, OPACITY_TRANSITION, throwErrorByFailedClickElement, throwErrorByFailedExistElement, getElement, getElementReferences, getElementSizes, } from './tab-bar-searchable/utils';
+//# sourceMappingURL=index.d.ts.map