vlrdevapi 2.4.0__tar.gz → 2.4.1__tar.gz

vlrdevapi-2.4.1/.nvmrc

@@ -0,0 +1 @@
+26.10.0

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/.readthedocs.yaml

@@ -6,10 +6,11 @@ build:
     python: latest
   jobs:
     install:
-      - pip install zensical mkdocstrings mkdocstrings-python
+      - pip install uv
+      - uv sync --group dev
     build:
       html:
-        - cd docs-py && zensical build
+        - cd docs-py && uv run zensical build
     post_build:
       - mkdir -p $READTHEDOCS_OUTPUT/html/
       - cp --recursive docs-py/site/* $READTHEDOCS_OUTPUT/html/

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/CHANGELOG.md

@@ -5,6 +5,43 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [2.4.1] - 2026-10-17
+
+### Fixed
+
+- **Series players/stats parsing** — newer vlr.gg overview tables add a
+  dedicated `.mod-agents` cell before the stat columns. Stat cells are now
+  mapped dynamically around that column, and agents are read from the new
+  cell. This fixes `SideStats` validation errors and misaligned values
+  (rating, ACS, KDA, KAST, ADR, HS%, first kills/deaths).
+- **Series economy parsing** — the round-by-round economy grid now uses the
+  newer `.vlr-rounds.ecr` markup (`.ecr-bank`, `.ecc-c`, `.ecc-sq`). Banks,
+  spends, buy types, and round winners are read from it, with the legacy
+  `.wf-table-inset.mod-econ` table kept as a fallback.
+- **Series VODs parsing** — VODs are now read from the newer `.sm-vods`
+  module (`.sm-vod-name` labels, `a.sm-ext` links), keeping the legacy
+  `.match-vods` container as a fallback.
+- **Series game map names** — the game header now renders the duration as a
+  sibling of the map name. The map name is read from `.map-name`, so the
+  duration is no longer concatenated (e.g. `Pearl` instead of `Pearl35:48`).
+
+### Changed
+
+- **Series economy team matching** — team/abbreviation resolution is now
+  case-insensitive, so team IDs resolve for pages that render short tags.
+- **HTML parsing backend** — parsing now uses selectolax's Lexbor engine
+  (`selectolax.lexbor`) instead of the discontinued Modest engine
+  (`selectolax.parser`), which selectolax removed in 1.0. This is an internal
+  change: the public API, CSS selectors, and parsed output are unchanged.
+- **Dependencies** — raised the `selectolax` minimum to `>=1.0.0` and moved
+  `pydantic` to the 2.14 series.
+
+### Documentation
+
+- **Changelog** — this release is mirrored across `CHANGELOG.md`, the
+  ReadTheDocs changelog (`docs-py/docs/changelog.md`), and the official
+  site changelog (`official-docs/app/(home)/changelog/page.tsx`).
+
 ## [2.4.0] - 2026-08-19
 
 ### Added
@@ -279,6 +316,7 @@ The API surface, module structure, and type system are all new.
 - `aiohttp` and `asyncio` dependencies.
 - v1.x match/event/team parsing modules.
 
+[2.4.1]: https://github.com/Vanshbordia/vlrdevapi/compare/v2.4.0...v2.4.1
 [2.4.0]: https://github.com/Vanshbordia/vlrdevapi/compare/v2.3.0...v2.4.0
 [2.3.0]: https://github.com/Vanshbordia/vlrdevapi/compare/v2.2.0...v2.3.0
 [2.2.0]: https://github.com/Vanshbordia/vlrdevapi/compare/v2.1.0...v2.2.0

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vlrdevapi
-Version: 2.4.0
+Version: 2.4.1
 Summary: A Python library to scrape data from vlr.gg
 Project-URL: Homepage, https://vlrdevapi.pages.dev/
 Project-URL: Repository, https://github.com/Vanshbordia/vlrdevapi
@@ -38,11 +38,11 @@ Classifier: Topic :: Games/Entertainment
 Classifier: Topic :: Internet :: WWW/HTTP
 Requires-Python: >=3.11
 Requires-Dist: httpx>=0.28.1
-Requires-Dist: pydantic>=2.12.5
-Requires-Dist: selectolax>=0.4.7
+Requires-Dist: pydantic>=2.14.1
+Requires-Dist: selectolax>=1.0.0
 Provides-Extra: test
 Requires-Dist: pytest-cov>=7.1.0; extra == 'test'
-Requires-Dist: pytest>=8.0; extra == 'test'
+Requires-Dist: pytest>=9.1.1; extra == 'test'
 Requires-Dist: respx>=0.23.1; extra == 'test'
 Description-Content-Type: text/markdown
 

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vlrdevapi"
-version = "2.4.0"
+version = "2.4.1"
 description = "A Python library to scrape data from vlr.gg"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -22,8 +22,8 @@ classifiers = [
 ]
 dependencies = [
     "httpx>=0.28.1",
-    "pydantic>=2.12.5",
-    "selectolax>=0.4.7",
+    "pydantic>=2.14.1",
+    "selectolax>=1.0.0",
 ]
 
 [project.urls]
@@ -33,22 +33,22 @@ Documentation = "https://vlrdevapi.pages.dev/docs"
 
 [project.optional-dependencies]
 test = [
-    "pytest>=8.0",
+    "pytest>=9.1.1",
     "respx>=0.23.1",
     "pytest-cov>=7.1.0",
 ]
 
 [dependency-groups]
 dev = [
-    "ruff>=0.15.10",
-    "pytest>=8.0",
-    "tzdata>=2026.1",
-    "ty>=0.0.31",
+    "ruff>=0.17.1",
+    "pytest>=9.1.1",
+    "tzdata>=2026.5",
+    "ty>=0.0.89",
     "respx>=0.23.1",
     "pytest-cov>=7.1.0",
-    "zensical>=0.0.46",
-    "mkdocstrings>=0.28.0",
-    "mkdocstrings-python>=1.16.0",
+    "zensical>=0.0.71",
+    "mkdocstrings>=1.0.7",
+    "mkdocstrings-python>=2.0.9",
 ]
 
 [tool.pytest.ini_options]

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/scripts/check_mdx_examples.py

@@ -6,6 +6,12 @@ executes examples. An ``httpx.Client.get`` interceptor de-duplicates
 fetches within a run and can replay validation offline against HTML
 fixtures saved under ``.cache/mdx-html/`` (gitignored).
 
+Blocks may carry two markers (both stripped from rendered docs by the
+remark plugin in ``official-docs/source.config.ts``):
+
+    ``# doc-check: skip``          never execute (non-runnable demo code)
+    ``# doc-check: allow-empty``   execute, but empty output is acceptable
+
 CI/CD usage:
     python scripts/check_mdx_examples.py              # warm + offline replay
     python scripts/check_mdx_examples.py --skip-warm  # offline replay only
@@ -401,6 +407,26 @@ def has_skip_marker(code: str) -> bool:
     return any(line.strip().startswith("# doc-check: skip") for line in code.splitlines())
 
 
+def has_allow_empty_marker(code: str) -> bool:
+    """Blocks may opt out of the empty-output rule with `# doc-check: allow-empty`.
+
+    Use for examples that filter live data and can legitimately match nothing
+    on a given day. The block still runs and still fails on exceptions or
+    timeouts; only the "no output" requirement is relaxed.
+    """
+    return any(
+        line.strip().startswith("# doc-check: allow-empty")
+        for line in code.splitlines()
+    )
+
+
+def apply_allow_empty(code: str, run_ok: bool, run_msg: str) -> tuple[bool, str]:
+    """Relax an empty-output failure for blocks marked `# doc-check: allow-empty`."""
+    if not run_ok and has_allow_empty_marker(code) and "no output" in run_msg.lower():
+        return True, "(no output - allowed by marker)"
+    return run_ok, run_msg
+
+
 async def execute_blocks(
     results: list[Result],
     timeout: float,
@@ -433,6 +459,11 @@ async def execute_blocks(
         else:
             run_ok, run_msg, dur = await exec_sync(code, timeout)
 
+        # Blocks marked `# doc-check: allow-empty` may legitimately print
+        # nothing (e.g. a filtered loop over live data that matched no rows).
+        # They still fail on exceptions and timeouts.
+        run_ok, run_msg = apply_allow_empty(code, run_ok, run_msg)
+
         if record_results:
             results[i] = Result(
                 r.file, r.code, r.syntax_ok, r.syntax_error, r.imports_ok,

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/scripts/download_fixtures.py

@@ -420,7 +420,7 @@ for _sid, _sslug in SERIES_FORFEIT_NOTES:
 
 def _parse_last_page(html: str) -> int | None:
     """Parse the highest page number from vlr.gg pagination controls."""
-    from selectolax.parser import HTMLParser
+    from selectolax.lexbor import LexborHTMLParser as HTMLParser
 
     doc = HTMLParser(html)
     pagination = doc.css_first("div.action-container-pages")

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/__init__.py

@@ -54,7 +54,7 @@ if TYPE_CHECKING:
     news: NewsNamespace
     client: type[VLRClient]
 
-__version__ = "2.4.0"
+__version__ = "2.4.1"
 
 _default_client: "VLRClient | None" = None
 

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_base.py

@@ -6,7 +6,7 @@ from collections.abc import Callable
 from typing import Any
 
 import httpx
-from selectolax.parser import HTMLParser
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
 
 from vlrdevapi.fetcher import (
     BASE_URL,

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/info/parser.py

@@ -4,7 +4,8 @@ from datetime import date, datetime
 
 from vlrdevapi.commons.datetime import date_to_utc_datetime
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._event.info.models import (
     EventInfo,

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/list/parser.py

@@ -1,7 +1,8 @@
 import re
 from typing import Literal
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._event.info.models import EventPrize
 from vlrdevapi._event.list.models import (

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/matches/parser.py

@@ -2,7 +2,8 @@
 from datetime import date, tzinfo
 from zoneinfo import ZoneInfo
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._event.matches.models import (
     EventMatch,

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/stages/parser.py

@@ -4,7 +4,8 @@ import re
 from datetime import date, datetime
 from urllib.parse import parse_qs, urlparse
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._event.stages.models import EventStage, EventStages
 from vlrdevapi.exceptions import DataNotFoundError

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/standings/parser.py

@@ -1,6 +1,7 @@
 """Event standings parser."""
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._event.standings.models import StandingEntry, TeamStanding
 from vlrdevapi.commons.prizes import parse_prize_amount

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_event/teams/parser.py

@@ -1,4 +1,5 @@
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._event.teams.models import Team, TeamPlayer
 

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_matches/common.py

@@ -9,7 +9,8 @@ from typing import Any, Protocol
 from zoneinfo import ZoneInfo
 
 import httpx
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._cache import LRUCache
 from vlrdevapi._series.info.namespace import SeriesInfoNamespace

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_matches/completed/parser.py

@@ -5,7 +5,8 @@ from datetime import date, tzinfo
 from zoneinfo import ZoneInfo
 
 import httpx
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._cache import LRUCache
 from vlrdevapi._matches.common import (

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_matches/live/parser.py

@@ -5,7 +5,8 @@ from datetime import date, tzinfo
 from zoneinfo import ZoneInfo
 
 import httpx
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._cache import LRUCache
 from vlrdevapi._matches.common import (

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_matches/upcoming/parser.py

@@ -5,7 +5,8 @@ from datetime import date, tzinfo
 from zoneinfo import ZoneInfo
 
 import httpx
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._cache import LRUCache
 from vlrdevapi._matches.common import (

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_news/article/parser.py

@@ -11,7 +11,8 @@ from datetime import tzinfo
 from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit
 from zoneinfo import ZoneInfo
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._news.article.models import NewsArticle
 from vlrdevapi.commons.datetime import parse_vlr_iso_datetime

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_news/common.py

@@ -1,6 +1,6 @@
 """Shared helpers for reading pagination state from vlr.gg/news pages."""
 
-from selectolax.parser import HTMLParser
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
 
 
 def get_page_number(html: HTMLParser) -> int:

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_news/list/parser.py

@@ -8,7 +8,8 @@ controls.
 import logging
 from datetime import datetime
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._news.common import check_pagination, get_page_number
 from vlrdevapi._news.list.models import News, NewsPage

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_player/_common_parsing.py

@@ -7,7 +7,7 @@ from datetime import date, datetime, timezone
 
 from typing import TYPE_CHECKING
 
-from selectolax.parser import Node
+from selectolax.lexbor import LexborNode as Node
 
 if TYPE_CHECKING:
     from vlrdevapi._player.agents.models import AgentStats

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_player/agents/parser.py

@@ -1,4 +1,4 @@
-from selectolax.parser import HTMLParser
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
 
 from vlrdevapi._player._common_parsing import (
     _next_sibling_card,

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_player/info/parser.py

@@ -1,4 +1,4 @@
-from selectolax.parser import HTMLParser
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
 
 from vlrdevapi._player.info.models import PlayerInfo
 from vlrdevapi.commons.countries import get_country_name

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_player/matches/parser.py

@@ -2,7 +2,8 @@
 from datetime import tzinfo
 from zoneinfo import ZoneInfo
 
-from selectolax.parser import HTMLParser, Node
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
 
 from vlrdevapi._player.matches.models import MatchEntry, MatchHistoryPage, TeamInMatch
 from vlrdevapi.commons.datetime import (

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_player/profile/parser.py

@@ -1,4 +1,4 @@
-from selectolax.parser import HTMLParser
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
 
 from vlrdevapi._player._common_parsing import (
     _next_sibling_card,

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_player/teams/parser.py

@@ -1,4 +1,4 @@
-from selectolax.parser import HTMLParser
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
 
 from vlrdevapi._player._common_parsing import _next_sibling_card, _parse_team_entry
 from vlrdevapi._player.teams.models import PlayerTeams

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_series/_utils.py

@@ -1,6 +1,6 @@
 """Shared helpers for series sub-namespaces."""
 
-from selectolax.parser import HTMLParser
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
 
 from vlrdevapi.exceptions import ParsingError
 

{vlrdevapi-2.4.0 → vlrdevapi-2.4.1}/src/vlrdevapi/_series/economy/namespace.py

@@ -4,7 +4,7 @@ from datetime import tzinfo
 from zoneinfo import ZoneInfo
 
 import httpx
-from selectolax.parser import HTMLParser
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
 
 from vlrdevapi._base import SyncNamespace
 from vlrdevapi._series._utils import _extract_team_abbreviations
@@ -80,10 +80,11 @@ class SeriesEconomyNamespace:
 def _enrich_economy(result: EconomyData, html_series: HTMLParser) -> EconomyData:
     """Enrich economy data with team IDs and round winners from the series info.
 
-    Team matching first tries abbreviation-level names extracted from
-    ``.ovw-player-tag`` elements (e.g. "SEN"), then falls back to full
-    team names from the series header.  Round winners are resolved from
-    the stored ``_temp_winner`` tag set during parsing.
+    Team matching compares the parsed economy team tag against both the
+    abbreviation-level names extracted from ``.ovw-player-tag`` elements
+    (e.g. "SEN") and the full team names from the series header, using a
+    case-insensitive match.  Round winners are resolved from the stored
+    ``_temp_winner`` tag set during parsing.
 
     Args:
         result: The EconomyData to enrich.
@@ -96,14 +97,16 @@ def _enrich_economy(result: EconomyData, html_series: HTMLParser) -> EconomyData
     series_info = parse_series_info(html_series)
     team1_abbr, team2_abbr = _extract_team_abbreviations(html_series)
 
-    if team1_abbr == result.team1:
-        result.team1_id = series_info.team1.id
-    elif result.team1 and series_info.team1.name == result.team1:
+    def _normalize(value: str) -> str:
+        return (value or "").strip().casefold()
+
+    team1_keys = {_normalize(team1_abbr), _normalize(series_info.team1.name)}
+    team2_keys = {_normalize(team2_abbr), _normalize(series_info.team2.name)}
+
+    if _normalize(result.team1) in team1_keys:
         result.team1_id = series_info.team1.id
 
-    if team2_abbr == result.team2:
-        result.team2_id = series_info.team2.id
-    elif result.team2 and series_info.team2.name == result.team2:
+    if _normalize(result.team2) in team2_keys:
         result.team2_id = series_info.team2.id
 
     for round_data in result.rounds:

vlrdevapi-2.4.1/src/vlrdevapi/_series/economy/parser.py

@@ -0,0 +1,169 @@
+"""Series economy parser — extracts per-round bank and spend data."""
+
+from selectolax.lexbor import LexborHTMLParser as HTMLParser
+from selectolax.lexbor import LexborNode as Node
+
+from vlrdevapi._series._utils import resolve_game_id
+from vlrdevapi._series.economy.models import (
+    BuyType,
+    EconomyData,
+    RoundEconomyData,
+    RoundWinner,
+)
+
+# The "ecr" round grid encodes the buy level as a class on ``.ecc-sq``.
+_BUY_CLASS_MAP: dict[str, BuyType] = {
+    "mod-bp": BuyType.ECO,  # pistol round
+    "mod-b1": BuyType.SEMI_ECO,
+    "mod-b2": BuyType.SEMI_BUY,
+    "mod-b3": BuyType.FULL_BUY,
+}
+
+
+def _get_ecr_buy_type(sq: Node | None) -> BuyType:
+    """Resolve the buy type from an ``.ecc-sq`` round square's classes.
+
+    Args:
+        sq: The ``.ecc-sq`` node, or ``None``.
+
+    Returns:
+        BuyType: Corresponding enum value (defaults to eco).
+
+    """
+    if sq is None:
+        return BuyType.ECO
+    classes = (sq.attributes.get("class") or "").split()
+    for cls in classes:
+        if cls in _BUY_CLASS_MAP:
+            return _BUY_CLASS_MAP[cls]
+    return BuyType.ECO
+
+
+def _parse_spend_k(title: str | None) -> int:
+    """Parse a spend value from an ``.ecc-c`` title (e.g. ``'4.1k'``).
+
+    Args:
+        title: The title attribute text.
+
+    Returns:
+        int: Spend in credits, or ``0`` when absent/unparseable.
+
+    """
+    text = (title or "").strip().lower()
+    if not text:
+        return 0
+    multiplier = 1000 if text.endswith("k") else 1
+    if multiplier == 1000:
+        text = text[:-1]
+    try:
+        return round(float(text) * multiplier)
+    except ValueError:
+        return 0
+
+
+def _parse_bank_fig(text: str) -> float:
+    """Parse a bank figure from an ``.ecr-fig`` (in thousands).
+
+    Args:
+        text: The figure text (e.g. ``'10.3'``).
+
+    Returns:
+        float: Bank in credits, or ``0.0`` when unparseable.
+
+    """
+    try:
+        return float(text.strip()) * 1000
+    except ValueError:
+        return 0.0
+
+
+def _parse_ecr_economy(rounds_root: Node) -> EconomyData:
+    """Parse the VLR round-by-round ``.vlr-rounds.ecr`` grid.
+
+    Args:
+        rounds_root: The ``.vlr-rounds.ecr`` node.
+
+    Returns:
+        EconomyData: Parsed economy data with per-round bank, spend,
+        buy type, and winner information.
+
+    """
+    teams_col = rounds_root.css_first(".vlr-rounds-row-col.mod-teams")
+    tag_els = teams_col.css(".team .vlr-rounds-tag") if teams_col else []
+    team1 = tag_els[0].text(strip=True) if len(tag_els) > 0 else ""
+    team2 = tag_els[1].text(strip=True) if len(tag_els) > 1 else ""
+
+    economy_data = EconomyData(team1=team1, team2=team2)
+
+    round_number = 0
+    for col in rounds_root.css(".vlr-rounds-row-col"):
+        if "mod-teams" in (col.attributes.get("class") or ""):
+            continue
+
+        ecc1 = col.css_first(".ecc-c.mod-t1")
+        ecc2 = col.css_first(".ecc-c.mod-t2")
+        if ecc1 is None and ecc2 is None:
+            continue
+
+        # Unplayed rounds render empty cells (no title) — skip them.
+        if not (ecc1.attributes.get("title") if ecc1 else None) and not (
+            ecc2.attributes.get("title") if ecc2 else None
+        ):
+            continue
+
+        round_number += 1
+
+        bank1 = col.css_first(".ecr-bank.mod-t1 .ecr-fig")
+        bank2 = col.css_first(".ecr-bank.mod-t2 .ecr-fig")
+
+        sq1 = ecc1.css_first(".ecc-sq") if ecc1 else None
+        sq2 = ecc2.css_first(".ecc-sq") if ecc2 else None
+
+        winner_team = ""
+        if sq1 and "mod-win" in (sq1.attributes.get("class") or "").split():
+            winner_team = "team1"
+        elif sq2 and "mod-win" in (sq2.attributes.get("class") or "").split():
+            winner_team = "team2"
+
+        round_data = RoundEconomyData(
+            round_number=round_number,
+            bank_team1=_parse_bank_fig(bank1.text(strip=True)) if bank1 else 0.0,
+            bank_team2=_parse_bank_fig(bank2.text(strip=True)) if bank2 else 0.0,
+            spent_team1=_parse_spend_k(ecc1.attributes.get("title") if ecc1 else None),
+            spent_team2=_parse_spend_k(ecc2.attributes.get("title") if ecc2 else None),
+            winner=RoundWinner(),
+            buy_type_team1=_get_ecr_buy_type(sq1),
+            buy_type_team2=_get_ecr_buy_type(sq2),
+            is_pistol_round=round_number in (1, 13),
+        )
+        round_data._temp_winner = winner_team
+
+        economy_data.rounds.append(round_data)
+
+    return economy_data
+
+
+def parse_economy_data(html: HTMLParser, game_id: int | str = "all") -> EconomyData:
+    """Parse economy data from the series page HTML.
+
+    Args:
+        html: The selectolax HTMLParser of the series page.
+        game_id: Game number within the series (1-based), or a real VLR
+            game ID ("all" for the combined overview).
+
+    Returns:
+        EconomyData: Parsed economy data with per-round team banks and
+        spends.
+
+    """
+    gid = resolve_game_id(html, game_id)
+    game_div = html.css_first(f'.vm-stats-game[data-game-id="{gid}"]')
+    if not game_div:
+        return EconomyData()
+
+    # VLR renders the round-by-round economy grid inside the game container.
+    rounds_root = game_div.css_first(".vlr-rounds.ecr")
+    if not rounds_root:
+        return EconomyData()
+
+    return _parse_ecr_economy(rounds_root)