Class AbilityView

constructor

• new AbilityView(raw: AbilityDSLEntry, ds: Dataset): AbilityView

  Parameters

  • raw: AbilityDSLEntry

    The full generated ability record.

  • ds: Dataset

  Returns AbilityView

Readonlyraw

id

• get id(): string

  The ability's id (ability_id in the raw record).

  Returns string

name

• get name(): string

  Returns string

phases

• get phases(): Phase[]

  Game phases this ability acts in, unioned across its phase-mappings.

  Returns Phase[]

units

• get units(): UnitView[]

  Units that list this ability in their ability_ids.

  Returns UnitView[]

describe

• describe(): string

  Generated plain-English approximation of this ability's effect + scope, rendered from the DSL by the conformance-pinned describer (translate/effect.ts). The dataset carries no rules prose; this is the displayable stand-in.

  Returns string

getBuffs

• getBuffs(
      source: BuffSource,
      context?: EngineContext,
      perspective?: TranslationPerspective,
  ): Buff[]

  Buff stack this ability contributes against context, with provenance tagged via source (the caller knows whether this ability is being read as army, detachment, unit, leader, etc.). DSL branches the buff layer can't auto-apply are dropped here; call describeBuffs if you also want the diagnostics. perspective defaults to "attacker"; pass "target" to translate the ability as a defensive buff (FNP, T/Sv stat-mods, save rerolls, incoming hit penalties).

  Parameters

  • source: BuffSource
  • Optionalcontext: EngineContext
  • perspective: TranslationPerspective = "attacker"

  Returns Buff[]

describeBuffs

• describeBuffs(
      source: BuffSource,
      context?: EngineContext,
      perspective?: TranslationPerspective,
  ): EffectTranslation

  Full DSL→Buff translation, including the unsupported list of effect fragments the buff layer can't model. The SPA renders these as warnings so users see which abilities have effects that need a manual toggle.

  Parameters

  • source: BuffSource
  • Optionalcontext: EngineContext
  • perspective: TranslationPerspective = "attacker"

  Returns EffectTranslation