ExploreSwiftUI 🚀

ExploreSwiftUI is a state-of-the-art, high-fidelity compatibility and uni layout library for SwiftUI. It provides an enterprise-ready, unified API surface to seamlessly leverage modern SwiftUI capabilities (from iOS 18+ all the way up to iOS 26+ / WWDC25) while guaranteeing elegant, high-fidelity fallbacks on older platforms (down to iOS 15, macOS 12, tvOS 15, watchOS 8, and visionOS 1).

With ExploreSwiftUI, you write clean, future-proof SwiftUI code once, and it automatically scales down to legacy operating systems without triggering build-time availability warnings or cluttering your codebase with nested #if os(...) and if #available(...) blocks.

---

📱 Platform & Version Matrix

Platform	Deployment Target (Min)	Fully Leverages Modern APIs (Max)
iOS	iOS 15.0	iOS 26.0+
macOS	macOS 12.0 (macOS 15.0 for TabContent)	macOS 26.0+
tvOS	tvOS 15.0	tvOS 26.0+
watchOS	watchOS 8.0	watchOS 26.0+
visionOS	visionOS 1.0	visionOS 2.0+

---

✨ Features

• 🛠️ Polymorphic DSLs: Write unified structures (like UniTabView) that dynamically compiles to modern TabContent structures on newer systems and legacy View-based structures on older OS versions.
• ⚙️ Smart Availability Flow: Dynamically evaluate platform capabilities via simple parameters, completely bypassing verbose runtime compiler blocks.
• 🎨 Unified Design Tokens: Modern Glassmorphic, Prominent, and Tinted styling tokens with native fallbacks on older systems.
• 🔍 Safe Formatting Polyfills: High-fidelity formatters for Text (currencies, floats, percentages) that automatically choose native formatters or robust fallback formatters.
• ⚡ Zero-Change Modifier System: Call standard modifiers like .uniForegroundStyle() or .uniButtonBorderShape() safely on any target deployment platform.

---

📦 Installation

To integrate ExploreSwiftUI into your project, add the following dependency to your Package.swift:

dependencies: [
    .package(url: "https://github.com/namhoangdev31/ExploreSwiftUI.git", from: "1.0.0")
]

Or add it directly via Xcode: File > Add Packages... and search for ExploreSwiftUI.

---

🚀 Core API: Availability & Control Flow

1. Dynamic Platform Checking (isAvailable)

Instead of nesting raw platform checks, check compatibility with clean, parameter-driven runtime evaluations.

Note

isAvailable evaluates platform compatibility dynamically at runtime using ProcessInfo, returning false if the platform is mismatched, ensuring safe execution on any platform.

import ExploreSwiftUI

// 1. By Major Version
if UniPlatformVersion.isAvailable(iOS: 18, macOS: 15) {
    // Elegant modern layout logic
}

// 2. By Major & Minor Versions (using tuples)
if UniPlatformVersion.isAvailable(iOS: (16, 4), macOS: (13, 3)) {
    // Advanced sheet presentation or specific system sheets
}

2. Conditional SwiftUI Layout Modifiers (View.if)

The library exposes a highly convenient conditional layout modifier on View to safely apply styling inline without breaking the SwiftUI ViewBuilder type system.

Text("Explore SwiftUI")
    // Applies the modifier block only if the platform supports advanced sheets
    .if(UniPlatformVersion.supportsAdvancedSheetPresentation) { view in
        view.presentationDetents([.medium, .large])
    }

You can also use a dual-branch condition (then vs else):

Text("Premium Status")
    .if(
        UniPlatformVersion.supportsTabContentAPI,
        then: { $0.foregroundStyle(.blue).bold() },
        else: { $0.foregroundColor(.blue) }
    )

3. Conditional Side Effects (runIf)

Safely manage setup, configuration, or analytical code based on dynamic capability.

UniPlatformVersion.runIf(UniPlatformVersion.supportsAdvancedListAPI) {
    // Perform layout pre-caching or advanced data-fetching configurations
}

