@ajuarezso/capacitor-liquid-glass 0.3.4 → 0.3.6

package/ios/Sources/LiquidGlassPlugin/LiquidGlassPlugin.swift

@@ -152,7 +152,12 @@ public class LiquidGlassPlugin: CAPPlugin, CAPBridgedPlugin {
     }
 
     private func presentTabBar(items: [LiquidGlassTabItem], selectedIndex: Int, tintHex: String?, styleRaw: String) {
-        guard let window = UIApplication.shared.capacitorWindow else { return }
+        // CRÍTICO: usar `bridge?.viewController` (el VC que contiene el
+        // WKWebView de Capacitor) en lugar del `rootViewController` del
+        // window. iOS 26 aplica Liquid Glass automáticamente al UITabBar
+        // solo cuando está en la jerarquía del VC del webview. El rootVC
+        // del window puede ser un container distinto y romper el adopt.
+        guard let hostVC = bridge?.viewController else { return }
 
         if tabBarOverlay == nil {
             let overlay = LiquidGlassTabBarOverlay()
@@ -169,7 +174,7 @@ public class LiquidGlassPlugin: CAPPlugin, CAPBridgedPlugin {
         }
 
         let style = LiquidGlassTabBarStyle(rawValue: styleRaw) ?? .default
-        tabBarOverlay?.attach(to: window)
+        tabBarOverlay?.attach(to: hostVC)
         tabBarOverlay?.configure(items: items, selectedIndex: selectedIndex, tintHex: tintHex, style: style)
         tabBarOverlay?.show()
     }

package/ios/Sources/LiquidGlassPlugin/LiquidGlassTabBarOverlay.swift

@@ -42,14 +42,18 @@ enum LiquidGlassTabBarStyle: String {
 /// app se compila contra el SDK iOS 26.
 ///
 /// **Decisión arquitectónica crítica**: este view controller se adjunta como
-/// CHILD del rootViewController del window, y el `UITabBar` vive como subview
-/// de `self.view`. Esto crea el view controller hierarchy completo que iOS 26
-/// necesita para aplicar el material Liquid Glass automáticamente al UITabBar.
+/// CHILD del view controller que contiene el WKWebView de Capacitor
+/// (`bridge?.viewController`), y el `UITabBar` vive como subview de
+/// `self.view`. Esto crea el view controller hierarchy completo que iOS 26
+/// necesita para aplicar el material Liquid Glass automáticamente al
+/// UITabBar.
 ///
-/// Agregar el `UITabBar` directamente al `UIWindow` (sin view controller
-/// container) NO funciona — iOS 26 omite el adopt automático y la pill se
-/// renderiza con un material translúcido genérico que se ve opaco en
-/// comparación con el material real de Music / App Store.
+/// Por qué NO usar `window.rootViewController`: en Capacitor el rootVC del
+/// window puede ser un container distinto al VC del webview. iOS 26 solo
+/// aplica Liquid Glass auto cuando el UITabBar vive en la jerarquía del VC
+/// que tiene el webview activo. Agregarlo al rootVC del window puede
+/// romper el auto-adopt y dejarlo con material translúcido genérico opaco
+/// (no el real de Music / App Store).
 ///
 /// Patrón inspirado en `stay-liquid` (alistairheath/stay-liquid GitHub).
 final class LiquidGlassTabBarOverlay: UIViewController {
@@ -66,7 +70,7 @@ final class LiquidGlassTabBarOverlay: UIViewController {
     override func viewDidLoad() {
         super.viewDidLoad()
         // Background transparente. El `self.view` está sizado SOLO al rect
-        // del tab bar (leading/trailing/bottom al rootVC, sin top — la
+        // del tab bar (leading/trailing/bottom al hostVC, sin top — la
         // altura la determina el intrinsic content size del UITabBar dentro).
         // Por eso NO necesitamos `hitTest` override: el view en sí solo
         // existe sobre el área de la pill, los taps fuera no llegan.
@@ -75,9 +79,13 @@ final class LiquidGlassTabBarOverlay: UIViewController {
         tabBar.translatesAutoresizingMaskIntoConstraints = false
         tabBar.delegate = self
 
-        // Default appearance: triggers Liquid Glass automatically on iOS 26+.
-        // Sobreescrito en `configure(...)` si el caller pidió otro estilo.
-        applyAppearance(tabBar, style: .default)
+        // CRÍTICO: NO setear appearance acá. iOS 26 adopta Liquid Glass
+        // automáticamente SOLO si el UITabBar mantiene su appearance default
+        // intacto. Tocar `standardAppearance` / `scrollEdgeAppearance` en
+        // CUALQUIER forma — incluso con `configureWithDefaultBackground()` —
+        // anula el adopt y deja un material translúcido genérico opaco.
+        // Solo los overrides intencionales (.ultraThin, .transparent) tocan
+        // el appearance, vía `applyAppearance(...)` desde `configure(...)`.
 
         view.addSubview(tabBar)
 
@@ -91,12 +99,13 @@ final class LiquidGlassTabBarOverlay: UIViewController {
         ])
     }
 
-    /// Adjunta este view controller como child del rootViewController del
-    /// window. Idempotente: si ya está adjuntado al mismo root, no-op.
-    func attach(to window: UIWindow) {
-        guard let rootVC = window.rootViewController else { return }
-        if self.parent === rootVC { return }
-        // Si está adjuntado a otro VC (cambio de root entre sesiones),
+    /// Adjunta este view controller como child del view controller que
+    /// contiene el WKWebView de Capacitor (`bridge?.viewController`).
+    /// Idempotente: si ya está adjuntado al mismo host, no-op.
+    func attach(to hostVC: UIViewController?) {
+        guard let hostVC else { return }
+        if self.parent === hostVC { return }
+        // Si está adjuntado a otro VC (cambio de host entre sesiones),
         // detachar primero antes de re-adjuntar.
         if self.parent != nil {
             self.willMove(toParent: nil)
@@ -104,37 +113,45 @@ final class LiquidGlassTabBarOverlay: UIViewController {
             self.removeFromParent()
         }
 
-        rootVC.addChild(self)
+        hostVC.addChild(self)
+        hostVC.view.addSubview(self.view)
         self.view.translatesAutoresizingMaskIntoConstraints = false
-        rootVC.view.addSubview(self.view)
+        // CRÍTICO: `didMove(toParent:)` ANTES de activar constraints. iOS 26
+        // ejecuta el primer layout pass al didMove; tener el parenting
+        // completo antes de que el sistema mida el UITabBar es lo que el
+        // heurístico de Liquid Glass auto-adopt espera (patrón stay-liquid).
+        self.didMove(toParent: hostVC)
         // SIN top constraint — la altura del view se deriva del intrinsic
         // content size del UITabBar dentro (~50pt + safe-area-bottom).
-        // Replica del patrón stay-liquid (validado en producción) que
-        // permite a iOS 26 detectar este UITabBar como "floating tab bar"
-        // y aplicarle Liquid Glass automáticamente.
         NSLayoutConstraint.activate([
-            self.view.leadingAnchor.constraint(equalTo: rootVC.view.leadingAnchor),
-            self.view.trailingAnchor.constraint(equalTo: rootVC.view.trailingAnchor),
-            self.view.bottomAnchor.constraint(equalTo: rootVC.view.bottomAnchor),
+            self.view.leadingAnchor.constraint(equalTo: hostVC.view.leadingAnchor),
+            self.view.trailingAnchor.constraint(equalTo: hostVC.view.trailingAnchor),
+            self.view.bottomAnchor.constraint(equalTo: hostVC.view.bottomAnchor),
         ])
-        self.didMove(toParent: rootVC)
-        self.hostVC = rootVC
+        self.hostVC = hostVC
         emitLayout()
     }
 
     /// Aplica el appearance correspondiente al estilo solicitado.
-    /// - `default` / `liquidGlass`: Liquid Glass nativo iOS 26 (SDK 26 + runtime
-    ///   26). En iOS < 26 cae al blur translúcido legacy.
+    /// - `default` / `liquidGlass`: **NO-OP** — el UITabBar mantiene su
+    ///   appearance default sin tocar para que iOS 26 aplique Liquid Glass
+    ///   automáticamente. Cualquier touch al appearance (incluso
+    ///   `configureWithDefaultBackground()`) rompe el auto-adopt.
     /// - `ultraThin`: blur mínimo `systemUltraThinMaterial` — más ver-through.
+    ///   Override intencional que CANCELA Liquid Glass.
     /// - `transparent`: sin background ni blur — content behind se ve completo.
+    ///   Override intencional que CANCELA Liquid Glass.
     private func applyAppearance(_ tabBar: UITabBar, style: LiquidGlassTabBarStyle) {
+        // Early-return para los estilos que confían en el adopt automático
+        // del sistema. Tocar appearance acá anula Liquid Glass.
+        if style == .default || style == .liquidGlass { return }
+
         let appearance = UITabBarAppearance()
         switch style {
         case .default, .liquidGlass:
-            // En iOS 26+ con SDK 26, esto adopta Liquid Glass automáticamente.
-            // NO hacer override de `backgroundEffect` — eso anula el adopt y
-            // produce un material opaco genérico.
-            appearance.configureWithDefaultBackground()
+            // Unreachable — early-return arriba. Mantenido por exhaustividad
+            // del switch sobre el enum.
+            return
         case .ultraThin:
             appearance.configureWithDefaultBackground()
             appearance.backgroundEffect = UIBlurEffect(style: .systemUltraThinMaterial)
@@ -174,7 +191,12 @@ final class LiquidGlassTabBarOverlay: UIViewController {
             return tab
         }
 
-        tabBar.setItems(uiItems, animated: false)
+        // CRÍTICO: setter directo `tabBar.items = ...` en lugar de
+        // `tabBar.setItems(_, animated: false)`. En iOS 26 el método
+        // `setItems(animated:)` toma un path interno distinto que puede
+        // invalidar el adopt automático de Liquid Glass. El setter directo
+        // es el que stay-liquid usa (línea 98 de su TabsBarOverlay).
+        tabBar.items = uiItems
 
         if selectedIndex < 0 {
             tabBar.selectedItem = nil
@@ -198,41 +220,23 @@ final class LiquidGlassTabBarOverlay: UIViewController {
         tabBarItems[idx].badgeValue = value
     }
 
+    /// CRÍTICO: NO tocar `tabBar.alpha`, `tabBar.transform` ni `tabBar.isHidden`.
+    /// iOS 26 inspecciona el UITabBar en el primer layout pass para decidir si
+    /// adopta Liquid Glass. Si en ese momento el bar está con `alpha=0` o un
+    /// `transform` distinto de `.identity`, el sistema descarta el adopt y NO
+    /// re-evalúa aunque después vuelva a valores normales.
+    ///
+    /// Para animar la aparición/desaparición sin perder el adopt, se manipula
+    /// `self.view.isHidden` (el contenedor del VC), no el UITabBar mismo.
+    /// Patrón validado en stay-liquid (su `update()` simplemente hace
+    /// `view.isHidden = !visible`).
     func show() {
-        if !tabBar.isHidden && tabBar.alpha == 1.0 { emitLayout(); return }
-        tabBar.isHidden = false
-        tabBar.alpha = 0
-        tabBar.transform = CGAffineTransform(translationX: 0, y: 20)
-        UIView.animate(
-            withDuration: 0.28,
-            delay: 0,
-            usingSpringWithDamping: 0.85,
-            initialSpringVelocity: 0,
-            options: [.curveEaseOut, .allowUserInteraction],
-            animations: {
-                self.tabBar.alpha = 1
-                self.tabBar.transform = .identity
-            },
-            completion: nil
-        )
+        view.isHidden = false
         emitLayout()
     }
 
     func hide() {
-        if tabBar.isHidden { return }
-        UIView.animate(
-            withDuration: 0.18,
-            delay: 0,
-            options: [.curveEaseIn, .allowUserInteraction],
-            animations: {
-                self.tabBar.alpha = 0
-                self.tabBar.transform = CGAffineTransform(translationX: 0, y: 20)
-            },
-            completion: { _ in
-                self.tabBar.isHidden = true
-                self.tabBar.transform = .identity
-            }
-        )
+        view.isHidden = true
     }
 
     func setSelectedIndex(_ index: Int) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ajuarezso/capacitor-liquid-glass",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "iOS 26 Liquid Glass native chrome (TabBar, NavigationBar, Alerts, Sheets) for Capacitor apps. Falls back gracefully on iOS < 26 and Android.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",