Understanding The Analysis View

Understanding the Analysis View

Overview

The analysis view (src/pages/logs/view/analysis/) is the log viewer's Warcraft-Logs-style reader for one saved encounter. Its whole state is a URL, and one rule generates the UI:

Three dimensions — source, ability, target — can each be pinned. The view groups its rows by the first dimension nobody has pinned. Clicking a row pins that dimension, which advances the grouping to the next free one. That is "drilling in".

Everything else — which chart is drawn, which columns the table has, which hover card explains a row, which filters are offered — is declared per metric in machine/capabilities.ts and resolved by machine/resolve.ts. The view file itself decides almost nothing.

AnalysisView.tsx is the frame; the bodies below it swap. Use this skill's vocabulary verbatim when talking to the developer — the terms below are the ones the UI, the code and the developer all use.

Vocabulary

The three axes

• Dimension — one of source, ability, target. The only three axes there are (machine/state.ts, DIMENSIONS).
• Pin — a dimension fixed to one value. Pins live in the URL (src, abil, tgt), and are set by clicking a row or choosing from a selector. "Pin the source", "clear the ability pin".
• Source — the acting end of an event, and the view's top-level "who is this page about". Its selector is the actor bar, the topmost row, above the side toggle and the metric tabs. A value is an actor index in the current side's source universe: a player index on the friendly side, an enemy spawn segment on the enemy side (universeOf). On the buff/debuff tabs the friendly side reads Source as the effect's holder, and the enemy side reads it as the caster (narrowedByPins).
• Target — the receiving end. At most ONE (WCL's target axis), selected in the pin bar below the metric tabs. On the friendly side a target is an enemy spawn, never an actor id: the game reissues a dead boss's actor index to the next spawn, so an id-keyed pin fuses two enemies.
• Ability — one axis carrying three grammars, all in abil:
  • a friendly ability row key (skill:…, possibly a skill-group key ending @<child>),
  • an enemy attack on the Damage Taken tab (taken: + {enemyType, actionId} JSON),
  • a status pin (status:<effect>:<cause>:<class>) on the aura tabs. isStatusPin is what tells the third apart, and half a dozen consumers branch on it.

Sides

• Hostility — the Friendlies/Enemies switch (side=enemy), sitting above the metric tabs. Not a filter: it swaps which universe source and target draw from, so changing it clears both actor pins. Stun and SBA have no enemy side (their toggle is disabled, not hidden).
• Friendly / friendlies — the party. Sources are players, targets are enemy spawns.
• Enemy / enemies — on Damage Done, "what each enemy dealt to the party"; on Damage Taken, "what the party dealt to each enemy". On the aura tabs it means enemy-held effects.

Metrics (the tab row)

Six, declared in CAPABILITIES:

• Data path — which machinery produces rows: groups (the backend's GroupQuery aggregation), derived (the reconciled meter state — stun and SBA cannot be re-derived from a raw event walk), intervals (status windows). It decides far more than it looks: only the groups path gets aura filters, stacked group bands and a real "settled" moment after a fetch.
• Buffs vs Debuffs — polarity is the game's own harmful flag (isHarmful), not who holds the effect. Holder side is the hostility switch. The two axes are independent, which is why an enemy's own Bloodthirst is reachable under Buffs → Enemies rather than being misfiled as a debuff.

Drilling

• Drill / drill in — pin the dimension the table is currently grouped by, so the table descends to the next free dimension. The canonical walk on Damage Done is source → ability → target.
• Grouping (groupBy) — the dimension the rows currently ARE. Derived: the first supported, unpinned dimension in the metric's dimensionOrder; with everything pinned it falls back to the last one (the one-row terminal, never a dead view).
• Regroup / the "Done by …" strip — the tabs between the pin bar and the chart that override the derived grouping (by in the URL). Any pin clears the override, so drilling resumes advancing.
• Auto-drill — when a pin leaves the table with exactly one row, the view pins that row too and keeps going while each new table has one row (machine/useAutoDrill.ts). Armed by a pin, never standing on its own — otherwise clearing the pin it applied would instantly re-apply it.
• Terminal — the deepest table, where all supported dimensions are pinned and the lone row is the pinned reading itself.

The three bodies

The tab URL param switches the whole body below the frame. Everything above it — actor bar, side toggle, metric tabs, pin bar, regroup strip, chart, window strip, aura strips — is shared, which is why pins survive switching.

• Table view (the default; tab absent) — the metric's rows as bars with numeric columns. MetricTable.tsx.
• Timeline view (tab=timeline) — the SAME rows drawn against fight time, one lane per row. timeline/.
• Events view (tab=events) — the raw event stream, one row per event, with per-column filters and a jump-to-time box. events/.

Timeline vocabulary: a lane is a row's track; a mark is one drawn thing on it; a cast is a run of events sharing a cast identity; a lane's shape is buckets (a bar per run, ticks inside per hit), icons (same fold, carrying the ability's art) or spans (real uptime, for status rows).

Rows

• Row key — the flat player: / target: / actor: / enemy: / taken: / skill: / status: / source: grammar in rowKey.ts. One author, parsed once (rowRefOf); every surface dispatches on the parsed union. A forgotten branch does not throw — it prints the raw key ("Normal:1000") or drops the icon, which looks like missing data rather than a bug.
• Skill group — several raw actions condensed into one ability row (abilityRowKey, skillGroupFor). A group key carries its child character, because Id's own kit and his dragonform's share group names.
• Member skills — what a group row expands into. The expand caret appears only at two or more children: a one-child expansion restates its parent.
• Party slot / colorSlot — which of the four player colours a row wears; -1 means "no slot" (an enemy, a party-wide row, the SBA remainder).
• other rollup — the backend appends an other aggregate summing everything past topN (8) without removing the rows it sums. The table drops it; only the chart rolls the tail up. Never add it to a denominator.

Filters and windows

Four independent narrowings. Keep them apart in conversation:

• Window / scrub / zoom — the committed chart range, as inclusive one-second bucket indexes (from/to). Set by dragging on the chart, cleared by double-clicking it or by the ✕ in the pin bar. It narrows every fetch, every table and the uptime denominators.
• Battle windows — spans of fight time the game was in a state, from the parser (ChartWindow): SBA window (a Skybound Art performance, chains merged), Link Time window, Break window (one enemy in Break; carries that enemy's actor index). Shaded on the chart and selectable as chips in the Windows strip. Several compose by union (windows of one kind never overlap, so intersecting would resolve to nothing). Selecting also zooms the chart to the selection's hull.
• Source auras / target auras — the aura filter strips between the chart and the body, one per actor pin. Each chip is an effect that pin's actor held; ticking chips restricts the fight to the time those effects were up. Several compose by intersection ("what did we do under the whole stack"). Each entry is anchored to the pin that produced it (src: / tgt:) and dies when that pin changes or clears. Damage Done and Damage Taken only.
• Mask — the aura ∩ battle-window intersection, in wire form. One mask feeds the group query, the reparse, the uptime tables and the excluded shading, so the plot and the numbers can never disagree. undefined means "no filter"; an empty array is a real mask that admits nothing.

Chart

• Band — one stacked series (a player, an ability, an enemy). Capped at 8 (GROUP_TOP_N); the rest are marked tail and rolled up as Other, still switchable on from the legend.
• Markers — death lines and SBA cast lines drawn over the plot.
• Smoothing — the trailing moving-average window, offered on rate charts only. The SBA gauge is a level, not a rate, so smoothing is pinned off there — averaging would round off the discharge that is the reading.
• Stacks — the aura tabs' overlay: a pinned effect's per-holder stack depths.