Package-level declarations
Types
Enables automatic click capture when passed to AutographProvider — taps anywhere in the composition are observed and reported via dev.ynagai.autograph.Tracker.track without needing trackClick on every element. Opt-in: omit it (the default) to only report explicitly instrumented elements.
The screen (and optional section) an element belongs to. Provided by TrackedScreen so that nested instrumentation — e.g. impression and click tracking — can attach screen context automatically.
Properties
The ambient ScreenContext, or null outside of a TrackedScreen.
The ambient Tracker for the composition. Provide it with AutographProvider; until then, events are dropped and a single warning is printed.
Functions
Builds the AutocaptureConfig for AutographProvider: AutographProvider(tracker, autocapture = Autocapture { eventName = "Tapped" }), or Autocapture() for the defaults.
Captures taps inside an alternate Compose root — the content of a Dialog, a Popup, a ModalBottomSheet — the way the enclosing AutographProvider captures taps in its own content (#210).
AutographElementScope overload taking a JsonObject, for scope values that aren't strings (numbers, booleans, nested objects) or that are already assembled as a JsonObject.
Attaches properties to every autocaptured tap on an element inside content.
Marks a subtree as excluded from autocapture (see AutocaptureConfig / AutographProvider). Explicit instrumentation (trackClick/trackImpression) inside the subtree is unaffected — this only stops the ambient tap observer from reporting taps here on its own.
Provides tracker to the composition via LocalTracker and wires application lifecycle events (foreground/background) into the tracker's session bookkeeping.
AutographScope overload taking a JsonObject, for scope values that aren't strings (numbers, booleans, nested objects) or that are already assembled as a JsonObject.
Attaches properties to every event emitted from content — a screen-scoped context such as the article_id on an articles/{article_id} route.
Marks the content as one unit of impression de-duplication for the keyed trackImpression overload: inside it, each key reports at most once for as long as this scope stays in the composition (#243).
Fires name on click, then invokes onClick. Screen/section from the ambient ScreenContext (see TrackedScreen) are merged into properties automatically when this element is nested inside one. The event carries kind click in its envelope metadata, and inside a TrackedScreen the screen's visit id (#242).
TrackScreenView plus ambient ScreenContext for the content — nested instrumentation inside content is attributed to this screen automatically.
Fires name the first time this element becomes visible — at least minFractionVisible of its bounds inside the viewport for at least minDurationMs — and never again for the lifetime of this composable instance, even if it later scrolls out of view and back. Built on the stable androidx.compose.ui.layout.onVisibilityChanged; that API itself re-fires on every visibility transition, so the "only once" bookkeeping happens here.
trackImpression, de-duplicated by key rather than by composable instance (#243): within one unit, an item reports at most once however often it is disposed and re-composed — which is what a lazy list does to an item scrolled out of view and back. Pass the same value as the list's own key. It must keep a stable equals / hashCode for as long as the unit lasts; it is held, not reported, so put whatever identifies the item for analysis in properties as well.
Automatically records a Screen Viewed event for every destination change of this NavController (androidx.navigation, a.k.a. navigation-compose).