import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraFrame}from'../../../internal/variants.js';export interface SourceCardExpandDetail{sourceId:string;expanded:boolean;}export interface SourceCardOpenDetail{sourceId:string;href?:string;}export interface LyraSourceCardEventMap{'lr-expand':CustomEvent<SourceCardExpandDetail>;'lr-open':CustomEvent<SourceCardOpenDetail>;}declare class LyraSourceCardBase extends LyraElement<LyraSourceCardEventMap>{}declare const LyraSourceCard_base:typeof LyraSourceCardBase;
/**
* `<lr-source-card>` — one citation/source entry, meant to be a direct
* light-DOM child of `<lr-source-list>` (though it renders and functions
* fine standalone). Shows a title/page heading, an always-visible `excerpt`
* slot, and an optional `full` slot revealed behind its own independent
* "Show more" toggle — unrelated to the parent `<lr-source-list>`'s own
* expand/collapse, which only ever hides/shows the *set* of cards, never a
* single card's own content.
*
* `source-id` is this card's stable identity, meant to match a
* `<lr-citation-badge>` (a sibling component) elsewhere on the page. This
* component doesn't implement any scroll-to/highlight behavior itself — that
* lives at the app level, wiring a citation badge's activation event to this
* card's `id`/`source-id`. Let the browser's default scroll behavior apply,
* or add application motion that respects reduced-motion preferences. See the
* `@example` below.
*
* @customElement lr-source-card
* @slot excerpt - A short preview. When left empty, the `excerpt` part
* collapses away entirely rather than leaving an empty gap in the card.
* @slot full - The complete source text/chunk, hidden behind the "Show
* more"/"Show less" toggle. When left empty, no toggle renders at all — a
* card with no `full` content simply has no expand affordance. Removing all
* `full`-slotted content while expanded automatically collapses it back, and
* announces that collapse through `lr-expand` like any other state change.
* @event lr-expand - The card's expanded state changed — either the per-card
* "Show more"/"Show less" toggle was activated, or all `full`-slotted content
* was removed while expanded, collapsing the card automatically.
* `detail: { sourceId, expanded }`.
* @event lr-open - The title was activated. `detail: { sourceId, href }` —
* `href` may be `undefined`. This component never navigates on its own
* (staying a controlled component, the same convention
* `<lr-tool-call-chip>`'s `lr-tool-call-chip-select` follows); a listener
* decides what "open" means (open `href` in a new tab, open an in-app
* viewer, etc).
* @csspart base - The outer container.
* @csspart title - The clickable title/page heading (`<button>`).
* @csspart excerpt - The wrapper around the `excerpt` slot, `hidden` when the slot has no assigned content.
* @csspart full - The wrapper around the `full` slot, `hidden` while collapsed.
* @csspart toggle - The "Show more"/"Show less" button. Only rendered when the `full` slot has content.
* @attr aria-pressed - Toggle state forwarded reactively onto the `title` button: `true`, `false`
* or `mixed`. Anything else is ignored rather than passed through, so a typo never reaches the
* accessibility tree. The `toggle` button never receives it -- it already owns `aria-expanded`
* for its own disclosure state, and two conflicting state claims on one control is worse than one.
* @attr aria-current - Current-item state forwarded reactively onto the `title` button: `page`,
* `step`, `location`, `date`, `time`, `true` or `false`.
* @cssprop [--lr-source-card-bg=var(--lr-color-surface)] - Background of the RESTING
* `frame="card"` chrome, the companion to the `compact` tier's existing padding/gap levers.
* `frame="plain"` still drops the fill entirely.
* @cssprop [--lr-source-card-compact-padding=var(--lr-space-xs)] - `[part="base"]` padding while
* `compact`.
* @cssprop [--lr-source-card-compact-gap=var(--lr-space-2xs)] - Gap between `[part="base"]`'s rows
* while `compact`.
*
* @example
* ```html
* <lr-source-list label-plural="2 sources">
*   <lr-source-card source-id="doc-1" title="annual_report.pdf" page="12">
*     <span slot="excerpt">Revenue grew 12% year over year...</span>
*     <span slot="full">Revenue grew 12% year over year, driven primarily by...</span>
*   </lr-source-card>
* </lr-source-list>
* ```
* ```js
* // Elsewhere, a <lr-citation-badge>'s activation handler can scroll to
* // and highlight the matching card -- this component needs no extra API
* // surface for that, only its existing source-id to be targeted by:
* document.addEventListener('lr-citation-activate', (e) => {
*   const card = document.querySelector(`lr-source-card[source-id="${e.detail.sourceId}"]`);
*   card?.scrollIntoView({ block: 'center' });
*   card?.classList.add('is-highlighted'); // consumer-defined CSS, e.g. a brief background flash
*   setTimeout(() => card?.classList.remove('is-highlighted'), 2000);
* });
* ```
* @status stable
* @since 4.0.0
*/
export declare class LyraSourceCard extends LyraSourceCard_base{static styles:import("lit").CSSResultGroup[];
/** Stable identifier matching a `<lr-citation-badge>` elsewhere on the page. */
sourceId:string;
/** The source's display title, e.g. a filename. Rendered only as the
*  title button's own text -- a bare host-level `title` attribute (the
*  browser's global tooltip attribute) is actively stripped once Lit has
*  synced it into this property, so the card never grows an unsolicited
*  native tooltip repeating the same text. See `StripHostTitleAttribute`
*  (`internal/strip-host-title.ts`). */
title:string;
/** Optional page reference, e.g. `12` or `"iv"` — rendered as-is (never
*  parsed/validated as a number), so a non-numeric page label works too. */
page?:string|number;
/** Optional URL, echoed back (unopened) in `lr-open`'s detail. */
href?:string;
/** Tighter root padding and row gap, for the dense citation lists these cards usually render in
*  -- same convention as `lr-empty`'s `compact`. Defaults to `false`, i.e. the full card
*  padding. Purely a density knob: the border and background stay, so use `frame="plain"`
*  to drop the chrome entirely. */
compact:boolean;
/** Turns off this card's OWN controls: the `title` button and the "Show more"/"Show less"
*  `toggle` both render `disabled`, so neither one can emit `lr-open` or `lr-expand` and neither
*  remains in the tab order, and the card paints at `--lr-opacity-disabled` with a
*  `not-allowed` cursor on both. The one `lr-expand` a disabled card can still emit is the
*  automatic collapse when the `full` slot empties while expanded -- that reports a state change
*  the card genuinely made, exactly as it does when enabled, and swallowing it would desync a
*  host tracking expansion off the event stream.
*
*  Every self-rendered sub-control is gated, not just the primary one: a card whose title is
*  inert but whose disclosure toggle still expands reads as half-broken rather than disabled.
*  Slotted `excerpt`/`full` content stays the consumer's own -- a card is a container, and
*  silently disabling somebody else's controls is not a state this component can honestly own.
*
*  Like `<lr-icon-button>`, this component is not form-associated, so an ancestor
*  `<fieldset disabled>` does not cascade here -- disable each card explicitly. */
disabled:boolean;private triggerPressed;private triggerCurrent;
/** Container treatment, in the shared `LyraFrame` vocabulary. `'card'` (the default) keeps the
*  bordered, filled, padded box. `'plain'` removes the border, background, padding and corner
*  radius, so a card inside a `<lr-source-list>` (or any container already drawing its own
*  border/dividers) doesn't double the frame. `plain` wins over `compact` when both are set
*  (nothing left to tighten); the title and toggle keep their brand color and hover underline,
*  which never depended on the card chrome. */
frame:LyraFrame;private hasFullSlot;private hasExcerptSlot;private fullExpanded;private readonly fullId;protected willUpdate(changed:PropertyValues):void;firstUpdated(changed:PropertyValues):void;private onFullSlotChange;private onExcerptSlotChange;private get titleText();private onTitleClick;private toggleFull;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-source-card':LyraSourceCard;}}export{};