Heroic Lands

Interface SohlTourStepConfig

A SoHL tour step: a Foundry TourStepBase plus the gating and navigation the framework adds.

interface SohlTourStepConfig {
    content: string;
    control?: string;
    drive?: TourDrive[];
    gate?: TourGate;
    id: string;
    kind?: TourStepKind;
    nav?: SohlTourNav;
    restricted?: boolean;
    selector?: string;
    spotlight?: string;
    title: string;
    tooltipDirection?: string;
}

Hierarchy (View Summary)

Properties

content control? drive? gate? id kind? nav? restricted? selector? spotlight? title tooltipDirection?

Properties

content

content: string

Raw HTML body (localization key or literal), split on newlines.

Optionalcontrol

control?: string

For a value gate: the selector (scoped to the open sheet) of the control whose value feeds the gate. Defaults to TourStepBase.selector.

Optionaldrive

drive?: TourDrive[]

Drive actions this step performs before it is shown, run in order and each awaited (see sohl.entity.tour.runDrive). Only a railroaded/driven tour uses these; a coach-and-wait step never does. Executed by SohlTour before its nav navigation, so navigation can target documents a drive created.

Optionalgate

gate?: TourGate

The gate whose predicate must pass before Next is enabled. Required for a value- or state-gated step; absent for a free step.

id

id: string

Machine-friendly id, unique within the tour.

Optionalkind

kind?: TourStepKind

The step kind. Optional: when omitted it is inferred from gate (stepKind), defaulting to a free step.

Optionalnav

nav?: SohlTourNav

Scene-setting navigation performed before the step.

Optionalrestricted

restricted?: boolean

Whether the step is GM-only.

Optionalselector

selector?: string

CSS selector of the element to highlight; centered if omitted.

Optionalspotlight

spotlight?: string

CSS selector of an element to spotlight (ring with the fade "hole") while the step's card stays centered and stable — unlike selector, which anchors the card to the target via Foundry's shared tooltip. Use this to point at an element that itself has hover-tooltips or re-renders (a sidebar tab, a directory button): the card can't be hijacked or lost because it isn't tooltip-anchored, yet the target is still clearly indicated. Ignored when selector is set.

title

title: string

Tooltip header (localization key or literal).

OptionaltooltipDirection

tooltipDirection?: string

Preferred tooltip direction relative to the target.

Settings

Member Visibility

On This Page

Properties