pivotick - v2.0.1
    Preparing search index...

    Interface PivotCandidateSet

    One fetch's worth of candidates, held for triage. There is at most one set per pivot id: a re-run replaces it.

    interface PivotCandidateSet {
        carried?: RawEdge[];
        deduped: number;
        edges: PivotCandidateEdge[];
        error?: unknown;
        fetched: number;
        label: string;
        loading: boolean;
        narrowing: PivotNarrowing;
        nodes: PivotCandidate[];
        origin: Node[];
        pending?: PivotCandidateSet;
        pivotId: string;
        provisional?: boolean;
        refused?: PivotRefusal;
        runId: string;
        suppressed: number;
    }
    Index

    Properties

    carried?: RawEdge[]

    Edges that are not rows: they follow their endpoints and land iff both ends end up on canvas. Not shown in triage — an edge to a node the analyst did not take is not a decision of its own.

    deduped: number

    How many of them are already on canvas.

    Edge-only results: both endpoints already on canvas, so they are rows of their own.

    error?: unknown

    Set when fetch rejected — the pane offers a retry.

    fetched: number

    How many nodes the provider returned, before dedup or suppression.

    label: string
    loading: boolean

    True while fetch is in flight.

    narrowing: PivotNarrowing

    The narrowing this set was fetched with.

    origin: Node[]

    The nodes the pivot was run on. Empty for an origin-less pivot.

    A re-run of this pivot, waiting rather than replacing: it landed while rows were marked, and throwing the analyst's triage away unasked is not a swap the library gets to make. The surface announces it and offers both ways out — PivotManagerLike.showPending and PivotManagerLike.dismissPending.

    A re-run with nothing marked replaces outright, and never lands here.

    pivotId: string
    provisional?: boolean

    The run might still land without triage, so nothing here has been offered yet. The set exists from the moment fetch starts — that is what makes the run watchable and cancellable — but a surface must not put a provisional set in front of the analyst: it is about to disappear onto the canvas, and taking the screen to say so costs more than the result it is announcing.

    Cleared the moment the run turns out to need triage, which is the surface's cue to come forward. A run that was always going to stage is never provisional.

    refused?: PivotRefusal

    Set when the provider blew through the absolute ceiling. Nothing was staged.

    runId: string

    The id this set's first ingest will be recorded under.

    suppressed: number

    How many were dropped because they were explicitly rejected earlier this session.