import{type TemplateResult,type PropertyValues}from'lit';import{LyraElement}from'../../../internal/lyra-element.js';import type{LyraFrame}from'../../../internal/variants.js';import{type LyraHeadingLevel}from'../../../internal/heading-level.js';
/** A plan step's lifecycle state — not permission-gated, so there is no `denied` state here
*  (unlike `<lr-tool-call-chip>`'s status vocabulary, which does need one). */
export type TaskStatus='pending'|'running'|'success'|'error';
/** Visual chrome for `<lr-task-list>`'s root — the library's shared container-frame vocabulary. */
export type TaskListAppearance=LyraFrame;export interface TaskItem{
/** Unique among every top-level task and direct child while `reorderable`; duplicated data stays
*  visible but fails closed for reorder requests. */
id:string;label:string;status:TaskStatus;
/** Optional secondary plain-text line, e.g. an error message or a short progress note. */
detail?:string;
/** One level of sub-steps. Deeper nesting (a child's own `children`) is ignored. */
children?:readonly TaskItem[];}export interface TaskListToggleDetail{expanded:boolean;}export interface LyraTaskListEventMap{'lr-toggle':CustomEvent<TaskListToggleDetail>;'lr-reorder':CustomEvent<{taskId:string;parentTaskId:string|null;fromIndex:number;toIndex:number;}>;}
/** `true`-defaulting boolean attribute converter -- Lit's default presence-based `type: Boolean`
*  can never be set back to `false` from a plain-HTML attribute once the property's own default is
*  `true` (removing an attribute that was never present fires no `attributeChangedCallback`), so
*  `fromAttribute` checks the literal string instead (mirrors `lr-generation-metrics`'s
*  `showStopConverter`). Unlike that converter, `toAttribute` here reflects the `true` state as a
*  present attribute rather than omitting it: `expanded`'s host attribute drives this component's
*  own `:host([expanded])` styling, so the attribute must actually be present while expanded and
*  absent while collapsed for that selector to work. Shared by both `expanded` and `collapsible`,
*  which have the identical `true`-default parsing need -- `collapsible` just isn't reflected. */
/**
* `<lr-task-list>` — a live, collapsible tracker for an agent's plan: ordered steps with
* per-step lifecycle status and one level of nested sub-steps, embedded in the transcript.
* `items` is controlled and never mutated by this component, mirroring `<lr-stepper>`'s `steps`
* contract. Unlike stepper's single-`current` navigation control, task-list has no selection and
* several steps may be `running` at once. Set `reorderable` to request sibling-scoped keyboard
* moves; the host applies the reordered `items` array. Non-record rows and rows without a nonempty
* string id are omitted. Reordering additionally requires globally unique ids among every retained
* top-level task and direct child; duplicate data stays visible but fails closed.
* The visible header is a level-three heading by default; set `heading-level` from `1`–`6` to fit
* the surrounding document outline, or `none` for a visual-only header.
* Status changes and confirmed moves are announced through an internal `<lr-live-region>`.
*
* Public collection properties take bounded, clone-owned readonly snapshots. Create a new
* collection and reassign it after changes; mutating the assigned array does not update the view.
*
* Only the first 500 top-level items are mounted into the DOM (matching the render ceiling this
* family's other bounded lists use); the header's "N of M completed" summary still counts every
* item in `items`, and reorder index math still reads full sibling order from `items` regardless
* of what is actually rendered.
*
* @customElement lr-task-list
* @slot detail-<id> - Dynamic, one per item id (e.g. `slot="detail-step-3"`). Rich detail under
*   that item's label, after its `detail` text -- typically a `<lr-tool-call-chip>` or file
*   `<lr-chip>`. Plain-HTML friendly, no render props.
* @event lr-toggle - The header was activated, expanding or collapsing the panel. `detail: {
*   expanded }`.
* @event lr-reorder - `detail: { taskId, parentTaskId, fromIndex, toIndex }` —
*   Ctrl/Cmd+ArrowUp/ArrowDown requests moving the focused task within its own sibling list
*   (`parentTaskId` is `null` for a
*   top-level task; indices are sibling-scoped). Only fired while `reorderable` with unique ids;
*   a boundary key never reparents. A move is announced only after the rendered order confirms it.
* @csspart base - The outer container.
* @csspart header - The visible header content (a `<button>` when `collapsible`, a plain wrapper
*   otherwise), inside the configurable semantic heading.
* @csspart label - The `label` text.
* @csspart summary - The visible "N of M completed" summary, counting only top-level items.
* @csspart toggle - The chevron indicator inside the header. Only rendered when `collapsible`.
* @csspart body - The list of items, `hidden` while collapsed.
* @csspart item - One item row (`role="listitem"`); carries `data-status`, `data-id`,
*   `data-depth` (`"0"` for a top-level item, `"1"` for a child), and is keyboard-focusable only
*   for valid `reorderable` data.
* @csspart status-icon - The per-item status glyph.
* @csspart item-label - The item's `label` text.
* @csspart item-detail - The item's optional `detail` text.
* @csspart item-children - The nested `role="list"` wrapper around a top-level item's children.
* @cssprop [--lr-task-list-spin=var(--lr-transition-ambient)] - Running-status icon spin
*   animation duration/timing.
* @cssprop [--lr-task-list-compact-header-padding=var(--lr-space-2xs) var(--lr-space-s)] -
*   `[part="header"]` padding while `compact`.
* @cssprop [--lr-task-list-compact-header-gap=var(--lr-space-2xs)] - Gap between `[part="header"]`'s
*   toggle/label/summary while `compact`.
* @cssprop [--lr-task-list-compact-header-font-size=var(--lr-font-size-sm)] - `[part="header"]`
*   font size while `compact`.
* @cssprop [--lr-task-list-compact-gap=var(--lr-space-2xs)] - Gap between `[part="body"]`'s item
*   rows while `compact`.
* @cssprop [--lr-task-list-compact-body-padding=var(--lr-space-2xs) var(--lr-space-s) var(--lr-space-s)] -
*   `[part="body"]` padding while `compact`.
* @cssprop [--lr-task-list-pending-color=var(--lr-color-text-quiet)] - Pending status icon color.
* @cssprop [--lr-task-list-running-color=var(--lr-color-brand)] - Running status icon color.
* @cssprop [--lr-task-list-success-color=var(--lr-color-success)] - Success status icon color.
* @cssprop [--lr-task-list-error-color=var(--lr-color-danger)] - Error status icon color.
* @cssprop [--lr-task-list-background=var(--lr-color-surface)] - Fill of the outer card
*   (`[part="base"]`) while `frame="card"`. `frame="plain"` still removes the fill entirely.
* @cssprop [--lr-task-list-border-color=var(--lr-color-border)] - Colour of the outer card's
*   border and of the header/body divider, which `frame="plain"` keeps.
* @cssprop [--lr-task-list-radius=var(--lr-radius)] - Corner radius of the outer card.
*   `frame="plain"` still squares the corners.
* @status stable
* @since 4.0.0
*/
export declare class LyraTaskList extends LyraElement<LyraTaskListEventMap>{protected static readonly ownedCollectionProperties:readonly string[];static styles:import("lit").CSSResultGroup[];
/** The plan. Controlled and never mutated by this component -- pass a new array to update it.
*  Runtime non-record rows and rows without a nonempty string id are omitted before rendering,
*  summaries, announcements, and reorder validation. */
items:readonly TaskItem[];
/** Opts into Ctrl/Cmd+ArrowUp/ArrowDown reorder requests. `items` remains host-owned: the
*  component never moves a task until the host reassigns a confirmed sibling order. All ids
*  across top-level tasks and direct children must be unique; otherwise the feature fails closed
*  with no row tab stops or `lr-reorder` requests. */
reorderable:boolean;
/** Optional header-text override. Omission localizes `taskListLabel`; any supplied string,
*  including `'Tasks'` or `''`, is rendered verbatim. */
label?:string;
/** Semantic level of the visible header. Use `none` to keep the visual header without exposing
*  it to heading navigation. Invalid untyped values use level 3. */
headingLevel:LyraHeadingLevel;
/** Whether the body (item list) is currently shown. Defaults open -- this is a progress surface,
*  not a details disclosure a reader opts into. */
expanded:boolean;
/** When `false`, the header renders as a static heading (no button, no toggle affordance) and
*  `expanded` can still be set programmatically by the host, just not toggled via the UI. */
collapsible:boolean;
/** Tighter header/body padding and item gap for dense contexts (a plan tracker nested in an
*  already-padded transcript row) -- same convention as `lr-agent-run`/`lr-source-card`'s
*  `compact`. Defaults to `false`, i.e. the full padding. Purely a density knob: the border and
*  background stay, so use `frame="plain"` instead to drop the chrome entirely. */
compact:boolean;
/** Visual chrome, in the library's shared container-frame vocabulary. `'card'` (the default)
*  keeps the bordered, filled box. `'plain'` removes `[part="base"]`'s border, background, and
*  corner radius, so a list embedded in the transcript inside a container that already draws a
*  border (an agent-run panel, a message bubble) doesn't double it. */
frame:LyraFrame;private liveRegion?;private readonly headerId;private readonly bodyId;
/** `true` until the first completed update -- gates the status-change announcements below so a
*  freshly-mounted list never announces whatever statuses its very first `items` happens to
*  carry (mirrors `<lr-chat-message>`'s identical `isMounting` gate for its own status-change
*  announcement). */
private isMounting;
/** Last-seen status per item id, one level deep (top-level items plus their direct children) --
*  diffed against the incoming `items` on every update to decide what to announce. */
private previousStatusById;private pendingReorder?;private pendingFocusId;protected willUpdate(changed:PropertyValues):void;protected updated(changed:PropertyValues):void;disconnectedCallback():void;connectedCallback():void;private flattenOneLevel;private diffAndAnnounce;private toggle;private idsAreUnique;private canReorderItems;private siblingItems;private requestReorder;
/** Only direct row key presses can request a move. This leaves Ctrl/Cmd+Arrow on slotted detail
* controls (and a nested row bubbling through its parent row) to the focused control itself. */
private onItemKeyDown;private capturePendingReorderFocus;
/** Announce only after the host's controlled refresh proves the exact sibling swap. Unrelated
* updates retain a request, while a missing or divergent sibling list rejects it. */
private confirmPendingReorder;private focusItem;private clearPendingReorder;private renderItem;render():TemplateResult;}declare global{interface HTMLElementTagNameMap{'lr-task-list':LyraTaskList;}}