@claudinho/core 0.11.0 → 0.11.1

package/README.md

@@ -1,10 +1,10 @@
 # @claudinho/core ⚽
 
 **The engine behind Claudinho: the domain model, the provider adapters (ESPN), live scores
-and standings for the competition you follow (15 supported), the bundled 2026 World Cup
+and standings for the competition you follow (16 supported), the bundled 2026 World Cup
 schedule with its knockout bracket and read-only Polymarket sidecar.** Claudinho puts live
 football in your dev environment for the competition you follow: the World Cup, the Premier
-League, LALIGA, the Champions League and 11 more. This package powers
+League, LALIGA, the Champions League and 12 more. This package powers
 [`@claudinho/cli`](https://www.npmjs.com/package/@claudinho/cli) and
 [`@claudinho/mcp`](https://www.npmjs.com/package/@claudinho/mcp).
 
@@ -23,7 +23,7 @@ npm i @claudinho/core
 - **`ProviderAdapter`**: the swappable data-vendor interface (`fetchByDate`, `fetchLive`, optional `fetchWindow`/`fetchStandings`); `EspnAdapter` included. An adapter serves exactly one competition and states it (`competition`, required); a provider that knows which season a response belongs to attaches it to the returned array (`attachFetchMeta`, read with `fetchMeta`), with the seasons its parts stated (`seasons`) and the records it left out (`omitted`). A window whose parts state two seasons is refused unless it is asked `acrossSeasons`, which three callers that merge nothing do (the live read, and off the bundled competition the dated read and the match refresh); `getNextFixtureForTeam`, `getBracket`, `getMatchesForDate`, `getLiveMatches`, `getMatchById` and `marketFixtureForTeam` say `partial` when the read behind them was not whole (`dayAttribution` and the "none read" sentences in the card builders say what that means for a day), and `verdictExtras` / `verdictNotice` / `verdictQualifiers` turn a result's verdict into a key and a sentence
 - **Static schedule**: the World Cup's 104 fixtures (groups, venues, host cities, kickoffs) bundled (the other competitions' schedules are read from the feed); query with `allFixtures`, `fixturesByDate` (groups by your timezone), `fixturesByTeam`, `fixturesByGroup`, `nextFixtureForTeam`, `groups`
 - **Live overlay**: `makeAdapter(source, { competition })`, `getMatchesForDate`, `getLiveMatches`, `mergeLive` (static base + live state, with graceful degradation). The competition is resolved once by the caller (`resolveCompetition(explicit, env, saved)`: an alias or a slug, the first present source deciding (the flag, the environment, the saved choice the caller read with `readUserConfig`); with none it answers `none`, nothing chosen, never a default; anything else is refused with the aliases; core reads no environment and no file, the caller hands them in), and said by `modeLine` and `selectionExtras`; the bundled schedule is merged only for its own competition and edition (`bundleApplies`)
-- **The supported set**: `SUPPORTED`, ONE table of the fifteen competitions (slug, alias, name, teams, kind, season name, standings shape, bracket and markets capabilities, cadence); `deriveTables(table)` builds every written view from it, and `entryOf`, `capabilitiesOf`, `competitionLabel`, `listCompetitions` take a table, so a new row reaches every consumer
+- **The supported set**: `SUPPORTED`, ONE table of the sixteen competitions (slug, alias, name, teams, kind, season name, standings shape, bracket and markets capabilities, cadence); `deriveTables(table)` builds every written view from it, and `entryOf`, `capabilitiesOf`, `competitionLabel`, `listCompetitions` take a table, so a new row reaches every consumer
 - **Standings**: `getStandings` fetches authoritative, cumulative tables from the provider (`GroupStandings`: a table has a key, `A`, `A1`, `A-B` or `LEAGUE`, and every table but a lettered group a `label`), failing closed when none is available, and saying `incomplete` when the provider sent a table that could not be read: the compatible bundled World Cup scope may return a degraded roster-at-zero, while custom competitions return empty + degraded rather than borrowing those teams; `computeStandings` derives a table from a set of matches (points / GD / GF tiebreak)
 - **Helpers**: emoji flags (`nationToFlag`), TZ-aware time (`formatKickoff`, `formatDate`, `formatTime`, `countdown`, `localDate`), location strings (`matchLocation`), localized commentary flair (`matchFlavor`, `flavorsFor` for a list with no phrase twice, `matchFlairs` for a list's flair slots, the cries included, and `matchFlair` for one line / `FlavorLevel`; the team rally cries, `rallyCryFor` / `RALLY_CRIES`, the pin deciding between two through `isPinnedSide`), validators (`isValidDate`, `isValidTimeZone`)
 - **Prediction-market signals (sidecar)**: read-only market signals kept *separate* from `Match`: the `MarketSignal` / `MarketProvider` model, the `PolymarketProvider` (public Gamma data only: no auth/trading/links; event slugs auto-derived per fixture, validation fails closed), a `FakeMarketProvider`, `makeMarketProvider`, `getMarketSignal` / `getMarketSignals`, the `isReliableMarketSignal` gate, and approved-copy formatters (`marketFavoriteText`, `marketProbabilityText`, `marketBlock`). Informational only, never betting advice.

package/dist/index.d.ts

@@ -417,7 +417,7 @@ declare function stageLabel(m: Pick<Match, 'stage' | 'group' | 'stageLabel'>): s
 declare function joinSegments(segments: readonly (string | undefined)[]): string;
 
 /**
- * The supported set, as ONE table: the fifteen competitions the product
+ * The supported set, as ONE table: the sixteen competitions the product
  * answers for, one row each, and every written fact about a competition that
  * the rest of the code reads (its teams' kind, its own kind, a league's season
  * name, its standings shape, what `bracket` and the market sidecar offer, how
@@ -483,14 +483,15 @@ interface CompetitionEntry {
     readonly cadenceYears: 1 | 2 | 4;
 }
 /**
- * The fifteen, in the order they are listed.
+ * The sixteen, in the order they are listed.
  *   - Nations: the World Cup, the Euro, the Copa America (four-yearly), the
  *     UEFA Nations League, the Concacaf Nations League (its next editions are
  *     2026/27 and 2028/29, by Concacaf's published 2026 to 2030 calendar) and
  *     the Gold Cup (two-yearly).
- *   - The five leagues, yearly. A league's season name as measured on the real
- *     feed (Oct 3, 2026); `mex.1` has none (its slugs are `torneo-apertura`,
- *     `torneo-clausura` and its play-off rounds).
+ *   - The six leagues, yearly. A league's season name as measured on the real
+ *     feed (Oct 3, 2026); `mex.1` and `uru.1` have none (their slugs are
+ *     `torneo-apertura`, `torneo-clausura` and, for `mex.1`, its play-off
+ *     rounds).
  *   - The four club cups. The Champions League's league phase reads as one
  *     table; the Concacaf Champions Cup has none (knockout from the first
  *     round); the Club World Cup is four-yearly.
@@ -521,8 +522,8 @@ interface DerivedTables {
 }
 /**
  * The views every consumer reads, derived from a table. A function of the
- * table, so a test can run it on one with a sixteenth row and see every view
- * carry it. Every view is frozen.
+ * table, so a test can run it on one with a row past the table's end and
+ * see every view carry it. Every view is frozen.
  *
  * A row that offers a bracket for any competition but the bundled one is
  * REFUSED here, at load, naming it: an offered bracket needs a knockout
@@ -2739,7 +2740,7 @@ type CompetitionKind = 'league' | 'cup' | 'friendly';
 /**
  * The teams each competition fields: the supported table's (`nation` for the
  * World Cup, the Euro, the Copa America, both Nations Leagues and the Gold
- * Cup; `club` for the five leagues and the four club cups), and the friendly
+ * Cup; `club` for the six leagues and the four club cups), and the friendly
  * competition's (`nation`). An unlisted competition fields clubs: a nations
  * competition the set does not list renders its teams by name until it is
  * written down.
@@ -2748,7 +2749,7 @@ declare const TEAM_KIND: Readonly<Record<string, TeamKind>>;
 /** The teams a competition fields; an unlisted (or absent) competition fields clubs. */
 declare function teamKind(competition: string | undefined): TeamKind;
 /**
- * Each competition's kind: the supported table's (`league`: the five leagues,
+ * Each competition's kind: the supported table's (`league`: the six leagues,
  * whose regular season the stage grammar reads as `REGULAR`; `cup`: the other
  * ten), and `friendly` for `fifa.friendly`, the one competition whose
  * `friendly` slug is the `FRIENDLY` stage.

package/dist/index.js

@@ -4220,6 +4220,7 @@ var SUPPORTED = Object.freeze(
     { slug: "ita.1", alias: "serie-a", name: "Serie A", teams: "club", kind: "league", seasonSlug: "italian-serie-a", standings: "league", bracket: "not-offered-yet", markets: "not-offered-yet", cadenceYears: 1 },
     { slug: "ger.1", alias: "bundesliga", name: "Bundesliga", teams: "club", kind: "league", seasonSlug: "german-bundesliga", standings: "league", bracket: "not-offered-yet", markets: "not-offered-yet", cadenceYears: 1 },
     { slug: "mex.1", alias: "liga-mx", name: "Liga MX", teams: "club", kind: "league", standings: "league", bracket: "not-offered-yet", markets: "not-offered-yet", cadenceYears: 1 },
+    { slug: "uru.1", alias: "liga-auf", name: "Liga AUF Uruguaya", teams: "club", kind: "league", standings: "league", bracket: "not-offered-yet", markets: "not-offered-yet", cadenceYears: 1 },
     { slug: "uefa.champions", alias: "champions-league", name: "Champions League", teams: "club", kind: "cup", standings: "league", bracket: "not-offered-yet", markets: "not-offered-yet", cadenceYears: 1 },
     { slug: "conmebol.libertadores", alias: "libertadores", name: "Libertadores", teams: "club", kind: "cup", standings: "groups", bracket: "not-offered-yet", markets: "not-offered-yet", cadenceYears: 1 },
     { slug: "concacaf.champions", alias: "concacaf-champions-cup", name: "Concacaf Champions Cup", teams: "club", kind: "cup", standings: "none", bracket: "not-offered-yet", markets: "not-offered-yet", cadenceYears: 1 },
@@ -4889,7 +4890,7 @@ function fetchMeta(result) {
 // src/adapters/espn.ts
 var ESPN_SOCCER = "https://site.api.espn.com/apis/site/v2/sports/soccer";
 var DEFAULT_COMPETITION = BUNDLED_SLUG;
-var USER_AGENT = `claudinho/${"0.11.0"} (+https://github.com/arturogarrido/claudinho)`;
+var USER_AGENT = `claudinho/${"0.11.1"} (+https://github.com/arturogarrido/claudinho)`;
 var MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
 var DEFAULT_COOLDOWN_MS = 5 * 6e4;
 var MAX_COOLDOWN_MS = 15 * 6e4;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@claudinho/core",
-  "version": "0.11.0",
-  "description": "The engine behind Claudinho: the domain model, the provider adapters (ESPN), live scores and standings for the competition you follow (15 supported), the bundled 2026 World Cup schedule with its knockout bracket and read-only Polymarket sidecar. Independent fan project. Not affiliated with FIFA, any confederation, league or club, or Anthropic.",
+  "version": "0.11.1",
+  "description": "The engine behind Claudinho: the domain model, the provider adapters (ESPN), live scores and standings for the competition you follow (16 supported), the bundled 2026 World Cup schedule with its knockout bracket and read-only Polymarket sidecar. Independent fan project. Not affiliated with FIFA, any confederation, league or club, or Anthropic.",
   "type": "module",
   "license": "MIT",
   "author": "Arturo Garrido",
@@ -60,6 +60,7 @@
     "serie-a",
     "bundesliga",
     "liga-mx",
+    "liga-auf",
     "champions-league",
     "libertadores",
     "concacaf-champions-cup",