Skip to main content

Module validation

rusty_stack::core

Module validation

Expand description

Validation state machine governing tier transitions and UI filtering.

This module implements:

ValidationStateMachine — enforces legal transitions between validation tiers (Validated ↔ Candidate, Candidate ↔ Experimental, any → Blocked).
ValidationEntry — pairs a component ID with its current tier, defaulting to Candidate for new components.
[TierFilter] — determines visibility and preselection for UI rendering.

§Legal Transitions

Validated  ←→  Candidate  ←→  Experimental
    ↓             ↓               ↓
          Blocked (terminal)

Illegal transitions:

Experimental → Validated (must go through Candidate first)
Blocked → anything (Blocked is terminal)

§UI Filtering Rules

Tier	Visible	Preselected
Validated	Yes	Yes
Candidate	Yes	No
Experimental	No*	No
Blocked	No	No

* Experimental components are visible only with an explicit flag.

Structs§

FilteredEntries: Result of applying tier filtering to a list of entries.
TransitionError: Error returned when an illegal tier transition is attempted.
ValidationEntry: A component paired with its current validation tier.
ValidationStateMachine: State machine governing transitions between validation tiers.
VisibleEntry: A visible entry with its preselection state.

Functions§

filter_entries: Apply tier filtering to a list of validation entries.
filter_entries_with_experimental: Apply tier filtering with include_experimental flag.