---

🎨 Major Components Showcase

1. Unified Tab Navigation (UniTabView)

One of the most complex SwiftUI challenges is bridging iOS 18+'s new TabContent API (which uses non-View protocols) with legacy TabView structures. ExploreSwiftUI resolves this using a Polymorphic DSL descriptor pattern.

@State private var selectedTab = 0

UniTabView(selection: $selectedTab) {
    UniTab("Today", systemImage: "sparkles", value: 0) {
        HomeView()
    }
    
    UniTab("Search", systemImage: "magnifyingglass", value: 1, role: .search) {
        SearchView()
    }
    
    UniTabSection("Account") {
        UniTab("Profile", systemImage: "person.crop.circle", value: 2) {
            ProfileView()
        }
        UniTab("Settings", systemImage: "gearshape", value: 3) {
            SettingsView()
        }
    }
}

• On iOS 18+ / macOS 15+: Compiled natively using the new Tab and TabSection containers.
• On iOS 15-17: Seamlessly degraded into a standard TabView with .tabItem and .tag modifiers.

2. Uni Buttons (UniButton)

The standard Button API varies widely across OS versions. UniButton abstracts roles, styling sizes, and border shapes dynamically.

UniButton("Delete Record", role: .destructive, action: deleteItem)
    .uniButtonStyle(.glassProminent)     // Renders Glass style on iOS 26+, fallbacks to Bordered on older systems
    .uniButtonSizing(.flexible)          // Fills width on older platforms using elegant framing polyfills
    .uniButtonBorderShape(.capsule)      // Gracefully falls back if shapes aren't natively supported

3. Content Unavailable Placeholders (UniContentUnavailableView)

Provide modern empty-state layouts natively supported on newer systems, with high-fidelity fallbacks on older platforms.

UniContentUnavailableView(
    "No Active Trades",
    systemImage: "chart.line.downtrend.xyaxis",
    description: "Please check your algorithm setup or explore active market connections to proceed."
) {
    UniButton("Start New Strategy", action: startStrategy)
}

4. High-Fidelity Text Formatters (UniText)

Display numbers, percentages, and currencies reliably on any operating system without dealing with localized formatters manually.

// Automatically parses double value to localized currency output safely
UniText(1250.75, format: .currency(code: "USD"))
    .uniTracking(0.5) // Gracefully applies kerning/tracking inline safely

5. Unified Navigation (UniNavigationStack & UniNavigationSplitView)

Apple transitioned from NavigationView to NavigationStack and NavigationSplitView. ExploreSwiftUI handles this dynamically.

// Unified Stack Navigation
UniNavigationStack {
    List(items) { item in
        UniNavigationLink(value: item) {
            Text(item.name)
        }
    }
    .uniNavigationDestination(for: Item.self) { item in
        DetailView(item: item)
    }
}

• On iOS 16+: Utilizes native high-performance NavigationStack with navigationDestination(for:destination:).
• On iOS 15: Fallbacks to NavigationView and simulates link routing via traditional NavigationLink(destination:isActive:label:) with a binded state.

6. Enhanced ScrollView Modifiers (uniScrollTargetBehavior & uniScrollPosition)

Leverage iOS 17+ ScrollView features safely on iOS 15/16.

@State private var scrollID: Int?

UniScrollView(.horizontal) {
    LazyHStack {
        ForEach(0..<100) { item in
            CardView(item).id(item)
        }
    }
}
.uniScrollTargetBehavior(.paging) // Native on iOS 17+, safely ignored on older platforms
.uniScrollPosition(id: $scrollID) // Native on iOS 17+, falls back to ScrollViewReader programmatically

7. Modern Share Sheets (UniShareLink)

Dynamically trigger sharing workflows using the latest native sheet layouts.

UniShareLink(item: URL(string: "https://apple.com")!) {
    Label("Share Article", systemImage: "square.and.arrow.up")
}

// Share text dynamically
UniShareLink(item: "Read this amazing content!") {
    Label("Share Message", systemImage: "message")
}

