Struct AreaListing 

pub struct AreaListing { /* private fields */ }

One area’s listing outcome for the multi-area planner.

The authoritative_ignoring_empty flag is the area’s completeness verdict before the empty-mirror guard (§5), which area_enumerated applies later against the final mode, so a copy-verb override that turns a Mirror area Copy re-scores an empty area correctly. It is only ever produced by area_authoritative via AreaListing::listed, so the #248 filter-loss guard cannot be bypassed by an out-of-band value.

Implementations

impl AreaListing

pub fn listed( kind: AreaKind, mode: SourceMode, clips: Vec<Clip>, complete: bool, any_filtered: bool, narrowed: bool, ) -> Self

A drained listing. The authority flag is computed from the raw listing signals via area_authoritative, so the #248 guard is unbypassable from outside the crate: the fields are private, and although in-crate tests may construct directly, every production path goes through this constructor.

pub fn failed(kind: AreaKind, mode: SourceMode) -> Self

A failed or empty listing: it holds no clips and is never authoritative, so it suppresses deletion without ever vanishing from the sources (§6).

pub fn unresolved_playlist(mode: SourceMode) -> Self

A playlist area whose listing could not be resolved or fetched (§6).

pub fn clips(&self) -> &[Clip]

The area’s downloadable clips.