@rdlabo/capacitor-native-ui 0.0.0-stage → 2.0.0-1

package/ios/Sources/NativeUIPlugin/Components/NativeUIButton.swift

@@ -0,0 +1,71 @@
+import UIKit
+
+enum NativeUIButton {
+    private final class BadgeLabel: UILabel {}
+    // These Ionic components share the same native UIButton presentation.
+    static let kinds: [NativeUIComponent] = [.button, .backButton, .menuButton]
+
+    @available(iOS 26.0, *)
+    static func make(_ node: NativeUIControl, rendering: NativeUIControlRendering, activate: @escaping (String) -> Void) -> UIButton? {
+        guard node.items.count == 1, let item = node.items.first else { return nil }
+        let control = render(item.content, glass: true, rendering: rendering, activate: activate)
+        control.semanticContentAttribute = node.rtl ? .forceRightToLeft : .forceLeftToRight
+        return control
+    }
+
+    @available(iOS 26.0, *)
+    static func render(_ item: NativeUIItemContent, glass: Bool, existing: UIButton? = nil, rendering: NativeUIControlRendering, activate: @escaping (String) -> Void) -> UIButton {
+        var configuration: UIButton.Configuration = glass ? .glass() : .plain()
+        configuration.title = item.label
+        configuration.image = rendering.image(item)
+        configuration.imagePadding = item.imagePadding ?? 4
+        configuration.contentInsets = NSDirectionalEdgeInsets(top: 0, leading: item.contentInsetLeading ?? 4,
+                                                            bottom: 0, trailing: item.contentInsetTrailing ?? 4)
+        configuration.imagePlacement = item.iconPosition == .trailing ? .trailing : .leading
+        configuration.baseForegroundColor = rendering.color(item.color)
+        configuration.titleLineBreakMode = .byTruncatingTail
+        let size = item.fontSize
+        let weight = item.fontWeight
+        configuration.titleTextAttributesTransformer = UIConfigurationTextAttributesTransformer { incoming in
+            var outgoing = incoming
+            outgoing.font = UIFont.systemFont(ofSize: size, weight: weight >= 600 ? .semibold : weight >= 500 ? .medium : .regular)
+            return outgoing
+        }
+        let button = existing ?? UIButton(configuration: configuration)
+        if existing != nil { button.configuration = configuration }
+        button.titleLabel?.numberOfLines = 1
+        // Web and UIKit can differ by a fraction of a point in text measurement.
+        // Absorb that rounding without widening the projected button.
+        button.titleLabel?.adjustsFontSizeToFitWidth = true
+        button.titleLabel?.minimumScaleFactor = 0.99
+        button.isEnabled = !item.disabled
+        button.accessibilityLabel = item.accessibilityLabel
+        button.accessibilityIdentifier = item.id
+        if item.selected { button.accessibilityTraits.insert(.selected) }
+        button.subviews.filter { $0 is BadgeLabel }.forEach { $0.removeFromSuperview() }
+        button.accessibilityValue = item.badge?.value
+        if let badge = item.badge {
+            let label = BadgeLabel()
+            label.text = badge.value
+            label.font = .systemFont(ofSize: 11, weight: .semibold)
+            label.textColor = rendering.color(badge.textColor)
+            label.backgroundColor = rendering.color(badge.color)
+            label.textAlignment = .center
+            label.layer.cornerRadius = 8
+            label.clipsToBounds = true
+            label.isAccessibilityElement = false
+            label.translatesAutoresizingMaskIntoConstraints = false
+            button.addSubview(label)
+            NSLayoutConstraint.activate([
+                label.centerXAnchor.constraint(equalTo: button.centerXAnchor, constant: 14),
+                label.topAnchor.constraint(equalTo: button.topAnchor, constant: 1),
+                label.widthAnchor.constraint(greaterThanOrEqualToConstant: max(16, label.intrinsicContentSize.width + 6)),
+                label.heightAnchor.constraint(equalToConstant: 16)
+            ])
+        }
+        if existing == nil {
+            button.addAction(UIAction { _ in activate(item.id) }, for: .touchUpInside)
+        }
+        return button
+    }
+}

package/ios/Sources/NativeUIPlugin/Components/NativeUIButtons.swift

