List meta threats

Previous value: -"Every threat in this regulation, most used first, with its standard set; present only when `regulation` was supplied."New value: +"Every threat in this regulation, most used first — species, role, tier and usage only; present only when `regulation` was supplied. Fetch the sets you need with `get_set`, which takes several species in one call."

Removed value: -{
-  "description": "Most-played ability on the form that was led, i.e. before Mega Evolving on a Mega set.",
-  "type": "string"
-}

Removed value: -{
-  "additionalProperties": false,
-  "description": "Most-played spread, keyed by Showdown stat and scaled to the 0-252 EVs `calculate_stats` and `calculate_damage` take; only invested stats are listed, everything omitted is 0. Absent when the source published no spread for that species.",
-  "properties": {
-    "atk": {
-      "description": "Attack EVs.",
-      "type": "number"
-    },
-    "def": {
-      "description": "Defense EVs.",
-      "type": "number"
-    },
-    "hp": {
-      "description": "HP EVs.",
-      "type": "number"
-    },
-    "spa": {
-      "description": "Special Attack EVs.",
-      "type": "number"
-    },
-    "spd": {
-      "description": "Special Defense EVs.",
-      "type": "number"
-    },
-    "spe": {
-      "description": "Speed EVs.",
-      "type": "number"
-    }
-  },
-  "type": "object"
-}

Removed value: -{
-  "description": "Form the set is played as when that is not the default one, e.g. \"Arcanine-Hisui\"; absent otherwise.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Most-played held item, e.g. \"Salamencite\".",
-  "type": "string"
-}

Removed value: -{
-  "description": "Ability after Mega Evolving; absent when the set is not a Mega set.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Mega form this set evolves into, e.g. \"Salamence-Mega\"; absent when the set is not a Mega set.",
-  "type": "string"
-}

