chore(apple): Add docs for SwiftUI TTID/TTFD

Author: philprime

docs/platforms/apple/common/tracing/instrumentation/automatic-instrumentation.mdx

@@ -447,12 +447,6 @@ When the user interaction transaction is not finished yet, but the user makes a
 
 ## Time to Initial Display
 
-<Alert>
-
-This feature only works for UIViewControllers and not for SwiftUI.
-
-</Alert>
-
 By adding a span for a view controller when it's loaded, time to initial display (TTID) provides insight into how long it takes for your view controller to launch and draw its first UI frame. The SDK sets the span operation to `ui.load.initial-display` and the span description to the view controller's name, followed by `initial display` - for example, `MainViewController initial display`.
 
 The span starts when the view of a view controller is loaded, and there is no other view controller transaction happening at the moment. The span finishes after the view appeared on the screen. The following chart shows how time to initial display (TTID) and [time to full display (TTFD)](#time-to-full-display) correlate to transitions between activities:
@@ -461,18 +455,24 @@ The span starts when the view of a view controller is loaded, and there is no ot
 
 Since Cocoa SDK version 8.33.0, the SDK doesn't create time to initial display (TTID) and [time to full display (TTFD)](#time-to-full-display) spans for UIViewControllers presented in the background because the logic requires UI frames to be drawn.
 
-## Time to Full Display
-
 <Alert>
 
-This feature only works for UIViewControllers and not for SwiftUI.
+For SwiftUI views, see the [SwiftUI Instrumentation documentation](/platforms/apple/common/tracing/instrumentation/swiftui-instrumentation/#time-to-initial-display-and-time-to-full-display) for TTID and TTFD tracking.
 
 </Alert>
 
-By adding a span for a view controller when it's loaded, time to full display (TTFD) provides insight into how long it takes your view controller to launch and load all of its content. The span starts when the view of a view controller is loaded, and there is no other view controller transaction happening at the moment. The SDK sets the span operation to `ui.load.full-display` and the span description to the view controllers' name, followed by `full display` - for example, `MainActivity full display`.
+## Time to Full Display
+
+By adding a span for a view controller when it's loaded, time to full display (TTFD) provides insight into how long it takes your view controller to launch and load all of its content. The span starts when the view of a view controller is loaded, and there is no other view controller transaction happening at the moment. The SDK sets the span operation to `ui.load.full-display` and the span description to the view controllers' name, followed by `full display` - for example, `MainViewController full display`.
 
 Since Cocoa SDK version 8.33.0, the SDK doesn't create [time to initial display (TTID)](#time-to-initial-display) and time to full display (TTFD) spans for UIViewControllers presented in the background, because the logic requires UI frames to be drawn.
 
+<Alert>
+
+For SwiftUI views, see the [SwiftUI Instrumentation documentation](/platforms/apple/common/tracing/instrumentation/swiftui-instrumentation/#time-to-initial-display-and-time-to-full-display) for TTID and TTFD tracking.
+
+</Alert>
+
 _Time to full display is disabled by default, but you can enable it by setting:_
 
 ```swift {tabTitle:Swift}

docs/platforms/apple/common/tracing/instrumentation/swiftui-instrumentation.mdx

@@ -80,3 +80,117 @@ var body: some View {
 This is the result
 
 ![Transaction with nested traced views](./img/nested-view-transaction.png)
+
+## Time to Initial Display and Time to Full Display
+
+<Alert>
+
+This feature is available since version 8.44.0 and only works for iOS and tvOS.
+
+</Alert>
+
+You can track time to initial display (TTID) and time to full display (TTFD) for your SwiftUI views to measure how long it takes for screens to render their first frame and then fully load all content.
+
+- **Time to initial display (TTID)**: Automatically tracked when the view appears on screen. The SDK sets the span operation to `ui.load.initial-display` and the span description to the view name followed by `initial display` - for example, `Content View Body initial display`.
+
+- **Time to full display (TTFD)**: Requires enabling with the `waitForFullDisplay` parameter and manually calling `SentrySDK.reportFullyDisplayed()` when your view has finished loading all content. The SDK sets the span operation to `ui.load.full-display` and the span description to the view name followed by `full display` - for example, `Content View Body full display`.
+
+### Enabling Time to Full Display
+
+To enable TTFD tracking, set `waitForFullDisplay: true` when creating a `SentryTracedView`:
+
+```swift {tabTitle:Swift}
+
+import SentrySwiftUI
+import Sentry
+
+var body: some View {
+    SentryTracedView("Content View Body", waitForFullDisplay: true) {
+        VStack {
+            // Your SwiftUI content
+        }
+        .onAppear {
+            // Load async content, then call:
+            SentrySDK.reportFullyDisplayed()
+        }
+    }
+}
+```
+
+Alternatively, you can use the `sentryTrace` modifier with `waitForFullDisplay: true`:
+
+```swift {tabTitle:Swift}
+
+import SentrySwiftUI
+import Sentry
+
+var body: some View {
+    VStack {
+        // Your SwiftUI content
+    }
+    .sentryTrace("Content View Body", waitForFullDisplay: true)
+    .onAppear {
+        // Load async content, then call:
+        SentrySDK.reportFullyDisplayed()
+    }
+}
+```
+
+If you don't specify `waitForFullDisplay`, the SDK will use the value from the `enableTimeToFullDisplayTracing` option. You can enable TTFD globally for all views by setting this option:
+
+```swift {tabTitle:Swift}
+
+import Sentry
+
+SentrySDK.start { options in
+    options.dsn = "___PUBLIC_DSN___"
+    options.enableTimeToFullDisplayTracing = true
+}
+```
+
+### When to Call reportFullyDisplayed()
+
+Call `SentrySDK.reportFullyDisplayed()` when your view has finished loading all of its content, including any asynchronous operations like:
+
+- Network requests to fetch data
+- Image loading
+- Database queries
+- Any other async operations that affect the view's content
+
+Typically, you'll call this in the `onAppear` modifier after your async content has loaded:
+
+```swift {tabTitle:Swift}
+
+import SentrySwiftUI
+import Sentry
+
+struct ContentView: View {
+    @State private var data: [Item] = []
+
+    var body: some View {
+        SentryTracedView("Content View", waitForFullDisplay: true) {
+            List(data) { item in
+                Text(item.title)
+            }
+            .onAppear {
+                Task {
+                    // Load data asynchronously
+                    data = await loadData()
+                    // Report when fully displayed
+                    SentrySDK.reportFullyDisplayed()
+                }
+            }
+        }
+    }
+}
+```
+
+### Important Notes
+
+- **Nested views**: The `waitForFullDisplay` parameter is ignored for nested `SentryTracedView` instances. Only the root transaction (the outermost `SentryTracedView`) will track TTID and TTFD spans.
+
+- **30-second timeout**: If `reportFullyDisplayed()` is not called within 30 seconds, the TTFD span will automatically finish with `SpanStatus.DEADLINE_EXCEEDED`. The duration will match the TTID span duration, and the description will contain a `Deadline Exceeded` suffix.
+
+- **Early calls**: If `reportFullyDisplayed()` is called before the view appears, the reported time will be shifted to match the TTID measured time.
+
+For more information about TTID and TTFD metrics, see the [Mobile Vitals documentation](/product/insights/mobile/mobile-vitals/#time-to-initial-display-and-time-to-full-display).

docs/product/insights/mobile/mobile-vitals/index.mdx

@@ -90,14 +90,16 @@ In the example below, the detail view of the transaction displays the time-to-in
 You can track time to initial display for:
 
 - [Android](/platforms/android/tracing/instrumentation/automatic-instrumentation/#time-to-initial-display)
-- [Apple](/platforms/apple/tracing/instrumentation/automatic-instrumentation/#time-to-initial-display)
+- [Apple UIViewController](/platforms/apple/tracing/instrumentation/automatic-instrumentation/#time-to-initial-display)
+- [Apple SwiftUI](/platforms/apple/common/tracing/instrumentation/swiftui-instrumentation/#time-to-initial-display-and-time-to-full-display) (since 8.44.0)
 - [Flutter](/platforms/dart/guides/flutter/integrations/routing-instrumentation/#time-to-initial-display)
 - [React Native](/platforms/react-native/performance/instrumentation/time-to-display/#automatic-time-to-initial-display-for-react-navigation)
 
 You can track time to full display for:
 
 - [Android](/platforms/android/tracing/instrumentation/automatic-instrumentation/#time-to-full-display)
-- [Apple](/platforms/apple/tracing/instrumentation/automatic-instrumentation/#time-to-full-display)
+- [Apple UIViewController](/platforms/apple/tracing/instrumentation/automatic-instrumentation/#time-to-full-display)
+- [Apple SwiftUI](/platforms/apple/common/tracing/instrumentation/swiftui-instrumentation/#time-to-initial-display-and-time-to-full-display) (since 8.44.0)
 - [Flutter](/platforms/dart/guides/flutter/integrations/routing-instrumentation/#time-to-full-display)
 - [React Native](/platforms/react-native/performance/instrumentation/time-to-display/#time-to-full-display)
 

docs/product/insights/mobile/mobile-vitals/screen-loads.mdx

@@ -25,7 +25,8 @@ Sentry tracks TTID automatically, but [TTFD](/product/insights/mobile/mobile-vit
 **For iOS:**
 
 - `>=7.12.0` for UIViewController transactions
-- `>=8.4.0` for [TTID](/platforms/apple/guides/ios/tracing/instrumentation/automatic-instrumentation/#time-to-initial-display)+[TTFD](/platforms/apple/guides/ios/tracing/instrumentation/automatic-instrumentation/#time-to-full-display)
+- `>=8.4.0` for [TTID](/platforms/apple/guides/ios/tracing/instrumentation/automatic-instrumentation/#time-to-initial-display)+[TTFD](/platforms/apple/guides/ios/tracing/instrumentation/automatic-instrumentation/#time-to-full-display) for UIViewController
+- `>=8.44.0` for [TTID+TTFD for SwiftUI](/platforms/apple/common/tracing/instrumentation/swiftui-instrumentation/#time-to-initial-display-and-time-to-full-display)
 
 **For Flutter:**