• On iOS 16+: Leverages standard native ShareLink.
• On iOS 15: Seamlessly triggers UIKit's UIActivityViewController inside an automatically managed hidden sheet.

8. Dynamic Symbol Animations (uniSymbolEffect)

SF Symbols 5/6 introduce dynamic motion. ExploreSwiftUI simulates these animations on older devices.

@State private var isBouncing = false

Image(systemName: "wifi")
    .uniSymbolEffect(.bounce, isActive: isBouncing) // Simulates bounce via spring scale on iOS 15-16

9. Unified Alerts & Dialogs (uniAlert & uniConfirmationDialog)

Unify the messy, ever-changing alert API syntax across iOS releases.

.uniAlert("Confirm Action", isPresented: $showAlert) {
    Button("Delete", role: .destructive) { }
    Button("Cancel", role: .cancel) { }
} message: {
    Text("This action cannot be undone.")
}

---

🛠️ Complete Uni Components Reference

Component / Modifier	Modern SwiftUI Counterpart	Fallback Behavior on Legacy Systems
UniButton	Button(role:action:)	Resolves custom destructive/close roles, caps bounds, and maps layout sizes.
UniScrollView	ScrollView	Wraps layout axes and sets up margin trackers.
UniText	Text(value, format:)	Standardizes number formatters and safely applies text tracking/kerning.
UniPicker	Picker	Correctly resolves styles (menus, segmented, wheels) based on compatibility.
UniDatePicker	DatePicker	Maps date styles cleanly.
UniProgressView	ProgressView	Standardizes progress layouts across platforms.
UniTabView	TabView + Tab (iOS 18)	Bridges TabContent down to classic .tabItem + .tag.
UniContentUnavailableView	ContentUnavailableView	Generates a high-fidelity vertically stacked fallback with standard buttons.
UniViewThatFits	ViewThatFits	Falls back to dynamic Scrolling layouts on older OS versions.
UniGlassEffectContainer	.background(.ultraThinMaterial)	Polyfills high-definition glass materials with semi-transparent tinted styling.
UniNavigationStack / UniNavigationSplitView	NavigationStack / NavigationSplitView	Falls back to traditional NavigationView and standard active links.
UniShareLink	ShareLink	Triggers UIKit's UIActivityViewController on iOS 15 or NSSharingServicePicker on macOS.
.uniScrollTargetBehavior(_:)	.scrollTargetBehavior	Gracefully ignored.
.uniScrollPosition(id:anchor:)	.scrollPosition	Leverages internal ScrollViewReader to scroll programmatically.
.uniSymbolEffect(_:isActive:)	.symbolEffect	Simulates bounce (spring scale) and pulse (opacity animations).
.uniAlert(...) / .uniConfirmationDialog(...)	.alert(...) / .confirmationDialog(...)	Wraps closure-based DSL and falls back to legacy Alert and ActionSheet types.

---

🏛️ Architecture Design Principles

ExploreSwiftUI follows a strict design paradigm to ensure maximum performance and seamless visual integration:

1. Zero Functional Side-Effects: Using an uni component will never disrupt the parent view layout, structure, or data binding hierarchy.
2. Graceful Aesthetic Degradation: When a modern effect (like glass prominent buttons or custom materials) isn't supported, the library degrades to the nearest high-fidelity native equivalent, ensuring your app always looks premium.
3. No Legacy Bloat: Fallback structures are lightweight and lazily evaluated to ensure excellent scroll performance and minimal memory footprint.

---

🧪 Testing & Verification

ExploreSwiftUI comes with a comprehensive testing suite to verify platform generation boundaries, capability configurations, and semantic contract coverages.

To run the smoke and contract tests:

swift test --disable-sandbox

---

🤝 Credits & Acknowledgements

This library and its API references are compiled and synthesized based on information and resources from ExploreSwiftUI.

---

📄 License

ExploreSwiftUI is available under the MIT License. See the LICENSE file for details.