import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type PropertyDeclaration,type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraTextWrap}from'../../../internal/shared-unions.js';import type{LyraToolbarAction}from'../message-actions/toolbar-actions.js';export interface MessageFeedbackReason{readonly id:string;readonly label:string;}export type MessageFeedbackRating='up'|'down';export type MessageFeedbackValue=MessageFeedbackRating|null;export type MessageFeedbackDetailFor='none'|'up'|'down'|'both';export interface MessageFeedbackDetailConfiguration{readonly reasons?:readonly MessageFeedbackReason[];readonly commentable?:boolean;}
/** Native `<textarea wrap>` values accepted by the optional comment field. */
export type MessageFeedbackWrap=LyraTextWrap;export interface MessageFeedbackSubmitDetail{rating:MessageFeedbackValue;reasonIds:string[];comment:string;
/** Opaque, nonblank correlation identity for this one feedback persistence transaction. */
readonly submissionId:string;}export interface LyraMessageFeedbackEventMap{'lr-feedback-change':CustomEvent<{rating:MessageFeedbackValue;}>;'lr-feedback-submit':CustomEvent<LyraEventDetailSnapshot<MessageFeedbackSubmitDetail>>;'lr-toolbar-actions-change':Event;blur:CustomEvent<null>;focus:CustomEvent<null>;}
/**
* `<lr-message-feedback>` — thumbs up/down for one assistant message, with an optional inline
* detail step (categorical reason chips + a free-text comment) that opens as a disclosure directly
* below the thumbs. `rating` is the current presentation state; every terminal persistence request
* uses the same cancelable `lr-feedback-submit` transaction.
*
* Activating the pressed thumb while its detail panel is open toggles it off to `null` (mirrors
* `<lr-rating>`'s re-activate-to-clear contract). If that applicable panel was closed without
* changing the rating (for example with Escape), activating the still-pressed thumb reopens it with
* the surviving draft. A thumbs-only configuration (no `detail`, e.g.
* `<lr-message-actions>`'s embedded built-in) never has a panel to reopen, so its thumbs always
* behave as a plain toggle.
* The detail record and its reasons are a bounded clone-owned readonly snapshot. Create and
* reassign a new detail record after changes. When the detail record enables a comment textarea,
* its native `spellcheck`, `autocapitalize`, `autocorrect`, and `wrap` properties forward from
* this element; no textarea exists, and those values have no rendered target, otherwise.
*
* Asynchronous finalization or reversion preserves focus on an outside control. Settlement retains the existing thumb/submit fallback when focus remains within the feedback or was lost as its pending controls became disabled.
*
* @customElement lr-message-feedback
* @event lr-feedback-change - `detail: { rating }`. Fires whenever thumb interaction changes the
*   provisional rating, including clearing it to `null`.
* @event lr-feedback-submit - Frozen `detail: { rating, reasonIds, comment, submissionId }`, fired
*   immediately for a thumbs-only terminal choice or by the detail panel's submit button.
*   `submissionId` is a nonblank, never-reused transaction identity. Cancelable:
*   `preventDefault()` holds the panel in its reflected `pending` state until the host calls
*   `finalizePendingSubmit(submissionId)` after persistence succeeds or
*   `revertPendingSubmit(submissionId)` after it fails. The legacy no-argument settle form works
*   only for this instance's first never-invalidated transaction; later calls fail closed. An
*   uncanceled submit retains the synchronous close/announce/focus behavior.
* @event blur - Re-dispatched from the comment `<textarea>`'s own native `blur` -- bubbling and
*   composed (unlike the native event, which is neither), so a listener above the shadow boundary
*   can observe it. Mirrors `<lr-model-select>`'s identical re-dispatch for its own free-text
*   `<input>`.
* @event focus - Re-dispatched from the comment `<textarea>`'s own native `focus`, for the same
*   reason as `blur`.
* @event lr-toolbar-actions-change - No-detail coordination event emitted when the logical
*   toolbar actions exposed by this provider change availability or order.
* @csspart base - The root.
* @csspart thumbs - The wrapper around both thumb buttons.
* @csspart up-button - The thumbs-up toggle button.
* @csspart down-button - The thumbs-down toggle button.
* @csspart panel - The inline detail disclosure. Only rendered for a non-empty `detail`.
* @csspart reasons - The reason-chip group. Only rendered when `detail.reasons` is non-empty.
* @csspart comment - The comment `<textarea>`. Only rendered when `detail.commentable` is true.
* @csspart submit-button - The panel's submit button.
*
* @cssprop [--lr-message-feedback-up-active-color=var(--lr-color-success)] - Glyph color of the
*   pressed thumbs-up button. Not declared on `:host`, so it can be set on the element or any
*   ancestor; scoped to the pressed state, unlike overriding the shared `--lr-color-success`.
* @cssprop [--lr-message-feedback-up-active-bg=var(--lr-color-success-quiet)] - Background of the
*   pressed thumbs-up button.
* @cssprop [--lr-message-feedback-up-active-border=var(--lr-color-success)] - Border color of the
*   pressed thumbs-up button.
* @cssprop [--lr-message-feedback-down-active-color=var(--lr-color-danger)] - Glyph color of the
*   pressed thumbs-down button.
* @cssprop [--lr-message-feedback-down-active-bg=var(--lr-color-danger-quiet)] - Background of the
*   pressed thumbs-down button.
* @cssprop [--lr-message-feedback-down-active-border=var(--lr-color-danger)] - Border color of the
*   pressed thumbs-down button.
* @status stable
* @since 4.0.0
*/
export declare class LyraMessageFeedback extends LyraElement<LyraMessageFeedbackEventMap>{protected static readonly ownedCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];protected static readonly immutableEventDetails:readonly string[];
/** Current provisional or persisted rating. Host-writable for controlled restoration. */
rating:MessageFeedbackValue;
/** One clone-owned explicit detail configuration. Omit it for a thumbs-only control; reassign a
*  new record after changing its reasons. */
detail?:MessageFeedbackDetailConfiguration;
/** Which rating opens the configured detail panel. `'none'` explicitly makes even a populated
*  configuration thumbs-only; `'up'`, `'down'` (default), and `'both'` select ownership. */
detailFor:MessageFeedbackDetailFor;
/** Read-only display of a recorded rating -- both thumbs become inert. */
disabled:boolean;
/** A canceled `lr-feedback-submit` is awaiting host persistence. While true, every feedback control is
*  disabled and the open panel is busy. Resolve through `finalizePendingSubmit()` or
*  `revertPendingSubmit()`; the component sets this state automatically. */
pending:boolean;
/** Native spellcheck state for the optional comment textarea. `spellcheck="false"` parses false. */
spellcheck:boolean;
/** Native autocapitalization hint for the optional comment textarea. Empty preserves its default. */
autocapitalize:string;private autocorrectValue;
/** Native autocorrect state for the optional comment textarea. Reads are boolean; writes also
*  accept the legacy `'off'` and `'false'` string forms. */
get autocorrect():boolean;set autocorrect(next:boolean|string);
/** Native wrapping mode for the optional comment textarea. Removing `wrap` restores `'soft'`. */
wrap:MessageFeedbackWrap;private panelOpen;private selectedReasonIds;private commentDraft;private detailProjectionSource;private detailProjection;private pendingInternalRating;private submissionSequence;private submissionCount;private legacyNoArgumentSettlementInvalidated;private lifecycleGeneration;private focusGeneration;private settingPending;private dispatchingSubmission?;private pendingSubmission?;private upButtonEl?;private downButtonEl?;private submitButtonEl?;private liveRegion?;private readonly panelId;private readonly upToolbarAction;private readonly downToolbarAction;private createToolbarAction;
/** Ordered logical actions exposed to an enclosing toolbar without exposing shadow nodes.
*  A parent releases its optional lease when this provider leaves, restoring an untouched
*  authored thumb tabindex without replacing a later consumer value. */
getToolbarActions():readonly LyraToolbarAction[];
/** Focuses the thumb matching the current `rating` (the up thumb when `rating` is `null`) --
*  lets a toolbar embedding this component (e.g. `<lr-message-actions>`) treat it as one
*  arrow-key stop. */
focus(options?:FocusOptions):void;blur():void;
/** Activates the thumb matching the current rating (the up thumb when unset). */
click():void;private get detailReasons();private get detailCommentable();private get currentDetailProjection();private get hasDetailContent();private detailApplies;requestUpdate(name?:PropertyKey,oldValue?:unknown,options?:PropertyDeclaration):void;disconnectedCallback():void;adoptedCallback():void;protected willUpdate(changed:PropertyValues<this>):void;protected updated(changed:PropertyValues<this>):void;private setRatingFromInteraction;private activateThumb;private focusActiveThumb;private closePanel;private onPanelKeyDown;private toggleReason;private onCommentInput;private onCommentFocus;private onCommentBlur;private setPending;
/** Retires a transaction synchronously so a later same-turn settlement cannot affect it. */
private invalidatePendingSubmission;private isCurrentPendingSubmission;private canSettleWithoutSubmissionId;private scheduleSettlementFocus;private ownsSettlementFocus;private settlePendingSubmission;private commitSettlement;
/** Completes a live held submit. Pass its event `submissionId`; a no-argument call is retained
*  only for this instance's never-invalidated first transaction. Returns whether this call won. */
finalizePendingSubmit(submissionId?:string):boolean;
/** Reverts a live held submit to the rating preceding it. Pass its event `submissionId`; the
*  restricted legacy no-argument form follows `finalizePendingSubmit()`. Returns whether it won. */
revertPendingSubmit(submissionId?:string):boolean;private requestSubmission;private onSubmit;private renderThumb;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-message-feedback':LyraMessageFeedback;}}