import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';export type CitationBadgeStatus='default'|'high'|'medium'|'low'|'verified'|'unverified';export interface CitationActivateDetail{sourceId:string;index:number;}export interface CitationOpenDetail{sourceId:string;index:number;href?:string;}export interface LyraCitationBadgeEventMap{'lr-citation-activate':CustomEvent<CitationActivateDetail>;'lr-citation-open':CustomEvent<CitationOpenDetail>;}
/**
* `<lr-citation-badge>` — an inline `[n]` citation marker with a hover/
* focus preview popover and confidence/verification-status coloring. Used
* for an agent response's inline citations, each carrying a `source-id`
* that matches a corresponding `<lr-source-card>` shown elsewhere on the
* page (a sibling component in this same family — this component doesn't
* import or know anything about it, only carries the id through its
* events).
*
* The default slot is *not* the badge's visible content — the badge always
* renders `[index]` — it's reserved for optional rich preview content (e.g.
* a filename + short excerpt) shown in a floating popover on hover/focus,
* positioned with `internal/positioner.js`'s `place()` the same way
* `<lr-tool-call-chip>` positions its own detail tooltip. No popover shows
* at all when the slot carries no content, and the popover never traps
* focus — it's supplementary preview content, not a modal, so Tab continues
* past the badge normally even while it happens to be visible from a mouse
* hover. When preview content exists, the button keeps a stable
* `aria-describedby` relationship to the `role="tooltip"` panel while it is
* both hidden and visible, so assistive technology can resolve the preview
* as soon as focus causes it to open.
*
* An authored host `aria-label` deliberately names only the custom-element boundary; it is not
* copied onto the internal button. Host naming does not cross the shadow boundary, so the button
* retains its localized citation/index/status name as the interactive control's own name.
*
* Two distinct signals fire from the same badge: `lr-citation-activate`
* (click, or Enter while focused — native `<button>` behavior, no listener
* needed for the Enter case) is the lightweight "jump to this source"
* signal a host wires to scrolling/highlighting the matching
* `<lr-source-card>`. `lr-citation-open` (dblclick, or Space while
* focused) is a distinct "full preview" signal — `href` in its detail is
* `undefined` when the `href` prop isn't set; the consumer decides what
* "open" means (a new tab, a dialog, etc). A double-click still fires two
* `lr-citation-activate` events (one per constituent click — standard
* browser `dblclick` behavior) in addition to the one `lr-citation-open`;
* a consumer that only cares about the richer signal on a double-click
* should ignore the paired activate events in that case.
*
* Status coloring: `verified`/`high` use the success tones (a claim that's
* been checked out, or the model is confident in). `medium`/`low` use
* warning (progressively less certain, but still a real citation).
* `unverified` uses danger — deliberately distinct from `low`: "hasn't been
* checked at all" is a different (arguably riskier) claim than "checked but
* uncertain". `default` renders as plain neutral text with no background
* tint, for citations that carry no confidence/verification signal at all.
*
* @customElement lr-citation-badge
* @slot - Rich preview/tooltip content (e.g. a filename + excerpt), shown in
* a floating popover on hover/focus. Nothing renders (no hover affordance at
* all) when this slot is empty.
* @event lr-citation-activate - The badge was activated (click, or Enter
* while focused). `detail: { sourceId, index }`.
* @event lr-citation-open - The badge's "full preview" affordance was
* triggered (dblclick, or Space while focused).
* `detail: { sourceId, index, href }`.
* @csspart base - The clickable badge (`<button>`).
* @csspart bracket - Each of the two literal `[`/`]` glyphs.
* @csspart index - The citation number.
* @csspart popover - The floating preview panel (only meaningful while open).
* @cssprop [--lr-citation-badge-accent=var(--lr-color-text-quiet)] - Text color of `base`, and its
* hover border color. Its private default follows the reflected `status`: success for
* `high`/`verified`, warning for `medium`/`low`, and danger for `unverified`; a public value wins.
* @cssprop [--lr-citation-badge-bg=transparent] - Background of `base`. Its private default follows
* `status` to the matching `-quiet` tone (`success`/`warning`/`danger`); a public value wins.
* @cssprop [--lr-citation-badge-border=transparent] - Resting border color of `base`; no `status`
* changes it, so it stays transparent unless a host overrides it.
* @cssprop [--lr-overlay-surface=var(--lr-color-surface-overlay)] - Shared floating-surface fill,
* on the anchored source-preview popover.
* @cssprop [--lr-overlay-border=var(--lr-color-border)] - Shared floating-surface edge colour, on
* the anchored source-preview popover.
* @cssprop [--lr-overlay-radius=var(--lr-radius)] - Shared floating-surface corner radius, on the
* anchored source-preview popover.
* @cssprop [--lr-overlay-shadow-anchored=var(--lr-shadow-m)] - Elevation of the anchored surface.
* @cssprop --lr-positioning-strategy - Cascading `absolute`/`fixed` override for the preview
*   popover's `fixed` default, read from computed style when it is (re)positioned. Set it once on
*   `:root`, a theme, or one clipping ancestor to change every unset citation badge beneath it; an
*   unrecognized value falls back to `fixed`.
* @status stable
* @since 4.0.0
*/
export declare class LyraCitationBadge extends LyraElement<LyraCitationBadgeEventMap>{static styles:import("lit").CSSResultGroup[];private _index;
/** The citation number shown, e.g. `3` renders as `[3]`. Renders directly as visible text (and
*  feeds `lr-citation-activate`/`lr-citation-open`'s `detail.index`), so a NaN/non-integer
*  value would be a real user-facing rendering bug — clamped to a finite, 1-indexed integer
*  (citation numbers are conventionally 1-indexed, matching this property's own default). */
get index():number;set index(value:number);
/** Confidence/verification state — drives the badge's color and (unless
*  `label` is set) part of its accessible name. */
status:CitationBadgeStatus;
/** Id of a corresponding `<lr-source-card>` elsewhere on the page —
*  echoed back verbatim in both events, never read or validated here. */
sourceId:string;
/** Optional direct link target for the citation's source. Carried into
*  `lr-citation-open`'s detail as-is; this component never navigates. */
href:string;
/** Adds source context to the accessible name while retaining the visible citation index
*  (`"Citation {index}, {label}"`). */
label:string;private popoverOpen;private buttonEl?;private popoverEl?;private readonly popoverId;private readonly slotPresence;private cleanupPositioner?;private hideTimer?;private hideTimerOwner?;private hovering;private focused;private get hasPreviewSlot();protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;disconnectedCallback():void;private get accessibleLabel();private showPreview;private clearHideTimer;private scheduleHidePreview;private hidePreviewNow;private onPointerEnter;private onPointerLeave;private onFocusIn;private onFocusOut;private onKeyDown;private onClick;private onDblClick;private emitOpen;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-citation-badge':LyraCitationBadge;}}