37 lines
1.3 KiB
TypeScript
37 lines
1.3 KiB
TypeScript
|
/**
|
||
|
|
* EvidenceSet — an ordered group of evidence items pointed at a target.
|
||
|
|
*
|
||
|
|
* Implements `wiki/SharedContracts.md` §1 (vocabulary) and
|
||
|
|
* `wiki/ArchitectureOverview.md` §4.6.
|
||
|
|
*
|
||
|
|
* The set itself is target-shaped: it carries the `(targetType, targetId)`
|
||
|
|
* pair so the binder can answer "give me the EvidenceSet for this form
|
||
|
|
* field" in one call. `activeEvidenceItemId` is the membership of the
|
||
|
|
* set that the UI is currently focused on; cycling Tab/Shift-Tab through
|
||
|
|
* the field's chips updates it.
|
||
|
|
*/
|
||
|
|
|
||
|
|
import type { EvidenceItemId, EvidenceSetId } from "./ids";
|
||
|
|
import type { EvidenceTargetType } from "./evidence-link";
|
||
|
|
|
||
|
|
export interface EvidenceSet {
|
||
|
|
readonly id: EvidenceSetId;
|
||
|
|
readonly label?: string;
|
||
|
|
/**
|
||
|
|
* Optional target binding. Form-field sets always carry these; ad-hoc
|
||
|
|
* topical sets may leave them undefined.
|
||
|
|
*/
|
||
|
|
readonly targetType?: EvidenceTargetType;
|
||
|
|
readonly targetId?: string;
|
||
|
|
/**
|
||
|
|
* Membership in display order. The binder is free to reorder, but
|
||
|
|
* persistence preserves this order so cycling is deterministic.
|
||
|
|
*/
|
||
|
|
readonly evidenceItemIds: readonly EvidenceItemId[];
|
||
|
|
/**
|
||
|
|
* The currently active member, or undefined if the set is empty or
|
||
|
|
* no member is yet focused.
|
||
|
|
*/
|
||
|
|
readonly activeEvidenceItemId?: EvidenceItemId;
|
||
|
|
}
|