@rdlabo/ionic-theme-ios27 1.2.1 → 2.0.0-2

package/ios/Sources/IonicNativeUIShellPlugin/Components/ShellTabBar.swift

@@ -1,221 +0,0 @@
-import UIKit
-
-enum ShellTabBar {
-    struct Anchor: Decodable, Equatable {
-        let x: Double
-        let y: Double
-        var isValid: Bool { [0, 0.5, 1].contains(x) && [0, 1].contains(y) }
-    }
-
-    /// Optimistic tab selection until the Web selected state catches up (or times out).
-    struct PendingSelection: Equatable {
-        var id: String
-        var until: CFAbsoluteTime
-        static func start(_ id: String, ttl: CFTimeInterval = 1) -> PendingSelection {
-            PendingSelection(id: id, until: CFAbsoluteTimeGetCurrent() + ttl)
-        }
-    }
-
-    static let kind = ShellComponent.tabBar
-    /// Tab bars waiting for an iOS 26 title-layout warmup after the next `fit`.
-    private static var pendingTitleWarmup = Set<ObjectIdentifier>()
-
-    static func make(_ node: ShellControl, rendering: ShellRendering, delegate: UITabBarDelegate) -> UITabBar {
-        let control = UITabBar()
-        configureLayout(control)
-#if DEBUG
-        NSLog("[Native UI Shell] Created UITabBar %@", node.id)
-#endif
-        control.delegate = delegate
-        update(control, node: node, rendering: rendering)
-        return control
-    }
-
-    static func configureLayout(_ tabBar: UITabBar) {
-        // The reader accepts icon-top tabs. Keep that layout local to the native
-        // bar instead of letting the iPad idiom turn it into inline items.
-        if #available(iOS 17.0, *) {
-            tabBar.traitOverrides.horizontalSizeClass = .compact
-            tabBar.traitOverrides.verticalSizeClass = .regular
-        }
-        tabBar.itemPositioning = .fill
-    }
-
-    static func update(_ tabBar: UITabBar, node: ShellControl, rendering: ShellRendering) {
-        var pending: PendingSelection?
-        update(tabBar, node: node, rendering: rendering, pendingSelection: &pending)
-    }
-
-    static func update(_ tabBar: UITabBar, node: ShellControl, rendering: ShellRendering,
-                       pendingSelection: inout PendingSelection?) {
-        let items = node.items
-        let ids = items.map(\.id)
-        var needsTitleWarmup = false
-        // Keep UIKit's item identities and interaction state across DOM selection updates.
-        if tabBar.items?.map({ $0.accessibilityIdentifier ?? "" }) != ids {
-            tabBar.items = items.map { item in
-                let tab = UITabBarItem(title: item.content.label, image: rendering.image(item.content), tag: 0)
-                tab.accessibilityIdentifier = item.id
-                return tab
-            }
-            needsTitleWarmup = true
-        }
-        let nativeItems = tabBar.items ?? []
-        for (tab, item) in zip(nativeItems, items) {
-            let title = item.content.label
-            if tab.title != title {
-                tab.title = title
-                needsTitleWarmup = true
-            }
-            let icon = rendering.image(item.content)
-            if tab.image !== icon {
-                tab.image = icon
-                needsTitleWarmup = true
-            }
-            if tab.selectedImage !== icon { tab.selectedImage = icon }
-            tab.isEnabled = !item.content.disabled
-            tab.accessibilityLabel = item.content.accessibilityLabel
-            if applyTypography(item.content, to: tab) { needsTitleWarmup = true }
-            applyBadge(item.content.badge, to: tab, rendering: rendering)
-        }
-        let domSelected = zip(nativeItems, items).first { $0.1.content.selected }
-        let selectedItem = domSelected?.0
-        if let pending = pendingSelection {
-            let pendingItem = zip(nativeItems, items).first { $0.1.id == pending.id }
-            let expired = CFAbsoluteTimeGetCurrent() >= pending.until
-            let unavailable = pendingItem == nil || pendingItem!.1.content.disabled
-            if unavailable || expired {
-                // Ionic rejected the tap, the item vanished, or the echo timed out.
-                pendingSelection = nil
-                if tabBar.selectedItem !== selectedItem { tabBar.selectedItem = selectedItem }
-            } else if domSelected?.1.id == pending.id {
-                pendingSelection = nil
-                if tabBar.selectedItem !== selectedItem { tabBar.selectedItem = selectedItem }
-            } else if tabBar.selectedItem !== pendingItem!.0 {
-                // Keep the optimistic native selection until the Web selected state catches up.
-                tabBar.selectedItem = pendingItem!.0
-            }
-        } else if tabBar.selectedItem !== selectedItem {
-            tabBar.selectedItem = selectedItem
-        }
-        tabBar.semanticContentAttribute = node.rtl ? .forceRightToLeft : .forceLeftToRight
-        tabBar.accessibilityIdentifier = node.id
-        // Warm after `fit` settles geometry — not on every motion-driven frame sync.
-        if needsTitleWarmup { pendingTitleWarmup.insert(ObjectIdentifier(tabBar)) }
-    }
-
-    @discardableResult
-    static func applyTypography(_ content: ShellItemContent, to item: UITabBarItem) -> Bool {
-        let weight: UIFont.Weight
-        switch content.fontWeight {
-        case ..<150: weight = .ultraLight
-        case ..<250: weight = .thin
-        case ..<350: weight = .light
-        case ..<450: weight = .regular
-        case ..<550: weight = .medium
-        case ..<650: weight = .semibold
-        case ..<750: weight = .bold
-        case ..<850: weight = .heavy
-        default: weight = .black
-        }
-        let font = UIFont.systemFont(ofSize: content.fontSize, weight: weight)
-        var changed = false
-        for state in [UIControl.State.normal, .selected] {
-            if item.titleTextAttributes(for: state)?[.font] as? UIFont != font {
-                item.setTitleTextAttributes([.font: font], for: state)
-                changed = true
-            }
-        }
-        return changed
-    }
-
-    static func applyBadge(_ badge: ShellBadge?, to item: UITabBarItem, rendering: ShellRendering) {
-        // nil removes a badge; an empty string keeps the native notification dot.
-        item.badgeValue = badge?.value
-        item.accessibilityValue = badge?.value
-        item.badgeColor = badge.map { rendering.color($0.color) }
-        let attributes = badge.map { [NSAttributedString.Key.foregroundColor: rendering.color($0.textColor)] }
-        item.setBadgeTextAttributes(attributes, for: .normal)
-        item.setBadgeTextAttributes(attributes, for: .selected)
-    }
-
-    static func fit(_ tabBar: UITabBar, node: ShellControl, bounds: CGRect) -> Bool {
-        // Place a new bar before asking UIKit for its safe-area-dependent size.
-        // Measuring at the initial zero frame makes a restored iPad bar 5pt shorter.
-        if tabBar.bounds.isEmpty {
-            tabBar.frame = bounds
-            tabBar.layoutIfNeeded()
-        }
-        let fitted = tabBar.sizeThatFits(bounds.size)
-        var size = CGSize(width: bounds.width,
-                          height: max(bounds.height, fitted.height))
-        if tabBar.bounds.size != size { tabBar.bounds.size = size }
-        tabBar.layoutIfNeeded()
-        // UIKit's tab content occupies only part of UITabBar's outer frame.
-        // Align that content to ion-tab-bar, whose CSS already owns placement.
-        guard var content = contentFrame(tabBar) else {
-            return false
-        }
-        // Reserve ion-tab-bar's width for the tab content, excluding UIKit's outer gutters.
-        // UIKit can cap the content width for a small number of items.
-        // Do not keep expanding the outer frame beyond its natural size.
-        size.width = min(bounds.width + tabBar.bounds.width - content.width,
-                         max(bounds.width, fitted.width))
-        if abs(tabBar.bounds.width - size.width) > 0.1 {
-            tabBar.bounds.size = size
-            tabBar.layoutIfNeeded()
-            guard let measured = contentFrame(tabBar) else {
-                return false
-            }
-            content = measured
-        }
-        // UIKit owns the adaptive platter size, including changes after badge/title updates.
-        // Preserve the DOM placement anchor instead of requiring identical item widths.
-        let anchor = node.tabBarAnchor
-        let x = anchor?.x ?? 0
-        let y = anchor?.y ?? 0
-        let center = CGPoint(x: bounds.minX + (bounds.width - content.width) * x - content.minX + size.width / 2,
-                             y: bounds.minY + (bounds.height - content.height) * y - content.minY + size.height / 2)
-        if tabBar.center != center { tabBar.center = center }
-        if pendingTitleWarmup.remove(ObjectIdentifier(tabBar)) != nil {
-            warmUnselectedTitleLayout(tabBar)
-        }
-        return true
-    }
-
-    /// iOS 26 only: programmatically visit each unselected item so UIKit measures
-    /// its title the same way a user tap would. Selection does not call the
-    /// tab-bar delegate. No-op on iOS 27+, where first paint already matches Web.
-    static func warmUnselectedTitleLayout(_ tabBar: UITabBar) {
-        let version = ProcessInfo.processInfo.operatingSystemVersion
-        guard version.majorVersion == 26, let items = tabBar.items, items.count > 1 else { return }
-        let selected = tabBar.selectedItem
-        UIView.performWithoutAnimation {
-            for item in items where item !== selected {
-                tabBar.selectedItem = item
-                tabBar.layoutIfNeeded()
-            }
-            if tabBar.selectedItem !== selected {
-                tabBar.selectedItem = selected
-                tabBar.layoutIfNeeded()
-            }
-        }
-    }
-
-    private static func contentFrame(_ tabBar: UITabBar) -> CGRect? {
-        contentFrames(tabBar).reduce(nil) { (result: CGRect?, frame) in result.map { $0.union(frame) } ?? frame }
-    }
-
-    static func contentFrames(_ tabBar: UITabBar) -> [CGRect] {
-        contentViews(tabBar).map { $0.frame }
-    }
-
-    static func contentViews(_ tabBar: UITabBar) -> [UIView] {
-        func containsControl(_ view: UIView) -> Bool {
-            view is UIControl || view.subviews.contains(where: containsControl)
-        }
-        return tabBar.subviews
-            .filter { !$0.isHidden && $0.alpha > 0 && containsControl($0) }
-            .filter { !$0.frame.isEmpty }
-    }
-}