Removed value: -{
-  "description": "The four most-played moves, most played first.",
-  "items": {
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Most-played nature, e.g. \"Timid\".",
-  "type": "string"
-}

Removed value: -{
-  "description": "The usage figures this set was derived from; absent when the list carries none.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Position by usage in this list; 1 is the most used.",
-  "maximum": 9007199254740991,
-  "minimum": -9007199254740991,
-  "type": "integer"
-}

Previous value: -"Role read off the set’s ability and moves, e.g. \"Rain setter\", \"Mega Intimidate pivot\"."New value: +"Role read off the set."

Previous value: -"Base species name in Showdown spelling, e.g. \"Garchomp\"; every form collapses into it because Species Clause is per National Pokédex number."New value: +"Base species name, e.g. \"Rillaboom\"."

Previous value: -"Usage band: S is the top 5 by usage, A the next 7, B the rest of the list."New value: +"Usage band within that regulation."

Previous value: -[
-  "species",
-  "role",
-  "tier",
-  "rank",
-  "usage",
-  "item",
-  "ability",
-  "nature",
-  "moves"
-]New value: +[
+  "species",
+  "role",
+  "tier",
+  "usage"
+]

Previous value: -"Optional regulation set id, e.g. \"m-c\" (matched case- and punctuation-insensitively); omit to list every curated regulation with its threat count."New value: +"Optional regulation set id, e.g. \"m-c\" (matched case- and punctuation-insensitively); omit to list every regulation with its threat count."

Added value: +{
+  "additionalProperties": false,
+  "description": "Independent second ranking used to check the ordering; absent when the cross-check was unavailable, or when `regulation` was omitted.",
+  "properties": {
+    "dataDate": {
+      "description": "That source’s own data-revision label, which lags the regulation itself.",
+      "type": "string"
+    },
+    "source": {
+      "description": "The independent source that was compared against, e.g. \"Pikalytics\".",
+      "type": "string"
+    },
+    "top10Overlap": {
+      "description": "How many of this list’s top 10 that source also ranks in its top 10, out of 10.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "url": {
+      "description": "Where that source publishes its ranking.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "source",
+    "url",
+    "dataDate",
+    "top10Overlap"
+  ],
+  "type": "object"
+}

Previous value: -"One summary per curated regulation; present only when `regulation` was omitted."New value: +"One summary per regulation; present only when `regulation` was omitted."

Previous value: -"ISO date the list was last reviewed."New value: +"ISO date of the newest data point behind that list."

Previous value: -"Reduced projection of that regulation’s threats — species, role, and tier only; call again with `regulation`, or use `get_set`, for the full standard sets."New value: +"Reduced projection of that regulation’s threats — species, role, tier and usage only; call again with `regulation`, or use `get_set`, for the full standard sets."

Previous value: -"Short competitive role."New value: +"Role read off the set."

Previous value: -"Curated base species name, e.g. \"Incineroar\"."New value: +"Base species name, e.g. \"Rillaboom\"."

Previous value: -"Curated tier within that regulation."New value: +"Usage band within that regulation."

Added value: +{
+  "description": "Share of the sampled teams carrying this species, in percent.",
+  "type": "number"
+}

Previous value: -[
-  "species",
-  "role",
-  "tier"
-]New value: +[
+  "species",
+  "role",
+  "tier",
+  "usage"
+]

Previous value: -"Standing disclaimer for that list (editorial, not usage-derived); present only when `regulation` was supplied."New value: +"How that list was derived and what it leaves out; present only when `regulation` was supplied."

Added value: +{
+  "additionalProperties": false,
+  "description": "Size and window of the sample the list was derived from; present only when `regulation` was supplied.",
+  "properties": {
+    "minPlayers": {
+      "description": "Minimum players per tournament for inclusion.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "teams": {
+      "description": "Teams sampled.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "through": {
+      "description": "ISO date of the newest tournament in the sample.",
+      "type": "string"
+    },
+    "tournaments": {
+      "description": "Tournaments those teams came from.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "windowDays": {
+      "description": "How far back the source looked, in days.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "teams",
+    "tournaments",
+    "minPlayers",
+    "windowDays",
+    "through"
+  ],
+  "type": "object"
+}

Previous value: -"Provenance of the returned list (\"curated\"); present only when `regulation` was supplied."New value: +"Provenance of the returned list (\"usage\"); present only when `regulation` was supplied."

Previous value: -"ISO date that list was last reviewed; present only when `regulation` was supplied."New value: +"ISO date of the newest data point behind that list; present only when `regulation` was supplied."

Added value: +{
+  "description": "Every dataset behind the list, with what each one supplies; present only when `regulation` was supplied.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "Dataset name, e.g. \"Data from Limitless TCG\".",
+        "type": "string"
+      },
+      "scope": {
+        "description": "Which fields of a threat it supplies.",
+        "type": "string"
+      },
+      "url": {
+        "description": "Where that dataset is published.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "name",
+      "url",
+      "scope"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"Every curated threat in full, with its standard set; present only when `regulation` was supplied."New value: +"Every threat in this regulation, most used first, with its standard set; present only when `regulation` was supplied."

Previous value: -"Ability on the base form, i.e. before Mega Evolving."New value: +"Most-played ability on the form that was led, i.e. before Mega Evolving on a Mega set."

Previous value: -"EV spread keyed by Showdown stat; only the invested stats are listed, everything omitted is 0."New value: +"Most-played spread, keyed by Showdown stat and scaled to the 0-252 EVs `calculate_stats` and `calculate_damage` take; only invested stats are listed, everything omitted is 0. Absent when the source published no spread for that species."

Added value: +{
+  "description": "Form the set is played as when that is not the default one, e.g. \"Arcanine-Hisui\"; absent otherwise.",
+  "type": "string"
+}

Previous value: -"The set’s standard held item, e.g. \"Garchompite\"."New value: +"Most-played held item, e.g. \"Salamencite\"."

Previous value: -"Mega form this set evolves into, e.g. \"Mega Garchomp\"; absent when the set is not a Mega set."New value: +"Mega form this set evolves into, e.g. \"Salamence-Mega\"; absent when the set is not a Mega set."

Previous value: -"The four recommended moves."New value: +"The four most-played moves, most played first."

Previous value: -"Recommended nature, e.g. \"Jolly\"."New value: +"Most-played nature, e.g. \"Timid\"."

Previous value: -"Curator commentary on how the set is played; absent when the curated set has none."New value: +"The usage figures this set was derived from; absent when the list carries none."

Added value: +{
+  "description": "Position by usage in this list; 1 is the most used.",
+  "maximum": 9007199254740991,
+  "minimum": -9007199254740991,
+  "type": "integer"
+}

Previous value: -"Short competitive role, e.g. \"Mega sweeper / wallbreaker\"."New value: +"Role read off the set’s ability and moves, e.g. \"Rain setter\", \"Mega Intimidate pivot\"."

Previous value: -"Curated base species name in Showdown spelling, e.g. \"Garchomp\"."New value: +"Base species name in Showdown spelling, e.g. \"Garchomp\"; every form collapses into it because Species Clause is per National Pokédex number."

Removed value: -{
-  "description": "Recommended Tera type; absent when the curated set does not specify one.",
-  "type": "string"
-}

Previous value: -"Curated tier within the regulation: S (format-defining), A, or B — editorial, not usage data."New value: +"Usage band: S is the top 5 by usage, A the next 7, B the rest of the list."

Added value: +{
+  "description": "Share of the sampled teams carrying this species, in percent.",
+  "type": "number"
+}

Previous value: -[
-  "species",
-  "role",
-  "tier",
-  "item",
-  "ability",
-  "nature",
-  "evs",
-  "moves"
-]New value: +[
+  "species",
+  "role",
+  "tier",
+  "rank",
+  "usage",
+  "item",
+  "ability",
+  "nature",
+  "moves"
+]