registerAutographIgnoredView

Excludes view and everything under it from native tap autocapture — the counterpart of Compose's Modifier.autographIgnore(). This is a privacy control: a tap whose hit path crosses view is not reported at all, so a screen can keep something off the analytics stream without stripping its accessibilityIdentifier (which UI testing and assistive tooling rely on).

Takes a UIView, so it covers what native capture actually reports: UIKit content, including UIKit hosted inside a SwiftUI layout. A pure SwiftUI element is never autocaptured (#191), so there is nothing to exclude there and no view to hand this anyway — use .autographIgnore(), which excludes by window region, when a SwiftUI subtree hosts UIKit you want kept out of the stream.

Only ambient autocapture is suppressed. Explicit instrumentation is unaffected — a trackClick you call yourself inside the subtree still fires.

Registrations nest and are ref-counted: registering the same view twice keeps it excluded until both registrations are released, so overlapping owners can't disarm each other. Keep the returned AutographIgnoredViewRegistration and call AutographIgnoredViewRegistration.unregister to stop excluding the view (e.g. when it leaves the screen). Dropping the registration without unregistering does not end the exclusion: collecting it only releases its strong reference to the view, so the view stays excluded until either AutographIgnoredViewRegistration.unregister runs or the view itself deallocates. Hold the registration and unregister it explicitly for exactly as long as the exclusion should last.

A genuinely supported API (unlike the @AutographInternalApi internals): reachable from UIKit through the umbrella Autograph framework without importing the SwiftUI AutographUI product.

Main thread only.