Components › Transparency & Disclosure › Transparency Popovers
TD02 · Transparency

Transparency Popovers

Purpose "Why did the AI do this?" — micro-explanations surfaced at the point of an AI decision, on demand.
Use when Any AI recommendation, classification, or automated decision that a user might reasonably want to understand or contest.
Do not use As a substitute for TD01 (always disclose first); popovers are on-demand detail, not primary disclosure.
Failure mode prevented Users cannot understand or contest AI decisions, eroding trust and preventing meaningful human oversight.
Example Dark Academia
Dark Academia
The Atelier
Neon Tide
The Archive
Candlelight
The Conservatory
Why did the AI do this?
Identified field type mismatch between source and target schemas
Cross-referenced against 14 similar historical pipeline configurations
Selected mapping strategy with highest historical success rate (91%)
Overview
Design rule

Explanations must be surfaced at point of decision, not buried in documentation. Users should never have to leave the interface to understand why the AI acted.

Theming API

Override these CSS custom properties to apply your own visual treatment without touching the component's behavioral contracts.

Shared semantic tokens

Token Controls
--rad-surface-card Popover background
--rad-color-approve Header label, step numbers, link color
--rad-color-text-secondary Step body text
--rad-color-text-meta Dim link color
--rad-color-focus Focus ring color
--rad-radius-card Popover border radius

Component-scoped tokens

Token Controls
--rad-popover-border Popover border
--rad-popover-footer-divider Footer rule above links

"*When you write example copy for this component, "The AI decided this because it is very smart" is not an acceptable explanation. Use specifics.*"

← Previous Disclosure Alerts Next → Bias Check Prompts

Intellectual Property

RAD is the original work of Jackie Curry. All rights reserved. No portion may be reproduced, adapted, or incorporated into any product or system without express written permission.

Permitted: citation in academic or editorial contexts with full attribution.

Licensing

© 2025 Jackie Curry. All rights reserved. Publication date: 2025.

For licensing inquiries, connect on LinkedIn →