FloatingSurfaceKit

FloatingSurfaceKit is a small Swift package for building transparent, shadow-friendly AppKit/SwiftUI floating surfaces on macOS.

It currently includes:

• FloatingPanelHostingView, a transparent NSHostingView for borderless panel content.
• FloatingPanelShadow helpers for giving visible SwiftUI surfaces enough transparent panel padding for unclipped shadows.
• floatingSurfaceShadow(...) and floatingPanelShadowPadding(...) SwiftUI modifiers.
• NSPanel.useTransparentFloatingContentHost() for clear, shadowless panel hosts.
• KeyablePanel, a borderless panel subclass that can become key for text entry.
• KeyMonitor for lightweight Escape-key handling in SwiftUI surfaces.
• NSWindow.focusFirstEditableText(...) and FirstTextFieldFocusBridge for focusing the first editable NSTextField or NSTextView after SwiftUI content attaches to an NSPanel.
• VisualEffect, a thin NSVisualEffectView wrapper.

The package is deliberately app-agnostic. It is meant for palettes, HUDs (heads-up displays), popovers, compact tool panels, desktop companions, and other floating macOS UI.