engine/controller library

Classes

HintController

The single public point for controlling a tour.

HintOverlayHost

Overlay host — the contract of tour render mechanics.

Functions

classifyStepTargets(HintTour tour, Set<String> knownIds) → ({List<HintStep> deferred, List<UnknownHintTarget> typos})

Classifies a tour's steps by their target ids (HintStep.targetIds — extras included) against the registry's known ids.

Typedefs

UnknownHintTarget = ({List<String> candidates, int index, HintStep step, String typoId})

A sealed-off step: it references a targetId absent from the registry but with close candidates (distance ≤ 2) — almost certainly a typo. typoId is the offending id itself (a step may spotlight several targets — HintStep.targetIds); the step is skipped wholesale.