package/ios/Sources/IonicNativeUIShellPlugin/Components/ShellVerticalBars.swift

@@ -1,437 +0,0 @@
-import Combine
-import SwiftUI
-import UIKit
-
-protocol ShellVerticalBarsControlling: AnyObject {
-    var view: UIView { get }
-    func attach(to owner: UIViewController, in parent: UIView)
-    @MainActor func apply(_ controls: [ShellControl], rendering: ShellRendering, edge: String)
-    var ownsKeyboardChrome: Bool { get }
-    func detach()
-}
-
-@available(iOS 26.0, *)
-final class ShellVerticalBarsModel: ObservableObject {
-    struct Item: Identifiable {
-        let id: String
-        let label: String
-        let accessibilityLabel: String
-        let image: UIImage?
-        let clear: Bool
-        let background: Color?
-        let borderColor: Color?
-        let borderWidth: CGFloat
-        let badge: ShellBadge?
-        let disabled: Bool
-        var selected: Bool
-    }
-
-    struct Group: Identifiable {
-        let id: String
-        let items: [Item]
-        let slot: ShellControl.ToolbarSlot?
-    }
-
-    @Published var search: ShellVerticalSearchModel?
-    @Published var back: Item?
-    @Published var groups: [Group] = []
-    @Published var tabs: [Item] = []
-    @Published var selection = ""
-    var activate: (String) -> Void = { _ in }
-    private var domSelection = ""
-    private var pendingSelection: ShellTabBar.PendingSelection?
-    private var pendingExpiryWork: DispatchWorkItem?
-
-    func apply(_ controls: [ShellControl], rendering: ShellRendering,
-               now: CFAbsoluteTime = CFAbsoluteTimeGetCurrent()) {
-        func item(_ source: ShellItem) -> Item {
-            let image = rendering.image(source.content)
-            return Item(id: source.id, label: source.content.label,
-                 accessibilityLabel: source.content.accessibilityLabel,
-                 // UIKit toolbar extraction uses the UIImage's rendering mode.
-                 image: source.content.disabled ? image?.withRenderingMode(.alwaysTemplate) : image,
-                 clear: source.content.buttonFill == .clear,
-                 background: source.content.backgroundColor.map { Color(uiColor: rendering.color($0)) },
-                 borderColor: source.content.borderColor.map { Color(uiColor: rendering.color($0)) },
-                 borderWidth: source.content.borderWidth ?? 0,
-                 badge: source.content.badge, disabled: source.content.disabled,
-                 selected: source.content.selected)
-        }
-        withAnimation(.smooth(duration: 0.3)) {
-            back = controls.first(where: { $0.kind == .backButton })?.items.first.map(item)
-            groups = controls.compactMap { control in
-                guard [.button, .buttons, .menuButton].contains(control.kind) else { return nil }
-                return Group(id: control.id, items: control.items.map(item), slot: control.toolbarSlot)
-            }
-        }
-        tabs = controls.first(where: { $0.kind == .tabBar })?.items.map(item) ?? []
-        domSelection = tabs.first(where: \.selected)?.id ?? ""
-        reconcileSelection(now: now)
-    }
-
-    func select(_ id: String, now: CFAbsoluteTime = CFAbsoluteTimeGetCurrent(), ttl: CFTimeInterval = 1) {
-        guard let item = tabs.first(where: { $0.id == id }), !item.disabled else { return }
-        pendingSelection = .init(id: id, until: now + ttl)
-        selection = id
-        pendingExpiryWork?.cancel()
-        let work = DispatchWorkItem { [weak self] in self?.reconcileSelection() }
-        pendingExpiryWork = work
-        DispatchQueue.main.asyncAfter(deadline: .now() + ttl + 0.02, execute: work)
-        activate(id)
-    }
-
-    private func reconcileSelection(now: CFAbsoluteTime = CFAbsoluteTimeGetCurrent()) {
-        guard let pending = pendingSelection else { selection = domSelection; return }
-        let item = tabs.first(where: { $0.id == pending.id })
-        if item == nil || item!.disabled || now >= pending.until || domSelection == pending.id {
-            pendingSelection = nil
-            pendingExpiryWork?.cancel()
-            pendingExpiryWork = nil
-            selection = domSelection
-        } else {
-            selection = pending.id
-        }
-    }
-}
-
-@available(iOS 26.0, *)
-private struct ShellVerticalBarsLabel: View {
-    let item: ShellVerticalBarsModel.Item
-
-    var body: some View {
-        if let image = item.image {
-            Label {
-                Text(item.label.isEmpty ? item.accessibilityLabel : item.label)
-            } icon: {
-                Image(uiImage: image)
-            }
-        } else {
-            Text(item.label)
-        }
-    }
-}
-
-@available(iOS 26.0, *)
-@ViewBuilder
-private func verticalBarsButton(_ item: ShellVerticalBarsModel.Item, model: ShellVerticalBarsModel) -> some View {
-    let button = Button { model.activate(item.id) } label: { ShellVerticalBarsLabel(item: item) }
-        .disabled(item.disabled)
-        .accessibilityLabel(item.accessibilityLabel)
-        .accessibilityIdentifier(item.id)
-    if let background = item.background {
-        button.buttonStyle(.glassProminent).tint(background)
-    } else {
-        button.overlay {
-            if let borderColor = item.borderColor {
-                Capsule().strokeBorder(borderColor, lineWidth: item.borderWidth).allowsHitTesting(false)
-            }
-        }
-    }
-}
-
-@available(iOS 26.0, *)
-private struct ShellVerticalBarsButton: ToolbarContent {
-    @ObservedObject var model: ShellVerticalBarsModel
-    let id: String
-    let placement: ToolbarItemPlacement
-
-    // Observe here so same-ID updates also refresh the shared toolbar background.
-    var body: some ToolbarContent {
-        if let item = model.groups.lazy.flatMap(\.items).first(where: { $0.id == id }) {
-            ToolbarItem(placement: placement) { verticalBarsButton(item, model: model) }
-                .sharedBackgroundVisibility(item.clear ? .hidden : .automatic)
-        }
-    }
-}
-
-@available(iOS 26.0, *)
-private func verticalBarsBackButton(_ item: ShellVerticalBarsModel.Item, model: ShellVerticalBarsModel) -> some View {
-    Button { model.activate(item.id) } label: { Image(systemName: "chevron.backward") }
-        .disabled(item.disabled)
-        .accessibilityLabel(item.accessibilityLabel)
-        .accessibilityIdentifier("BackButton")
-}
-
-@available(iOS 26.0, *)
-private struct ShellVerticalBarsBadge: ViewModifier {
-    let badge: ShellBadge?
-
-    @ViewBuilder func body(content: Content) -> some View {
-        if let badge { content.badge(badge.value) }
-        else { content }
-    }
-}
-
-@available(iOS 26.0, *)
-private struct ShellVerticalBarsView: View {
-    @ObservedObject var model: ShellVerticalBarsModel
-
-    var body: some View {
-        Group {
-            if model.tabs.isEmpty {
-                ShellVerticalBarsPage(model: model)
-            } else {
-                TabView(selection: Binding(get: { model.selection }, set: { model.select($0) })) {
-                    ForEach(model.tabs) { item in
-                        ShellVerticalBarsPage(model: model)
-                        .tag(item.id)
-                        .tabItem { ShellVerticalBarsLabel(item: item) }
-                        .modifier(ShellVerticalBarsBadge(badge: item.badge))
-                        .disabled(item.disabled)
-                        .accessibilityLabel(item.accessibilityLabel)
-                        .accessibilityIdentifier(item.id)
-                    }
-                }
-            }
-        }
-        .modifier(ShellVerticalBarsSearch(model: model))
-        .modifier(ShellVerticalBarsCompression())
-        .background(Color.clear)
-    }
-}
-
-@available(iOS 26.0, *)
-private struct ShellVerticalBarsPage: View {
-    @ObservedObject var model: ShellVerticalBarsModel
-
-    var body: some View {
-        NavigationStack {
-            Color.clear.modifier(ShellVerticalBarsToolbarAdapter(model: model))
-                .toolbar {
-                    if model.search?.configuration.available == true {
-                        // Let the system adapt bottom-bar search to the vertical rail.
-                        DefaultToolbarItem(kind: .search, placement: .bottomBar)
-                    }
-                }
-        }
-    }
-}
-
-@available(iOS 26.0, *)
-private struct ShellVerticalBarsSearch: ViewModifier {
-    @ObservedObject var model: ShellVerticalBarsModel
-    @ViewBuilder func body(content: Content) -> some View {
-        if let search = model.search {
-            content.modifier(ShellVerticalSearchModifier(model: search))
-        } else { content }
-    }
-}
-
-@available(iOS 26.0, *)
-private struct ShellVerticalBarsCompression: ViewModifier {
-    @ViewBuilder func body(content: Content) -> some View {
-        #if canImport(UIKit, _underlyingVersion: 9127.0.85) && !targetEnvironment(macCatalyst)
-        if #available(iOS 27.1, *) {
-            content.toolbarVerticalCompressionBehavior(.prefersToolbarItems)
-        } else {
-            content
-        }
-        #else
-        content
-        #endif
-    }
-}
-
-@available(iOS 26.0, *)
-private struct ShellVerticalBarsToolbarAdapter: ViewModifier {
-    @ObservedObject var model: ShellVerticalBarsModel
-
-    @ViewBuilder func body(content: Content) -> some View {
-        #if canImport(UIKit, _underlyingVersion: 9127.0.85) && !targetEnvironment(macCatalyst)
-        if #available(iOS 27.1, *) {
-            content.modifier(ShellVerticalBarsToolbar(model: model))
-        } else {
-            content.modifier(ShellVerticalBarsLegacyToolbar(model: model))
-        }
-        #else
-        content.modifier(ShellVerticalBarsLegacyToolbar(model: model))
-        #endif
-    }
-}
-
-#if canImport(UIKit, _underlyingVersion: 9127.0.85) && !targetEnvironment(macCatalyst)
-@available(iOS 27.1, *)
-private struct ShellVerticalBarsToolbar: ViewModifier {
-    @ObservedObject var model: ShellVerticalBarsModel
-
-    func body(content: Content) -> some View {
-        content.toolbar {
-            if let back = model.back {
-                ToolbarItem(placement: .navigation) {
-                    verticalBarsBackButton(back, model: model)
-                }
-                .axisBehavior(.verticalPreferred)
-            }
-            ForEach(model.groups.filter { $0.slot == .start }) { group in
-                if group.id != model.groups.first(where: { $0.slot == .start })?.id {
-                    ToolbarSpacer(.fixed, placement: .topBarLeading)
-                }
-                ForEach(group.items) { item in
-                    ShellVerticalBarsButton(model: model, id: item.id, placement: .topBarLeading)
-                    .axisBehavior(.verticalPreferred)
-                }
-            }
-            ForEach(model.groups.filter { $0.slot != .start }) { group in
-                if group.id != model.groups.first(where: { $0.slot != .start })?.id {
-                    ToolbarSpacer(.fixed, placement: .topBarTrailing)
-                }
-                ForEach(group.items) { item in
-                    ShellVerticalBarsButton(model: model, id: item.id, placement: .topBarTrailing)
-                    .axisBehavior(.verticalPreferred)
-                }
-            }
-        }
-    }
-}
-#endif
-
-@available(iOS 26.0, *)
-private struct ShellVerticalBarsLegacyToolbar: ViewModifier {
-    @ObservedObject var model: ShellVerticalBarsModel
-
-    func body(content: Content) -> some View {
-        content.toolbar {
-            if let back = model.back {
-                ToolbarItem(placement: .navigation) {
-                    verticalBarsBackButton(back, model: model)
-                }
-            }
-            ForEach(model.groups) { group in
-                if group.id != model.groups.first?.id {
-                    ToolbarSpacer(.fixed, placement: .primaryAction)
-                }
-                ForEach(group.items) { item in
-                    ShellVerticalBarsButton(model: model, id: item.id, placement: .primaryAction)
-                }
-            }
-        }
-    }
-}
-
-@available(iOS 26.0, *)
-final class ShellVerticalBarsController: ShellVerticalBarsControlling {
-    private final class TransparentHostingController<Content: View>: UIHostingController<Content> {
-        var railEdge = "right"
-        var layoutSearch: (() -> Void)?
-        override func viewDidLayoutSubviews() {
-            super.viewDidLayoutSubviews()
-            makeFullSizeSurfacesTransparent(in: view)
-            layoutSearch?()
-        }
-
-        private func makeFullSizeSurfacesTransparent(in surface: UIView) {
-            let frame = surface.convert(surface.bounds, to: view)
-            guard !(surface is UIVisualEffectView) else { return }
-            let coversHost = frame.insetBy(dx: -1, dy: -1).contains(view.bounds)
-            // SwiftUI may add an opaque backing behind the rail controls, sized to
-            // the rail or to an expanded tab bar. Keep that backing clear without
-            // touching the glass controls or materials.
-            let coversRail = frame.minY <= 1 && frame.maxY >= view.bounds.maxY - 1 &&
-                (railEdge == "left" ? frame.minX <= 1 : frame.maxX >= view.bounds.maxX - 1)
-            if coversHost || coversRail {
-                surface.backgroundColor = .clear
-                surface.isOpaque = false
-            }
-            surface.subviews.forEach(makeFullSizeSurfacesTransparent)
-        }
-    }
-
-    private final class RailContainer: UIView {
-        var railEdge = "right"
-
-        private var railWidth: CGFloat {
-            let inset = railEdge == "left" ? safeAreaInsets.left : safeAreaInsets.right
-            return inset > 0 ? inset : 80
-        }
-
-        // The rail is not masked: expanded rail content (a widened tab bar) is
-        // allowed to draw over the WebView. Inside the base rail touches behave
-        // as before; beyond it touches are captured only where they land inside
-        // an actual bar surface so empty overlap still belongs to the WebView.
-        // The SwiftUI hosting scaffold reports a full-size hosting view for
-        // every point, so the hit result cannot tell bar content from empty
-        // space — the bar frames decide instead.
-        override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
-            let hit = super.hitTest(point, with: event)
-            let inRail = railEdge == "left" ? point.x <= railWidth : point.x >= bounds.maxX - railWidth
-            if inRail { return hit }
-            // Expanded system search leaves the rail; its field and close button
-            // must receive touches instead of passing them through to the WebView.
-            var ancestor = hit
-            while let view = ancestor, view !== self {
-                if view is UIControl { return hit }
-                ancestor = view.superview
-            }
-            guard hit != nil, containsBarSurface(at: point) else { return nil }
-            return hit
-        }
-
-        private func containsBarSurface(at point: CGPoint) -> Bool {
-            containsBarSurface(in: self, at: point)
-        }
-
-        private func containsBarSurface(in view: UIView, at point: CGPoint) -> Bool {
-            guard !view.isHidden, view.alpha > 0.05 else { return false }
-            let name = NSStringFromClass(type(of: view))
-            if (name.contains("TabBar") || name.contains("Platter") || name.contains("Pocket") || name.contains("Sidebar") || view is UISearchBar || view is UINavigationBar),
-               convert(view.bounds, from: view).contains(point) { return true }
-            return view.subviews.contains { containsBarSurface(in: $0, at: point) }
-        }
-    }
-
-    private let model = ShellVerticalBarsModel()
-    private lazy var controller = TransparentHostingController(rootView: ShellVerticalBarsView(model: model))
-    private let container = RailContainer()
-    private weak var owner: UIViewController?
-    private let changed: (String, ShellSearchPhase, String, Bool, Int) -> Int
-
-    var view: UIView { container }
-
-    var ownsKeyboardChrome: Bool { model.search?.ownsKeyboardChrome == true }
-
-    init(activate: @escaping (String) -> Void,
-         changed: @escaping (String, ShellSearchPhase, String, Bool, Int) -> Int) {
-        self.changed = changed
-        model.activate = activate
-        container.backgroundColor = .clear
-        controller.view.backgroundColor = .clear
-        controller.view.isOpaque = false
-        controller.layoutSearch = { [weak self] in self?.model.search?.configureField() }
-    }
-
-    func attach(to owner: UIViewController, in parent: UIView) {
-        guard self.owner !== owner || container.superview !== parent else { return }
-        detach()
-        self.owner = owner
-        owner.addChild(controller)
-        container.frame = parent.bounds
-        container.autoresizingMask = [.flexibleWidth, .flexibleHeight]
-        controller.view.frame = container.bounds
-        controller.view.autoresizingMask = [.flexibleWidth, .flexibleHeight]
-        container.addSubview(controller.view)
-        parent.addSubview(container)
-        controller.didMove(toParent: owner)
-    }
-
-    @MainActor func apply(_ controls: [ShellControl], rendering: ShellRendering, edge: String) {
-        container.railEdge = edge
-        controller.railEdge = edge
-        let tabsAppear = model.tabs.isEmpty && controls.contains { $0.kind == .tabBar && !$0.items.isEmpty }
-        if let search = controls.first(where: { $0.search != nil })?.search {
-            if model.search?.configuration.id == search.id { model.search?.apply(search) }
-            else { model.search = ShellVerticalSearchModel(search, in: container, activate: model.activate, changed: changed) }
-        } else { model.search = nil }
-        model.apply(controls, rendering: rendering)
-        if tabsAppear { ShellCrossfade.enter(container, duration: ShellCrossfade.duration(180)) }
-        controller.overrideUserInterfaceStyle = controls.contains(where: \.dark) ? .dark : .light
-    }
-
-    func detach() {
-        guard controller.parent != nil else { return }
-        controller.willMove(toParent: nil)
-        container.removeFromSuperview()
-        controller.view.removeFromSuperview()
-        controller.removeFromParent()
-        owner = nil
-    }
-}