@@ -0,0 +1,24 @@
+import UIKit
+
+enum NativeUIButtons {
+    static let kind = NativeUIComponent.buttons
+
+    @available(iOS 26.0, *)
+    static func make(_ node: NativeUIControl, scale: CGFloat, rendering: NativeUIControlRendering, activate: @escaping (String) -> Void) -> UIView {
+        let items = node.items
+        let rtl = node.rtl
+        let effect = UIGlassEffect(style: .regular)
+        let control = UIVisualEffectView(effect: effect)
+        control.layer.cornerRadius = node.frame.height * scale / 2
+        control.clipsToBounds = true
+        control.accessibilityIdentifier = node.id
+        for item in items {
+            let button = NativeUIButton.render(item.content, glass: false, rendering: rendering, activate: activate)
+            button.semanticContentAttribute = rtl ? .forceRightToLeft : .forceLeftToRight
+            let rect = item.frame.rect
+            button.frame = CGRect(x: rect.minX * scale, y: rect.minY * scale, width: rect.width * scale, height: rect.height * scale)
+            control.contentView.addSubview(button)
+        }
+        return control
+    }
+}

package/ios/Sources/NativeUIPlugin/Components/NativeUIComponents.swift

@@ -0,0 +1,19 @@
+import UIKit
+
+// Static composition of supported wire kinds. Component files own their names and rendering.
+enum NativeUIComponents {
+    static let supported = Set(NativeUIButton.kinds + [NativeUIButtons.kind, NativeUITabBar.kind, NativeUISegment.kind, NativeUIFab.kind])
+
+    @available(iOS 26.0, *)
+    static func make(_ node: NativeUIControl, scale: CGFloat, rendering: NativeUIControlRendering,
+                     tabDelegate: UITabBarDelegate, activate: @escaping (String) -> Void) -> UIView? {
+        switch node.kind {
+        case .button, .backButton, .menuButton: return NativeUIButton.make(node, rendering: rendering, activate: activate)
+        case .buttons: return NativeUIButtons.make(node, scale: scale, rendering: rendering, activate: activate)
+        case .tabBar: return NativeUITabBar.make(node, rendering: rendering, delegate: tabDelegate)
+        case .segment: return NativeUISegment.make(node, scale: scale, rendering: rendering, activate: activate)
+        case .fab: return NativeUIFab()
+        case .extension: return nil // App-local SwiftUI content is hosted by the shell.
+        }
+    }
+}

package/ios/Sources/NativeUIPlugin/Components/NativeUIFab.swift

@@ -0,0 +1,80 @@
+import UIKit
+
+final class NativeUIFab: UIView {
+    static let kind = NativeUIComponent.fab
+    var buttons: [String: UIButton] = [:]
+    var content: [String: NativeUIItemContent] = [:]
+    override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
+        let hit = super.hitTest(point, with: event)
+        return hit === self ? nil : hit
+    }
+
+    @available(iOS 26.0, *)
+    func apply(_ node: NativeUIControl, scale: CGFloat, rendering: NativeUIControlRendering, activate: @escaping (String) -> Void) {
+        let items = node.items
+        let retained = Set(items.map(\.id))
+        var lostFocus = false
+        for id in Array(self.buttons.keys) where !retained.contains(id) {
+            lostFocus = lostFocus || self.buttons[id]?.accessibilityElementIsFocused() == true
+            self.buttons.removeValue(forKey: id)?.removeFromSuperview()
+            self.content.removeValue(forKey: id)
+        }
+        self.accessibilityIdentifier = node.id
+        for item in items {
+            let id = item.id
+            let artwork = item.content.fabArtwork
+            let previous = self.buttons[id]
+            let button = previous ?? NativeUIButton.render(artwork, glass: true, rendering: rendering, activate: activate)
+            if previous == nil {
+                self.buttons[id] = button
+                self.addSubview(button)
+            } else if self.content[id] != artwork {
+                let changedIcon = self.content[id]?.selected != item.content.selected
+                let duration = UIAccessibility.isReduceMotionEnabled ? 0 : min(item.content.iconTransition ?? 0, 1)
+                if changedIcon, let imageView = button.imageView, duration > 0 {
+                    UIView.transition(with: imageView, duration: duration,
+                                      options: [.transitionCrossDissolve, .beginFromCurrentState, .allowUserInteraction]) {
+                        _ = NativeUIButton.render(artwork, glass: true, existing: button, rendering: rendering, activate: activate)
+                    }
+                } else {
+                    UIView.performWithoutAnimation { _ = NativeUIButton.render(artwork, glass: true, existing: button, rendering: rendering, activate: activate) }
+                }
+            }
+            self.content[id] = artwork
+            button.accessibilityTraits.remove(.selected)
+            if id == items.first?.id && items.count > 1 {
+                button.accessibilityValue = item.content.selected
+                    ? NSLocalizedString("Expanded", comment: "FAB accessibility state")
+                    : NSLocalizedString("Collapsed", comment: "FAB accessibility state")
+            } else {
+                button.accessibilityValue = nil
+            }
+            let hidden = item.visible == false
+            if hidden && !button.isHidden && button.accessibilityElementIsFocused() { lostFocus = true }
+            button.isHidden = hidden
+            button.isUserInteractionEnabled = button.isEnabled && !hidden
+            button.semanticContentAttribute = node.rtl ? .forceRightToLeft : .forceLeftToRight
+            let rect = item.frame.rect
+            let frame = CGRect(x: rect.minX * scale, y: rect.minY * scale, width: rect.width * scale, height: rect.height * scale)
+            if button.frame != frame { button.frame = frame }
+        }
+        let ordered = items.compactMap { self.buttons[$0.id] }.filter { !$0.isHidden }
+        self.accessibilityElements = ordered
+        if lostFocus, let main = ordered.first, main.isEnabled, self.window != nil {
+            UIAccessibility.post(notification: .layoutChanged, argument: main)
+        }
+    }
+}
+
+extension NativeUIItemContent {
+    var fabArtwork: Self {
+        var artwork = self
+        if selected {
+            artwork.icon = closeIcon
+            artwork.iconWidth = closeIconWidth
+            artwork.iconHeight = closeIconHeight
+            artwork.label = ""
+        }
+        return artwork
+    }
+}

