import type{LyraEventDetailSnapshot}from'../../../internal/lyra-element.js';import{type PropertyValues,type TemplateResult}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraAppearance,LyraSize}from'../../../internal/variants.js';export type LyraAttachmentCapability='files'|'image'|'camera'|'audio';
/** The capabilities that resolve to a real file selection (as opposed to `camera`/`audio`, which
*  never touch the hidden file input -- see the class doc). */
export type LyraFileBackedCapability=Exclude<LyraAttachmentCapability,'camera'|'audio'>;export interface LyraAttachmentFilesDetail{capability:LyraFileBackedCapability;files:readonly File[];}export interface LyraAttachmentTriggerEventMap{'lr-camera-request':CustomEvent<null>;'lr-audio-request':CustomEvent<null>;'lr-files':CustomEvent<LyraEventDetailSnapshot<LyraAttachmentFilesDetail>>;blur:FocusEvent;focus:FocusEvent;}
/**
* `<lr-attachment-trigger>` — a compact attach affordance designed for a
* chat composer's start slot (see `<lr-chat-composer>`'s own `start`
* slot, which this drops straight into, though this component has no code
* dependency on it). Its shape adapts to how many attachment `capabilities`
* are configured:
*  - Exactly one capability: a single plain icon button ([part='trigger']).
*    Activating it performs that capability's action directly.
*  - More than one: a small anchored menu ([part='menu'], composed from
*    `<lr-dropdown>`/`<lr-menu>`/`<lr-menu-item>`) listing each capability as a row.
*
* Two of the four capabilities (`files`, `image`) are file-picker-backed:
* activating them opens a hidden native `<input type="file">` via a
* synthetic `.click()`, and the resulting selection is re-emitted as
* `lr-files`. `accept` is shared across both — `image` defaults it to
* `'image/*'` unless the `accept` prop overrides it, `files` always uses
* `accept` as-is (empty means "any file type", matching a bare native
* `<input type="file">` with no `accept` attribute).
*
* **`camera`/`audio` are scope-limited by design.** This component does not
* implement any camera or microphone capture UI itself — no `getUserMedia`,
* no `<input capture>` — because that's entirely a host/browser concern with
* no single right answer (a desktop web app, a mobile PWA, and a native
* wrapper all want different things here). Activating `camera` fires
* `lr-camera-request`; activating `audio` fires `lr-audio-request`. The
* host owns everything from that point on — typically opening
* `<lr-push-to-talk>` in a `<lr-overlay>`/popover for `audio`, then
* handing the resulting blob to something like `<lr-attachment-chip>`.
*
* @customElement lr-attachment-trigger
* @event lr-files - A file-backed capability's hidden file input produced a real selection.
* `detail: { capability: 'files' | 'image', files }`; `files` is a fresh readonly owner-realm
* `File[]` snapshot rather than the native input's live `FileList`.
* @event lr-camera-request - The `camera` capability was activated. No
* detail payload — see the class doc's scope note; the host implements the
* actual capture flow.
* @event lr-audio-request - The `audio` capability was activated. No
* detail payload — same request-only scope as `lr-camera-request`; the
* host implements the actual recording flow (typically `<lr-push-to-talk>`).
* @event {FocusEvent} focus - Relayed once from the active trigger button as a bubbling, composed
*   native event.
* @event {FocusEvent} blur - Relayed once from the active trigger button as a bubbling, composed
*   native event.
* @csspart trigger - The single-capability action, a composed `<lr-icon-button>` as of 16.0.0. Only
*   rendered when `capabilities.length === 1`. It still owns the accessible name, the activation
*   and the `title`; its background, radius, hover/press mixes, focus ring and hit-area floor now
*   come from `--lr-icon-button-*`, retuned by `appearance`/`size`.
* @csspart trigger__control - The single-capability action's own native `<button>`, forwarded
*   because the painted surface sits one shadow boundary deeper than `trigger`.
* @csspart menu-trigger__control - The multi-capability action's own native `<button>`, forwarded
*   for the same reason.
* @csspart menu - The `<lr-dropdown>` shell. Only rendered when `capabilities.length > 1`.
* @csspart menu-trigger - The multi-capability button slotted into `<lr-dropdown>`'s `trigger` slot. Only rendered when `capabilities.length > 1`.
* @csspart expand-icon - The disclosure chevron inside the multi-capability trigger button. Only rendered when `capabilities.length > 1`.
* @csspart hidden-input - The internal native `<input type="file">` that actually opens the OS file
*   picker. Hidden (`display: none`) by default; exposed as a part only so a consumer can override
*   that with `::part(hidden-input)` in the unlikely case their integration needs to.
*
* `accessibleLabel` supplies an accessible-name override for either trigger shape. A host
* `aria-label`, including an explicit empty value, wins over it.
* @status stable
* @since 4.0.0
*/
export declare class LyraAttachmentTrigger extends LyraElement<LyraAttachmentTriggerEventMap>{protected static readonly ownedCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];protected static readonly immutableEventDetails:readonly string[];
/** Which attachment capabilities to offer, in display order. Normalization scans at most 64
*  candidates and retains the first four unique recognized values, so duplicates and unknown
*  entries do not consume the four-capability output budget. A single retained entry renders a
*  plain button; more than one renders a menu. */
capabilities:readonly LyraAttachmentCapability[];
/** Native-file-input-style accept string (e.g. `'image/*'` or
*  `'.pdf,.docx'`), forwarded to the hidden file input for the
*  `files`/`image` capabilities — see the class doc for how each uses it. */
accept:string;
/** Accessible-name override for the semantic trigger button. */
accessibleLabel?:string;
/** Forwards to the internal trigger button(s)' native `title` attribute — a sighted mouse
*  user's hover tooltip, distinct from `accessibleLabel`'s accessible-name (`aria-label`) role.
*  Applies to both the single-capability `[part=trigger]` button and the multi-capability
*  `[part=menu-trigger]` button. Unset (the default): no `title` attribute, unchanged from
*  before this property existed. */
triggerTitle?:string;
/** Forwarded to the hidden file input's own `multiple` attribute. */
multiple:boolean;disabled:boolean;
/** How the trigger fills itself, from the library's one shared `appearance` vocabulary. The
*  default `'plain'` is exactly the treatment this component shipped before it had the property:
*  no fill, no border, quiet glyph. `'filled'`/`'filled-outlined'` tint it, `'outlined'` bounds
*  it, `'accent'` makes it the loud primary affordance in a composer's start slot. Painted
*  through the composed `<lr-icon-button>`'s own `--lr-icon-button-*` contract, so an ancestor
*  theme wrapper still wins over every tier. */
appearance:LyraAppearance;
/** Size on the library's shared six-step ladder, accepting the Web Awesome/Shoelace spellings
*  (`small`/`medium`/`large`) too so a migration stays a tag rename. The tier scales the GLYPH,
*  never the tappable box: `--lr-icon-button-size` is an accessibility floor, and the ladder's
*  tightest tiers resolve below WCAG 2.5.8's minimum, so wiring the target to it would let
*  `size="2xs"` ship an untappable control. Override `--lr-icon-button-size` to make that
*  trade-off explicitly, exactly as on a standalone `<lr-icon-button>`. */
size:LyraSize;private inputEl?;private dropdownEl?;private composedTriggerEl?;
/** The element that owns the button role in either shape. Both triggers are composed
*  `<lr-icon-button>`s, whose real control lives one shadow boundary deeper -- a host IDREF
*  relationship assigned to the icon-button host would never reach it, so project onto the
*  composed control itself (the same reason `<lr-activity-feed>` targets `<lr-virtual-list>`'s
*  `scrollContainer` rather than its host). Falls back to the host before its first render. */
private descriptionSyncGeneration;private get triggerEl();private hasSyncedDescribedByElements;private pendingCapability;private pickerGeneration;private pendingPickerGeneration;private get effectiveCapabilities();private get hasFileCapability();protected willUpdate(changed:PropertyValues<this>):void;protected updated(changed:PropertyValues<this>):void;private syncTriggerDescription;private effectiveAccept;private activateCapability;private onTriggerClick;private onMenuSelect;private onInputChange;disconnectedCallback():void;private onControlFocus;private onControlBlur;private stopInternalEvent;private primaryControl;focus(options?:FocusOptions):void;blur():void;click():void;private renderHiddenInput;private renderSingleTrigger;private renderMenu;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-attachment-trigger':LyraAttachmentTrigger;}}