[WIP] Liquid Glass Adoption

PlayerUI/Controllers/PUIDetachedPlaybackStatusViewController.swift

@@ -16,6 +16,10 @@ public struct DetachedPlaybackStatus: Identifiable {
     var title: String
     var subtitle: String
     var snapshot: PUISnapshotClosure?
+
+    public var isFullScreen: Bool {
+        id == "fullScreen"
+    }
 }
 
 public extension DetachedPlaybackStatus {
@@ -65,6 +69,7 @@ public final class PUIDetachedPlaybackStatusViewController: NSViewController {
         v.imageScaling = .scaleProportionallyUpOrDown
         v.widthAnchor.constraint(equalToConstant: 74).isActive = true
         v.heightAnchor.constraint(equalToConstant: 74).isActive = true
+        v.contentTintColor = .labelColor.preferred(in: .darkAqua)
 
         return v
     }()
@@ -73,7 +78,7 @@ public final class PUIDetachedPlaybackStatusViewController: NSViewController {
         let f = NSTextField(labelWithString: "")
 
         f.font = .systemFont(ofSize: 20, weight: .medium)
-        f.textColor = .labelColor
+        f.textColor = .labelColor.preferred(in: .darkAqua)
         f.alignment = .center
 
         return f
@@ -83,7 +88,7 @@ public final class PUIDetachedPlaybackStatusViewController: NSViewController {
         let f = NSTextField(labelWithString: "")
 
         f.font = .systemFont(ofSize: 16)
-        f.textColor = .secondaryLabelColor
+        f.textColor = .secondaryLabelColor.preferred(in: .darkAqua)
         f.alignment = .center
 
         return f

PlayerUI/Definitions/Images.swift

@@ -103,6 +103,11 @@ extension NSImage {
 struct PUIControlMetrics: Hashable {
     var symbolSize: CGFloat
     var controlSize: CGFloat
+    var padding: CGFloat?
+    var glass: GlassStyle?
+    enum GlassStyle: Hashable {
+        case regular, clear
+    }
 
     static let medium = PUIControlMetrics(symbolSize: 16, controlSize: 26)
     static let large = PUIControlMetrics(symbolSize: 28, controlSize: 38)

PlayerUI/Protocols/PUIPlayerViewDelegates.swift

@@ -37,5 +37,11 @@ public protocol PUIPlayerViewAppearanceDelegate: AnyObject, PUIPlayerViewDetache
     func playerViewShouldShowTimestampLabels(_ playerView: PUIPlayerView) -> Bool
     func playerViewShouldShowFullScreenButton(_ playerView: PUIPlayerView) -> Bool
     func playerViewBackAndForwardDuration(_ playerView: PUIPlayerView) -> BackForwardSkipDuration
+    func playerViewWillHidePlayControls(_ playerView: PUIPlayerView)
+    func playerViewWillShowPlayControls(_ playerView: PUIPlayerView)
+}
 
+public extension PUIPlayerViewAppearanceDelegate {
+    func playerViewWillHidePlayControls(_ playerView: PUIPlayerView) {}
+    func playerViewWillShowPlayControls(_ playerView: PUIPlayerView) {}
 }

PlayerUI/Protocols/PUITimelineDelegate.swift

@@ -8,6 +8,7 @@
 
 import Cocoa
 
+@MainActor
 public protocol PUITimelineDelegate: AnyObject {
 
     func viewControllerForTimelineAnnotation(_ annotation: PUITimelineAnnotation) -> NSViewController?

PlayerUI/Util/AVPlayer+Layout.swift

@@ -28,8 +28,8 @@ public extension AVPlayer {
         constraints = [
             guide.widthAnchor.constraint(equalToConstant: videoRect.width),
             guide.heightAnchor.constraint(equalToConstant: videoRect.height),
-            guide.centerYAnchor.constraint(equalTo: container.centerYAnchor),
-            guide.centerXAnchor.constraint(equalTo: container.centerXAnchor)
+            guide.centerYAnchor.constraint(equalTo: container.safeAreaLayoutGuide.centerYAnchor),
+            guide.centerXAnchor.constraint(equalTo: container.safeAreaLayoutGuide.centerXAnchor)
         ]
 
         NSLayoutConstraint.activate(constraints)

PlayerUI/Util/NSColor+AppearanceCustomization.swift

@@ -0,0 +1,26 @@
+//
+//  NSColor+AppearanceCustomization.swift
+//  WWDC
+//
+//  Created by luca on 12.08.2025.
+//  Copyright © 2025 Guilherme Rambo. All rights reserved.
+//
+
+import AppKit
+
+public extension NSColor {
+    func preferred(in appearanceName: NSAppearance.Name) -> NSColor {
+        return NSColor(cgColor: preferredCGColor(in: appearanceName)) ?? self
+    }
+
+    func preferredCGColor(in appearanceName: NSAppearance.Name) -> CGColor {
+        guard let appearance = NSAppearance(named: appearanceName) else {
+            return cgColor
+        }
+        var result = cgColor
+        appearance.performAsCurrentDrawingAppearance { // accessing cgcolor will get the correct color under specific appearance
+            result = cgColor
+        }
+        return result
+    }
+}

PlayerUI/Util/NSView+BackgroundExtension.swift

@@ -0,0 +1,35 @@
+//
+//  NSView+BackgroundExtension.swift
+//  WWDC
+//
+//  Created by luca on 11.08.2025.
+//  Copyright © 2025 Guilherme Rambo. All rights reserved.
+//
+
+import AppKit
+import SwiftUI
+
+public extension NSView {
+    func backgroundExtensionEffect(reflect edges: Edge.Set = .all, isEnabled: Bool = true) -> NSView {
+        if isEnabled, #available(macOS 26.0, *) {
+            let extensionView = NSBackgroundExtensionView()
+            extensionView.contentView = self
+            extensionView.automaticallyPlacesContentView = false
+            extensionView.translatesAutoresizingMaskIntoConstraints = false
+            // only enable reflection effect on leading edge
+            let targetLeadingAnchor = edges.contains(.leading) ? extensionView.safeAreaLayoutGuide.leadingAnchor : extensionView.leadingAnchor
+            let targetTopAnchor = edges.contains(.top) ? extensionView.safeAreaLayoutGuide.topAnchor : extensionView.topAnchor
+            let targetTrailingAnchor = edges.contains(.trailing) ? extensionView.safeAreaLayoutGuide.trailingAnchor : extensionView.trailingAnchor
+            let targetBottomAnchor = edges.contains(.bottom) ? extensionView.safeAreaLayoutGuide.bottomAnchor : extensionView.bottomAnchor
+            NSLayoutConstraint.activate([
+                topAnchor.constraint(equalTo: targetTopAnchor),
+                leadingAnchor.constraint(equalTo: targetLeadingAnchor),
+                bottomAnchor.constraint(equalTo: targetBottomAnchor),
+                trailingAnchor.constraint(equalTo: targetTrailingAnchor)
+            ])
+            return extensionView
+        } else {
+            return self
+        }
+    }
+}

PlayerUI/Util/NSView+Glass.swift

@@ -0,0 +1,195 @@
+//
+//  NSView+Glass.swift
+//  WWDC
+//
+//  Created by luca on 12.08.2025.
+//  Copyright © 2025 Guilherme Rambo. All rights reserved.
+//
+
+import AppKit
+import SwiftUI
+
+public extension NSView {
+    @available(macOS 26.0, *)
+    func glassEffect(style: NSGlassEffectView.Style? = nil, cornerRadius: CGFloat? = nil, tintColor: NSColor? = nil) -> NSView {
+        let effectView = NSGlassEffectView()
+        if let cornerRadius {
+            effectView.cornerRadius = cornerRadius
+        }
+        if let style {
+            effectView.style = style
+        }
+        effectView.contentView = self
+        effectView.tintColor = tintColor
+        return effectView
+    }
+
+    // will be bridged to swiftui and back
+    @available(macOS 26.0, *)
+    func glassCapsuleEffect(_ glass: Glass = .regular, background: Color? = nil) -> NSView {
+        NSHostingView(rootView: ConditionalGlassViewWrapper(subview: self, glass: glass, background: background, padding: nil, shape: .capsule))
+    }
+
+    // will be bridged to swiftui and back
+    @available(macOS 26.0, *)
+    func glassCircleEffect(_ glass: Glass = .regular, background: Color? = nil, padding: CGFloat? = nil) -> NSView {
+        NSHostingView(rootView: ConditionalGlassViewWrapper(subview: self, glass: glass, background: background, padding: padding, shape: .circle))
+    }
+
+    @available(macOS 26.0, *)
+    static func horizontalGlassContainer(_ glass: Glass = .regular, background: Color? = nil, paddingEdge: Edge.Set = .all, padding: CGFloat? = nil, containerSpacing: CGFloat? = nil, spacing: CGFloat? = nil, groups: [[NSView]]) -> NSView {
+        NSHostingView(rootView: GroupedHorizontalGlassContainer(axis: .horizontal, subviewGroups: groups, containerSpacing: containerSpacing, spacing: spacing, glass: glass, background: background, paddingEdge: paddingEdge, padding: padding, shape: .capsule))
+    }
+
+    @available(macOS 26.0, *)
+    static func verticalGlassContainer(_ glass: Glass = .regular, background: Color? = nil, paddingEdge: Edge.Set = .all, padding: CGFloat? = nil, containerSpacing: CGFloat? = nil, spacing: CGFloat? = nil, groups: [[NSView]]) -> NSView {
+        NSHostingView(rootView: GroupedHorizontalGlassContainer(axis: .vertical, subviewGroups: groups, containerSpacing: containerSpacing, spacing: spacing, glass: glass, background: background, paddingEdge: paddingEdge, padding: padding, shape: .capsule))
+    }
+}
+
+@available(macOS 26.0, *)
+private struct GroupedHorizontalGlassContainer<S: Shape>: View {
+    let axis: Axis.Set
+    let subviewGroups: [[NSView]]
+    let containerSpacing: CGFloat?
+    let spacing: CGFloat?
+    let glass: Glass
+    let background: Color?
+    let paddingEdge: Edge.Set
+    let padding: CGFloat?
+    let shape: S
+    @Namespace private var namespace
+    var body: some View {
+        GlassEffectContainer(spacing: containerSpacing ?? spacing) {
+            Stack(axis: axis, spacing: spacing) {
+                ForEach(subviewGroups.indices, id: \.self) { groupIdx in
+                    ConditionalHorizontalGlassViewWrapper(
+                        axis: axis,
+                        subviews: subviewGroups[groupIdx],
+                        spacing: spacing,
+                        glass: glass,
+                        tint: background,
+                        paddingEdge: paddingEdge,
+                        padding: padding,
+                        id: "\(groupIdx)",
+                        namespace: namespace,
+                        shape: shape
+                    )
+                }
+            }
+        }
+    }
+
+    @available(macOS 26.0, *)
+    private struct ConditionalHorizontalGlassViewWrapper: View {
+        let axis: Axis.Set
+        let subviews: [NSView]
+        let spacing: CGFloat?
+        let glass: Glass
+        let background: Color?
+        let paddingEdge: Edge.Set
+        let padding: CGFloat?
+        let id: String
+        let namespace: Namespace.ID
+        let shape: S
+        @State private var isSubviewsHidden: [Bool]
+        init(axis: Axis.Set, subviews: [NSView], spacing: CGFloat?, glass: Glass, tint: Color?, paddingEdge: Edge.Set, padding: CGFloat?, id: String, namespace: Namespace.ID, shape: S) {
+            self.axis = axis
+            self.subviews = subviews
+            self.spacing = spacing
+            self.glass = glass
+            self.background = tint
+            self.paddingEdge = paddingEdge
+            self.padding = padding
+            self.isSubviewsHidden = subviews.map(\.isHidden)
+            self.id = id
+            self.namespace = namespace
+            self.shape = shape
+        }
+
+        var body: some View {
+            Stack(axis: axis, spacing: spacing) {
+                ForEach(subviews.indices, id: \.self) { idx in
+                    ConditionalViewWrapper(subview: subviews[idx], isHidden: $isSubviewsHidden[idx])
+                }
+            }
+            .padding(paddingEdge, padding)
+            .background(isSubviewsHidden.allSatisfy({ $0 }) ? .clear : background)
+            .clipShape(shape)
+            .glassEffect(isSubviewsHidden.allSatisfy({ $0 }) ? .identity : glass, in: .capsule)
+            .glassEffectID(id, in: namespace)
+            .opacity(isSubviewsHidden.allSatisfy({ $0 }) ? 0 : 1)
+        }
+    }
+}
+
+extension View {
+    @ViewBuilder
+    func Stack<Content: View>(axis: Axis.Set, spacing: CGFloat? = nil, @ViewBuilder content: () -> Content) -> some View {
+        if axis.contains(.vertical) {
+            VStack(spacing: spacing, content: content)
+        } else {
+            HStack(spacing: spacing, content: content)
+        }
+    }
+}
+
+@available(macOS 26.0, *)
+private struct ConditionalViewWrapper: View {
+    let subview: NSView
+    @State private var isSubviewHidden: Bool = false
+    var isHidden: Binding<Bool>?
+    var body: some View {
+        Group {
+            if !isSubviewHidden {
+                ViewWrapper(view: subview)
+                    .help(subview.toolTip ?? "")
+            }
+        }
+        .onReceive(subview.publisher(for: \.isHidden).removeDuplicates()) { newValue in
+            withAnimation {
+                isSubviewHidden = newValue
+                isHidden?.wrappedValue = newValue
+            }
+        }
+    }
+}
+
+@available(macOS 26.0, *)
+private struct ConditionalGlassViewWrapper<S: Shape>: View {
+    let subview: NSView
+    let glass: Glass
+    let background: Color?
+    let padding: CGFloat?
+    let shape: S
+    @State private var isSubviewHidden: Bool = false
+    var isHidden: Binding<Bool>?
+    var body: some View {
+        Group {
+            if !isSubviewHidden {
+                ViewWrapper(view: subview)
+                    .padding(.all, padding)
+                    .background(background)
+                    .clipShape(shape)
+                    .glassEffect(glass, in: shape)
+                    .help(subview.toolTip ?? "")
+                    .transition(.blurReplace)
+            }
+        }
+        .onReceive(subview.publisher(for: \.isHidden).removeDuplicates()) { newValue in
+            withAnimation {
+                isSubviewHidden = newValue
+                isHidden?.wrappedValue = newValue
+            }
+        }
+    }
+}
+
+private struct ViewWrapper: NSViewRepresentable {
+    let view: NSView
+    func makeNSView(context: Context) -> NSView {
+        view
+    }
+
+    func updateNSView(_ nsView: NSView, context: Context) {}
+}