package/ios/Sources/NativeUIPlugin/Components/NativeUISearchController.swift

@@ -0,0 +1,439 @@
+import UIKit
+
+struct NativeUISearch: Decodable, Equatable {
+    let id: String
+    let field: NativeUIItemContent
+    let trigger: NativeUIItem
+    let closeId: String
+    let active: Bool
+    let available: Bool
+    let focused: Bool
+    let value: String
+    let placeholder: String
+    let disabled: Bool
+    let editSequence: Int
+    let valueVersion: Int
+
+    var isValid: Bool {
+        !id.isEmpty && !closeId.isEmpty && field.isValid && trigger.isValid && editSequence >= 0 && valueVersion >= 0
+    }
+}
+
+enum NativeUISearchPhase: String { case input, focus, blur, clear, commit }
+
+// A controller's empty content must not intercept the existing WebView.
+final class NativeUISearchHost: UIView {
+    override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
+        guard let hit = super.hitTest(point, with: event) else { return nil }
+        var ancestor: UIView? = hit
+        while let current = ancestor, current !== self {
+            if current is UIControl || current is UISearchBar || current is UITabBar { return hit }
+            ancestor = current.superview
+        }
+        return nil
+    }
+}
+
+// Preserve UISearchBar's delegate while returning its clear action to Ionic.
+final class NativeUISearchInputDelegate: NSObject, UITextFieldDelegate {
+    weak var original: UITextFieldDelegate?
+    var clear: (() -> Void)?
+    override func responds(to selector: Selector!) -> Bool {
+        super.responds(to: selector) || original?.responds(to: selector) == true
+    }
+    override func forwardingTarget(for selector: Selector!) -> Any? { original }
+    func textFieldShouldClear(_ textField: UITextField) -> Bool { clear?(); return false }
+}
+
+// Lets the plugin registry retain iOS 26-gated search controllers without
+// availability-gated stored properties, mirroring NativeUIVerticalBarsControlling.
+protocol NativeUISearchControlling: AnyObject {
+    var surface: NativeUISearchHost { get }
+    var ownsKeyboard: Bool { get }
+    var ownsKeyboardChrome: Bool { get }
+    var transitionCoordinator: UIViewControllerTransitionCoordinator? { get }
+    var activate: ((String) -> Void)? { get set }
+    var changed: ((String, NativeUISearchPhase, String, Bool, Int) -> Int)? { get set }
+    func attach(to parent: UIViewController, in container: UIView)
+    func detach()
+    func apply(_ snapshot: NativeUIControl, webFrame: CGRect, barFrame: CGRect, triggerFrame: CGRect, rendering: NativeUIControlRendering) -> Bool
+}
+
+@available(iOS 26.0, *)
+final class NativeUISearchController: UITabBarController, UITabBarControllerDelegate, UISearchBarDelegate, NativeUISearchControlling {
+    // Wire stays active+focused; local session drives chrome (idle / presented / focused).
+    private enum Session: Equatable { case idle, presented, focused }
+
+    let surface = NativeUISearchHost()
+    private var restingBarFrame: CGRect?
+    private var restingBarAnchor: NativeUITabBar.Anchor?
+    private var fittingTabBar = false
+    private let search = UISearchController(searchResultsController: nil)
+    private let inputDelegate = NativeUISearchInputDelegate()
+    private var searchTab: UISearchTab!
+    private var ordinary: [String: UITab] = [:]
+    private var configuration: NativeUISearch?
+    private var selectedID = ""
+    private var closing = false
+    private var editingSequence = 0
+    private var valueVersion = -1
+    private var lockedWebFrame: CGRect? // frozen while search is active (width changes re-lock)
+    private var session: Session = .idle
+    private var focusWork: DispatchWorkItem?
+    private var pendingSelection: NativeUITabBar.PendingSelection? // optimistic ordinary tab
+    private var pendingExpiryWork: DispatchWorkItem?
+    var ownsKeyboard: Bool { search.searchBar.searchTextField.isFirstResponder }
+    var ownsKeyboardChrome: Bool { session == .focused || ownsKeyboard }
+    var activate: ((String) -> Void)?
+    var changed: ((String, NativeUISearchPhase, String, Bool, Int) -> Int)?
+
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        view.backgroundColor = .clear
+        view.autoresizingMask = [.flexibleWidth, .flexibleHeight]
+        surface.backgroundColor = .clear
+        surface.autoresizingMask = [.flexibleWidth, .flexibleHeight]
+        delegate = self
+        mode = .tabBar
+        NativeUITabBar.configureLayout(tabBar)
+        search.obscuresBackgroundDuringPresentation = false
+        search.hidesNavigationBarDuringPresentation = false
+        search.searchBar.delegate = self
+        search.searchBar.autocapitalizationType = .none
+        search.searchBar.autocorrectionType = .no
+        search.searchBar.spellCheckingType = .no
+        search.searchBar.searchTextField.clearButtonMode = .always
+        searchTab = UISearchTab { [weak self] _ in
+            let child = UIViewController()
+            child.view.backgroundColor = .clear
+            child.definesPresentationContext = true
+            child.navigationItem.searchController = self?.search
+            child.navigationItem.hidesSearchBarWhenScrolling = false
+            child.navigationItem.preferredSearchBarPlacement = .integrated
+            let navigation = UINavigationController(rootViewController: child)
+            navigation.view.backgroundColor = .clear
+            return navigation
+        }
+        searchTab.automaticallyActivatesSearch = false
+        inputDelegate.clear = { [weak self] in self?.emit(.clear) }
+    }
+
+    deinit {
+        focusWork?.cancel()
+        pendingExpiryWork?.cancel()
+    }
+
+    private func wantedSession(active: Bool, focused: Bool) -> Session {
+        if !active { return .idle }
+        return focused ? .focused : .presented
+    }
+
+    private func endEditing() {
+        focusWork?.cancel()
+        focusWork = nil
+        if search.searchBar.searchTextField.isFirstResponder {
+            search.searchBar.searchTextField.resignFirstResponder()
+        }
+        if search.isActive { search.isActive = false }
+    }
+
+    private func applySession(_ wanted: Session, selectingSearchTab: Bool) {
+        if wanted == session && !selectingSearchTab { return }
+        if wanted == .idle {
+            endEditing()
+            session = .idle
+            return
+        }
+        if selectingSearchTab || selectedTab !== searchTab { selectedTab = searchTab }
+        if wanted == .presented {
+            if session == .focused { endEditing() }
+            session = .presented
+            return
+        }
+        session = .focused
+        if !search.isActive { search.isActive = true }
+        guard !search.searchBar.searchTextField.isFirstResponder, focusWork == nil else { return }
+        let work = DispatchWorkItem { [weak self] in
+            guard let self else { return }
+            self.focusWork = nil
+            guard self.session == .focused, !self.search.searchBar.searchTextField.isFirstResponder else { return }
+            if !self.search.isActive { self.search.isActive = true }
+            _ = self.search.searchBar.searchTextField.becomeFirstResponder()
+        }
+        focusWork = work
+        DispatchQueue.main.async(execute: work)
+    }
+
+    private func armPendingSelection(_ id: String) {
+        pendingSelection = .start(id)
+        schedulePendingExpiry()
+    }
+
+    private func clearPendingSelection() {
+        pendingExpiryWork?.cancel()
+        pendingExpiryWork = nil
+        pendingSelection = nil
+    }
+
+    private func schedulePendingExpiry() {
+        pendingExpiryWork?.cancel()
+        pendingExpiryWork = nil
+        guard let pending = pendingSelection else { return }
+        let delay = max(0, pending.until - CFAbsoluteTimeGetCurrent()) + 0.02
+        let work = DispatchWorkItem { [weak self] in
+            guard let self else { return }
+            self.pendingExpiryWork = nil
+            guard let pending = self.pendingSelection, CFAbsoluteTimeGetCurrent() >= pending.until else { return }
+            self.pendingSelection = nil
+            // Revert to the last DOM selection if Ionic did not accept the action.
+            if let selected = self.ordinary[self.selectedID], self.selectedTab !== selected {
+                self.selectedTab = selected
+            }
+        }
+        pendingExpiryWork = work
+        DispatchQueue.main.asyncAfter(deadline: .now() + delay, execute: work)
+    }
+
+    private func resolveOrdinarySelection(_ items: [NativeUIItem], fallback: UITab?) {
+        let domSelected = ordinary[selectedID] ?? fallback
+        guard let pending = pendingSelection else {
+            pendingExpiryWork?.cancel()
+            pendingExpiryWork = nil
+            if selectedTab !== domSelected { selectedTab = domSelected }
+            return
+        }
+        let pendingTab = ordinary[pending.id]
+        let expired = CFAbsoluteTimeGetCurrent() >= pending.until
+        let unavailable = pendingTab == nil || (items.first { $0.id == pending.id }?.content.disabled ?? true)
+        if unavailable || expired {
+            clearPendingSelection()
+            selectedTab = domSelected
+        } else if selectedID == pending.id {
+            clearPendingSelection()
+            if selectedTab !== domSelected { selectedTab = domSelected }
+        } else if selectedTab !== pendingTab {
+            selectedTab = pendingTab
+        }
+    }
+
+    func attach(to parent: UIViewController, in container: UIView) {
+        parent.addChild(self)
+        container.addSubview(surface)
+        surface.addSubview(view)
+        didMove(toParent: parent)
+    }
+
+    func detach() {
+        closing = true
+        lockedWebFrame = nil
+        clearPendingSelection()
+        applySession(.idle, selectingSearchTab: false)
+        willMove(toParent: nil)
+        restingBarFrame = nil
+        surface.removeFromSuperview()
+        view.removeFromSuperview()
+        removeFromParent()
+    }
+
+    func apply(_ snapshot: NativeUIControl, webFrame: CGRect, barFrame: CGRect, triggerFrame: CGRect,
+               rendering: NativeUIControlRendering) -> Bool {
+        loadViewIfNeeded()
+        guard let configuration = snapshot.search else { return false }
+        if self.configuration?.id != configuration.id {
+            editingSequence = 0
+            valueVersion = -1
+        }
+        let wasActive = self.configuration.map { $0.available && $0.active } ?? false
+        self.configuration = configuration
+        let available = configuration.available
+        let active = available && configuration.active
+        let wanted = wantedSession(active: active, focused: configuration.focused)
+        let items = snapshot.items
+        let ids = items.map(\.id)
+        for id in Array(ordinary.keys) where !ids.contains(id) { ordinary.removeValue(forKey: id) }
+        for item in items {
+            let id = item.id
+            let tab = ordinary[id] ?? UITab(title: "", image: nil, identifier: id) { _ in
+                let child = UIViewController()
+                child.view.backgroundColor = .clear
+                return child
+            }
+            tab.accessibilityIdentifier = id
+            tab.title = item.content.label
+            tab.image = rendering.image(item.content)
+            tab.badgeValue = item.content.badge?.value
+            tab.isEnabled = !item.content.disabled
+            ordinary[id] = tab
+            if item.content.selected { selectedID = id }
+        }
+        let trigger = configuration.trigger
+        searchTab.accessibilityIdentifier = trigger.id
+        searchTab.image = rendering.image(trigger.content)
+        searchTab.isEnabled = !configuration.disabled
+        let requested = ids.compactMap { ordinary[$0] } + (available ? [searchTab!] : [])
+        if !active, tabs.isEmpty || tabs.map(\.identifier) != requested.map(\.identifier) {
+            tabs = requested
+        }
+        for item in items {
+            if let nativeItem = ordinary[item.id]?.viewController?.tabBarItem {
+                nativeItem.accessibilityLabel = item.content.accessibilityLabel
+                NativeUITabBar.applyTypography(item.content, to: nativeItem)
+                NativeUITabBar.applyBadge(item.content.badge, to: nativeItem, rendering: rendering)
+            }
+        }
+        searchTab.viewController?.tabBarItem.accessibilityLabel = trigger.content.accessibilityLabel
+        let prominent = NSSelectorFromString("setProminentTabIdentifier:")
+        if responds(to: prominent) { setValue(available ? searchTab.identifier : nil, forKey: "prominentTabIdentifier") }
+        let field = configuration.field
+        search.searchBar.searchTextField.accessibilityIdentifier = configuration.id
+        search.searchBar.searchTextField.accessibilityLabel = field.accessibilityLabel
+        search.searchBar.setImage(rendering.image(field), for: .search, state: .normal)
+        search.searchBar.placeholder = configuration.placeholder
+        search.searchBar.searchTextField.isEnabled = !configuration.disabled
+        let nextValueVersion = configuration.valueVersion
+        if nextValueVersion != valueVersion || configuration.editSequence >= editingSequence {
+            valueVersion = nextValueVersion
+            let value = configuration.value
+            if search.searchBar.text != value { search.searchBar.text = value }
+        }
+        if search.searchBar.searchTextField.delegate !== inputDelegate {
+            inputDelegate.original = search.searchBar.searchTextField.delegate
+            search.searchBar.searchTextField.delegate = inputDelegate
+        }
+        // Resting keeps closing=true so hidden UISearchBar noise cannot emit; clear it while active.
+        closing = !active
+        surface.isHidden = false
+        surface.overrideUserInterfaceStyle = snapshot.dark ? .dark : .light
+        if active {
+            // UISearchTab session owns the bar + keyboard; freeze Web layout for the session.
+            if tabs.isEmpty || tabs.map(\.identifier) != requested.map(\.identifier) {
+                tabs = requested
+            }
+            restingBarFrame = nil
+            view.frame = surface.bounds
+            let nextLock = surface.bounds.isEmpty ? webFrame : surface.frame
+            if let locked = lockedWebFrame, abs(locked.width - webFrame.width) > 0.5 {
+                // Rotation / size-class change: adopt the new width while still ignoring keyboard shrink.
+                lockedWebFrame = webFrame
+            } else if lockedWebFrame == nil {
+                lockedWebFrame = nextLock
+            }
+            if let lockedWebFrame, surface.frame != lockedWebFrame { surface.frame = lockedWebFrame }
+            clearPendingSelection()
+            applySession(wanted, selectingSearchTab: !wasActive)
+            return true
+        }
+
+        surface.frame = webFrame
+        view.semanticContentAttribute = snapshot.rtl ? .forceRightToLeft : .forceLeftToRight
+        tabBar.semanticContentAttribute = snapshot.rtl ? .forceRightToLeft : .forceLeftToRight
+        tabBar.accessibilityIdentifier = snapshot.id
+        if lockedWebFrame != nil {
+            lockedWebFrame = nil
+        }
+        applySession(.idle, selectingSearchTab: false)
+
+        view.frame = surface.bounds
+        resolveOrdinarySelection(items, fallback: requested.first)
+        restingBarFrame = surface.convert(barFrame, from: surface.superview)
+        restingBarAnchor = snapshot.tabBarAnchor
+        view.setNeedsLayout()
+        view.layoutIfNeeded()
+        return fitRestingTabBar()
+    }
+
+    override func viewDidLayoutSubviews() {
+        super.viewDidLayoutSubviews()
+        if session == .idle { _ = fitRestingTabBar() }
+    }
+
+    /// Match the ordinary tab platter to the source ion-tab-bar by resizing
+    /// the controller's view, so UIKit can keep managing its tab bar through
+    /// search expansion and dismissal.
+    private func fitRestingTabBar() -> Bool {
+        guard let bounds = restingBarFrame, !fittingTabBar else { return true }
+        fittingTabBar = true
+        defer { fittingTabBar = false }
+        tabBar.layoutIfNeeded()
+        for _ in 0..<2 {
+            let regions = NativeUITabBar.contentViews(tabBar)
+            func controlCount(_ view: UIView) -> Int {
+                (view is UIControl ? 1 : 0) + view.subviews.reduce(0) { $0 + controlCount($1) }
+            }
+            // Ordinary tabs contain their item controls; Search contains one.
+            // For a single tab, UIKit places ordinary tabs at the leading edge.
+            let rtl = tabBar.effectiveUserInterfaceLayoutDirection == .rightToLeft
+            guard let region = regions.max(by: {
+                let lhs = controlCount($0), rhs = controlCount($1)
+                if lhs != rhs { return lhs < rhs }
+                return rtl ? $0.frame.midX < $1.frame.midX : $0.frame.midX > $1.frame.midX
+            }) else { return false }
+            let content = region.frame
+            let contents = regions.map { $0.frame }
+            let measured = tabBar.convert(content, to: surface)
+            let width = bounds.width - measured.width
+            let x = bounds.minX + (bounds.width - measured.width) * (restingBarAnchor?.x ?? 0) - measured.minX
+            let y = bounds.minY + (bounds.height - measured.height) * (restingBarAnchor?.y ?? 0) - measured.minY
+            // UIKit rounds the platter frame; a subpoint difference must not
+            // keep invalidating its layout during search transitions.
+            if abs(width) <= 0.5 && abs(x) <= 0.5 && abs(y) <= 0.5 { break }
+            var frame = view.frame
+            // The controller also contains the separate search button. Include
+            // that space in its width limit without enlarging capped tab groups.
+            let searchWidth = contents.filter { $0 != content }.reduce(CGFloat(0)) { $0 + $1.width }
+            frame.size.width = min(frame.width + width, surface.bounds.width + searchWidth)
+            frame.origin.x += x
+            frame.origin.y += y
+            if abs(frame.width - view.frame.width) <= 0.5 && abs(x) <= 0.5 && abs(y) <= 0.5 { break }
+            view.frame = frame
+            view.setNeedsLayout()
+            view.layoutIfNeeded()
+        }
+        // Fitting the ordinary platter can move UIKit's separate Search control
+        // outside the WebView, especially for centered or trailing source bars.
+        // Reject that layout so Search keeps its usable Web fallback.
+        let visibleBounds = surface.bounds.insetBy(dx: -0.5, dy: -0.5)
+        let regions = NativeUITabBar.contentViews(tabBar)
+        return !regions.isEmpty && regions.allSatisfy {
+            visibleBounds.contains(tabBar.convert($0.frame, to: surface))
+        }
+    }
+
+    func tabBarController(_ tabBarController: UITabBarController, shouldSelectTab tab: UITab) -> Bool {
+        guard let configuration else { return false }
+        if tab === searchTab {
+            restingBarFrame = nil
+            clearPendingSelection()
+            activate?(configuration.trigger.id)
+            return true
+        }
+        if configuration.active {
+            if tab.identifier == selectedID { activate?(configuration.closeId) }
+            else { activate?(tab.identifier) }
+            return false
+        }
+        armPendingSelection(tab.identifier)
+        if selectedTab !== tab { selectedTab = tab }
+        activate?(tab.identifier)
+        return true
+    }
+
+    private func emit(_ phase: NativeUISearchPhase) {
+        guard !closing, let configuration else { return }
+        editingSequence = changed?(configuration.id, phase, search.searchBar.text ?? "", search.searchBar.searchTextField.markedTextRange != nil, valueVersion) ?? editingSequence
+    }
+    func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String) { emit(.input) }
+    func searchBarTextDidBeginEditing(_ searchBar: UISearchBar) {
+        if session != .idle { session = .focused }
+        emit(.focus)
+    }
+    func searchBarTextDidEndEditing(_ searchBar: UISearchBar) {
+        if session == .focused { session = .presented }
+        emit(.blur)
+    }
+    func searchBarSearchButtonClicked(_ searchBar: UISearchBar) { emit(.commit) }
+    func searchBarCancelButtonClicked(_ searchBar: UISearchBar) {
+        closing = true
+        if let configuration { activate?(configuration.closeId) }
+    }
+}