@cs2dak/contract 0.2.1 → 1.1.0

package/src/player.ts

@@ -0,0 +1,107 @@
+import { z } from "zod";
+import { teamKeySchema } from "cs2-demo-format";
+import { accountContextAvailabilitySchema } from "./analysis.js";
+import { leaderboardMetricKeySchema } from "./leaderboard.js";
+
+/**
+ * 选手赛季档案。由 @cs2dak/presentation 从 SeasonCohortBundle 中单个选手派生。
+ * 产品中立：身份用 playerKey/steamIds/externalUserId，不含数据库/路由/权限语义（规则 8）。
+ * 不算评分公式；rating/style 均来自 cohort 已接线的 rival-rating 结果（规则 5）。
+ * 缺失保持 null（规则 6）；style 在 PRISM 缺失时整体为 null。
+ */
+
+export const rrBreakdownEntrySchema = z.object({
+  key: z.enum(["combat", "trade", "mapControl", "clutch", "objective", "utility"]),
+  label: z.string(),
+  value: z.number()
+});
+
+/** PRISM 单根轴的展示项：行为倾向与执行效率分离，避免把角色、频率和效果混成一个分数。 */
+export const playerStyleAxisSchema = z.object({
+  key: z.string(), // PrismAxisKey
+  label: z.string(),
+  /** 该轴在当前 cohort 内的行为参与度相对位置。 */
+  involvementPercentile: z.number().min(0).max(100).nullable(),
+  /** 该轴在当前 cohort 内的执行效率相对位置。 */
+  efficiencyPercentile: z.number().min(0).max(100).nullable(),
+  /** 上游融合值，仅供解释/导出，不再用作雷达形状。 */
+  combinedPercentile: z.number().min(0).max(100).nullable(),
+  /** 上游配置中可用信号权重占比，0–1。 */
+  signalCoverage: z.number().min(0).max(1),
+  /** 可供当前 cohort 排名的有效选手数；不足 5 人时不展示精确 P 值。 */
+  comparisonCount: z.number().int().nonnegative(),
+  status: z.enum(["ready", "partial", "unavailable", "insufficient"])
+});
+
+export const playerStyleSchema = z.object({
+  weightsVersion: z.string(),
+  /** 整体着色依据：RR 百分位（0–100）。 */
+  rrPercentile: z.number().min(0).max(100),
+  /** 八根轴，按 PRISM_AXIS_ORDER 排序。 */
+  axes: z.array(playerStyleAxisSchema)
+});
+
+export const playerSeasonTrendPointSchema = z.object({
+  matchId: z.string(),
+  rivalhubRR: z.number().nonnegative(),
+  hltvRating: z.number().nonnegative()
+});
+
+export const playerWeaponProfileEntrySchema = z.object({
+  weapon: z.string(),
+  label: z.string(),
+  kills: z.number().int().nonnegative(),
+  killSharePercent: z.number().min(0).max(100),
+  headshotPercent: z.number().min(0).max(100).nullable(),
+  tradeKillPercent: z.number().min(0).max(100).nullable(),
+  noScopePercent: z.number().min(0).max(100).nullable(),
+  throughSmokePercent: z.number().min(0).max(100).nullable(),
+  wallbangPercent: z.number().min(0).max(100).nullable(),
+  averagePenetratedObjects: z.number().nonnegative().nullable()
+});
+
+export const playerSeasonProfileSchema = z.object({
+  /** 0.2：PRISM 轴拆分为行为倾向、执行效率，并附带信号/样本可用性。 */
+  version: z.literal("cs2-demo-analysis-kit/player-profile-0.2"),
+  weightsVersion: z.string(),
+  playerKey: z.string(),
+  name: z.string(),
+  steamIds: z.array(z.string()),
+  externalUserId: z.string().nullable(),
+  teamKeys: z.array(teamKeySchema),
+  mapCount: z.number().int().positive(),
+  confidence: z.number().min(0).max(1),
+  accountContextStatus: z.object({
+    buyDelta: accountContextAvailabilitySchema,
+    manState: accountContextAvailabilitySchema
+  }),
+  rating: z.object({
+    rivalhubRR: z.number().nonnegative(),
+    rivalhubRRRaw: z.number(),
+    hltvRating: z.number().nonnegative(),
+    hltvPercentile: z.number().min(0).max(100),
+    breakdown: z.array(rrBreakdownEntrySchema)
+  }),
+  /** 与排行榜同口径的展示指标（共享 SEASON_STAT_VIEWS 渲染列）。 */
+  metrics: z.record(leaderboardMetricKeySchema, z.number().nullable()),
+  weapons: z.array(playerWeaponProfileEntrySchema),
+  highlights: z.object({
+    wallbangKills: z.number().int().nonnegative().nullable(),
+    noScopeKills: z.number().int().nonnegative().nullable(),
+    throughSmokeKills: z.number().int().nonnegative().nullable(),
+    collateralKills: z.number().int().nonnegative().nullable()
+  }),
+  style: playerStyleSchema.nullable(),
+  /** 每场 RR 趋势，按 matchId 升序。 */
+  perMatch: z.array(playerSeasonTrendPointSchema),
+  /** 相对赛季 cohort 的强项 / 弱项（按技能类指标的 cohort 百分位派生）。 */
+  strengths: z.array(z.string()),
+  weaknesses: z.array(z.string())
+});
+
+export type RRBreakdownEntry = z.infer<typeof rrBreakdownEntrySchema>;
+export type PlayerStyleAxis = z.infer<typeof playerStyleAxisSchema>;
+export type PlayerStyle = z.infer<typeof playerStyleSchema>;
+export type PlayerSeasonTrendPoint = z.infer<typeof playerSeasonTrendPointSchema>;
+export type PlayerWeaponProfileEntry = z.infer<typeof playerWeaponProfileEntrySchema>;
+export type PlayerSeasonProfile = z.infer<typeof playerSeasonProfileSchema>;

package/src/qa.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+
+export const qaIssueSchema = z.object({
+  severity: z.enum(["info", "warning", "error"]),
+  code: z.string().min(1),
+  message: z.string().min(1),
+  path: z.string().optional()
+});
+
+export const qaReportSchema = z.object({
+  ok: z.boolean(),
+  summary: z.object({
+    issueCount: z.number().int().nonnegative(),
+    errorCount: z.number().int().nonnegative(),
+    warningCount: z.number().int().nonnegative()
+  }),
+  issues: z.array(qaIssueSchema)
+});
+
+export type QaIssue = z.infer<typeof qaIssueSchema>;
+export type QaReport = z.infer<typeof qaReportSchema>;

package/src/radar-field.ts

@@ -0,0 +1,79 @@
+/**
+ * RadarField —— 雷达覆盖场合同（描述性地图控制原语）。
+ *
+ * 「基础场」逐秒 × 逐格存原始计数（不存概率、不存合成视图），因为原始计数是
+ * 加性的：合并两个 scope = 四场逐元素相加 + denom 相加。这一条承重墙撑起 per-match
+ * 缓存、scope 聚合、队伍−联赛差分、未来价值学习——全是廉价派生。
+ *
+ * 归一化（count / denom = 该秒该格被看到/占据/听到的采样占比）、信息差分（tVis−ctVis）、
+ * 对拼线（min(tVis,ctVis)）、推进波前都在渲染期合成，底层场不污染。
+ *
+ * 这是 TS 侧计算产物，不跨 Python↔TS 的 v3 ZIP seam，故用手写 interface（非 Zod）。
+ * 字段列用 Int32Array：结构化克隆（worker postMessage / IndexedDB）下紧凑且无损。
+ */
+
+/**
+ * 基础场名。
+ * Vis = 4:3 屏幕可见（矩形视锥 ∩ LOS ∩ 烟）；Aim = 准星/注意力覆盖（30°圆锥 ∩ LOS ∩ 烟）；
+ * Pres = 位置占据（最近 nav 格，无 LOS）；Sound = 在该格发声会被对面听到的风险（800u 半径）。
+ */
+export type RadarFieldBase =
+  | "ctVis" | "tVis"
+  | "ctAim" | "tAim"
+  | "ctPres" | "tPres"
+  | "ctSound" | "tSound";
+
+export const RADAR_FIELD_BASES: readonly RadarFieldBase[] = [
+  "ctVis", "tVis",
+  "ctAim", "tAim",
+  "ctPres", "tPres",
+  "ctSound", "tSound",
+] as const;
+
+export interface RadarFieldGrid {
+  /** 规则栅格边长（世界单位）。 */
+  cellSize: number;
+  /** 每格代表世界坐标 [x, y, z]（z 已含靶高），与 fields 列同序。 */
+  cells: Array<[number, number, number]>;
+}
+
+export interface RadarFieldScope {
+  /** league = 赛事/当前范围基线；team = 单队（identity 归并后的显示名）。 */
+  kind: "league" | "team";
+  team: string | null;
+  /** gun = 长枪局（双方 full/conversion）；all = 全部回合。 */
+  economy: "gun" | "all";
+  /** 贡献的回合总数（含全部采样秒之前的回合计数）。 */
+  roundCount: number;
+  matchIds: string[];
+}
+
+export interface RadarField {
+  /** 合同结构版本。 */
+  schemaVersion: number;
+  /** 算法参数指纹（锥角/采样率/格大小/眼高变了即 +1）；驱动缓存失效。 */
+  computeVersion: number;
+  mapName: string;
+  /** world→radar 标定版本；变了不可与旧场合并/差分。 */
+  calibrationVersion: string;
+  /** full = 这批 LOS 射线可信（有 .tri）；none = 只有锥+烟，无墙体遮挡，不可与 full 互比。 */
+  triAvailability: "full" | "none";
+  scope: RadarFieldScope;
+  grid: RadarFieldGrid;
+  /** 采样秒上界（一回合 1:55 = 115s）。 */
+  maxSec: number;
+  /**
+   * 归一化分母，按 source side 分。当前计算每秒采样一次：
+   * denomCt[sec] = scope 内、CT 侧、到达该秒的 side-frame 数；ct* 基础场除以它。
+   * denomT 同理给 t* 基础场。
+   */
+  denomCt: Int32Array;
+  denomT: Int32Array;
+  /** fields[base][sec] = Int32Array(cells.length) 原始计数。 */
+  fields: Record<RadarFieldBase, Int32Array[]>;
+}
+
+export const RADAR_FIELD_SCHEMA_VERSION = 1;
+
+/** 一回合 1:55 = 115s（freeze 后逐秒采样窗，含残局/换防段；已实证）。 */
+export const RADAR_FIELD_MAX_SEC = 115;

package/src/scoring.ts

@@ -0,0 +1,87 @@
+import type { RRIndicators } from "@rivalhub/rival-rating";
+import { z } from "zod";
+
+const clutchSplitSchema = z.object({
+  count: z.number().int().nonnegative(),
+  won: z.number().int().nonnegative()
+});
+
+export const rrIndicatorsSchema: z.ZodType<RRIndicators> = z.object({
+  steamId64: z.string(),
+  totalRounds: z.number().int().nonnegative(),
+  kills: z.number().int().nonnegative(),
+  deaths: z.number().int().nonnegative(),
+  assists: z.number().int().nonnegative(),
+  kpr: z.number().nonnegative(),
+  dpr: z.number().nonnegative(),
+  apr: z.number().nonnegative(),
+  adr: z.number().nonnegative(),
+  hsPercent: z.number().min(0).max(100),
+  kast: z.number().min(0).max(100),
+  survivalRate: z.number().min(0).max(1),
+  twoKillRounds: z.number().int().nonnegative(),
+  threeKillRounds: z.number().int().nonnegative(),
+  fourKillRounds: z.number().int().nonnegative(),
+  fiveKillRounds: z.number().int().nonnegative(),
+  multiKillRate: z.number().min(0).max(1),
+  firstKillCount: z.number().int().nonnegative(),
+  firstDeathCount: z.number().int().nonnegative(),
+  firstKillRate: z.number().nonnegative(),
+  firstDeathRate: z.number().nonnegative(),
+  openingDuelRate: z.number().nonnegative(),
+  openingDuelWinRate: z.number().min(0).max(1),
+  tradeKillCount: z.number().int().nonnegative(),
+  tradeDeathCount: z.number().int().nonnegative(),
+  tradeKillRate: z.number().nonnegative(),
+  tradeDeathRate: z.number().nonnegative(),
+  clutchAttempts: z.number().int().nonnegative(),
+  clutchWins: z.number().int().nonnegative(),
+  clutchWinRate: z.number().min(0).max(1),
+  clutchFrequency: z.number().nonnegative(),
+  clutchScore: z.number().nonnegative(),
+  clutchScoreRate: z.number().nonnegative(),
+  vsOne: clutchSplitSchema,
+  vsTwo: clutchSplitSchema,
+  vsThree: clutchSplitSchema,
+  vsFour: clutchSplitSchema,
+  vsFive: clutchSplitSchema,
+  awpKills: z.number().int().nonnegative(),
+  awpKillsPerRound: z.number().nonnegative(),
+  awpKillRate: z.number().min(0).max(1),
+  sniperKills: z.number().int().nonnegative(),
+  sniperKillRate: z.number().min(0).max(1),
+  awpMultiKillRate: z.number().min(0).max(1).nullable(),
+  awpDuelWinRate: z.number().min(0).max(1).nullable(),
+  utilityDamage: z.number().int().nonnegative(),
+  utilityDamagePerRound: z.number().nonnegative(),
+  flashAssistCount: z.number().int().nonnegative(),
+  flashAssistPerRound: z.number().nonnegative(),
+  blindDurationTotal: z.number().nonnegative(),
+  blindDurationPerRound: z.number().nonnegative(),
+  enemyFlashDurationSeconds: z.number().nonnegative().nullable(),
+  enemyFlashDurationPerRound: z.number().nonnegative().nullable(),
+  teamFlashDurationSeconds: z.number().nonnegative().nullable(),
+  teamFlashDurationPerRound: z.number().nonnegative().nullable(),
+  grenadeCount: z.number().int().nonnegative(),
+  grenadeCountPerRound: z.number().nonnegative(),
+  ecoRoundCount: z.number().int().nonnegative(),
+  forceRoundCount: z.number().int().nonnegative(),
+  fullBuyRoundCount: z.number().int().nonnegative(),
+  pistolRoundCount: z.number().int().nonnegative(),
+  avgEquipmentValue: z.number().nonnegative(),
+  combatDeathCount: z.number().int().nonnegative().nullable(),
+  bombDeathCount: z.number().int().nonnegative().nullable(),
+  wallbangKillCount: z.number().int().nonnegative().nullable(),
+  roundSwingTotal: z.number().nullable(),
+  roundSwingPerKill: z.number().nullable()
+});
+
+export type {
+  CohortAccountResult,
+  PrismResult,
+  RRIndicators,
+  RRResult,
+  RRSignals,
+  RRSixAccountResult,
+  RRSixAccountWeights
+} from "@rivalhub/rival-rating";

package/src/series.ts

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import { matchWorkspaceModelSchema } from "./workspace.js";
+
+export const mvpCandidateSchema = z.object({
+  playerKey: z.string(),
+  name: z.string(),
+  teamName: z.string(),
+  recommendationScore: z.number().nonnegative(),
+  rivalhubRR: z.number().nonnegative(),
+  hltvRating: z.number().nonnegative(),
+  confidence: z.number().min(0).max(1),
+  explanation: z.array(z.string())
+});
+
+export const mvpRecommendationSchema = z.object({
+  version: z.literal("cs2-demo-analysis-kit/mvp-recommendation-0.1"),
+  recommended: mvpCandidateSchema,
+  candidates: z.array(mvpCandidateSchema).min(1)
+});
+
+export const seriesMatchInputSchema = z.object({
+  matchId: z.string(),
+  model: matchWorkspaceModelSchema
+});
+
+export const seriesPlayerMapTrendSchema = z.object({
+  matchId: z.string(),
+  mapName: z.string(),
+  rivalhubRR: z.number().nonnegative(),
+  hltvRating: z.number().nonnegative(),
+  adr: z.number().nonnegative(),
+  kast: z.number().min(0).max(100)
+});
+
+export const seriesPlayerRowSchema = z.object({
+  playerKey: z.string(),
+  name: z.string(),
+  teamName: z.string(),
+  mapCount: z.number().int().positive(),
+  totalRounds: z.number().int().positive(),
+  kills: z.number().int().nonnegative(),
+  deaths: z.number().int().nonnegative(),
+  assists: z.number().int().nonnegative(),
+  adr: z.number().nonnegative(),
+  kast: z.number().min(0).max(100),
+  rivalhubRR: z.number().nonnegative(),
+  hltvRating: z.number().nonnegative(),
+  confidence: z.number().min(0).max(1),
+  perMap: z.array(seriesPlayerMapTrendSchema)
+});
+
+export const seriesSummarySchema = z.object({
+  version: z.literal("cs2-demo-analysis-kit/series-summary-0.1"),
+  mapCount: z.number().int().positive(),
+  maps: z.array(z.object({
+    matchId: z.string(),
+    mapName: z.string(),
+    scoreline: z.string(),
+    teamAName: z.string(),
+    teamBName: z.string(),
+    winnerName: z.string().nullable()
+  })),
+  teams: z.array(z.object({
+    teamKey: z.string(),
+    name: z.string(),
+    mapsWon: z.number().int().nonnegative()
+  })),
+  scoreboard: z.array(seriesPlayerRowSchema),
+  mvpCandidates: z.array(mvpCandidateSchema)
+});
+
+export type MvpCandidate = z.infer<typeof mvpCandidateSchema>;
+export type MvpRecommendation = z.infer<typeof mvpRecommendationSchema>;
+export type SeriesMatchInput = z.infer<typeof seriesMatchInputSchema>;
+export type SeriesPlayerMapTrend = z.infer<typeof seriesPlayerMapTrendSchema>;
+export type SeriesPlayerRow = z.infer<typeof seriesPlayerRowSchema>;
+export type SeriesSummary = z.infer<typeof seriesSummarySchema>;

package/src/team.ts

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { leaderboardMetricKeySchema } from "./leaderboard.js";
+import { playerStyleAxisSchema } from "./player.js";
+
+export const teamRosterInputSchema = z.object({
+  teamKey: z.string(),
+  name: z.string(),
+  playerKeys: z.array(z.string()).min(1)
+});
+
+export const teamMemberSummarySchema = z.object({
+  playerKey: z.string(),
+  name: z.string(),
+  mapCount: z.number().int().positive(),
+  confidence: z.number().min(0).max(1),
+  metrics: z.record(leaderboardMetricKeySchema, z.number().nullable())
+});
+
+export const teamMetricLeaderSchema = z.object({
+  metric: z.enum(["rivalhubRR", "adr", "kast", "firstKillPer100"]),
+  label: z.string(),
+  playerKey: z.string(),
+  name: z.string(),
+  value: z.number()
+});
+
+export const teamRoleSpecialistSchema = playerStyleAxisSchema.extend({
+  playerKey: z.string(),
+  name: z.string()
+});
+
+export const teamCohortSummarySchema = z.object({
+  version: z.literal("cs2-demo-analysis-kit/team-summary-0.1"),
+  weightsVersion: z.string(),
+  teamKey: z.string(),
+  name: z.string(),
+  members: z.array(teamMemberSummarySchema).min(1),
+  coreMembers: z.array(teamMemberSummarySchema).min(1),
+  averages: z.object({
+    rivalhubRR: z.number().nonnegative(),
+    hltvRating: z.number().nonnegative(),
+    adr: z.number().nonnegative(),
+    kd: z.number().nullable(),
+    kast: z.number().min(0).max(100),
+    confidence: z.number().min(0).max(1)
+  }),
+  performance: z.object({
+    firstKills: z.number().int().nonnegative(),
+    firstDeaths: z.number().int().nonnegative(),
+    openingDuelWinRate: z.number().min(0).max(1).nullable(),
+    clutchAttempts: z.number().int().nonnegative(),
+    clutchWins: z.number().int().nonnegative(),
+    clutchWinRate: z.number().min(0).max(1).nullable()
+  }),
+  /** 队伍 PRISM：成员各轴百分位的简单平均，不重算 PRISM。 */
+  style: z.object({
+    axes: z.array(playerStyleAxisSchema)
+  }).nullable(),
+  leaders: z.array(teamMetricLeaderSchema),
+  roleComplementarity: z.object({
+    /** 成员主轴覆盖率：不同主轴数 / min(成员数, 8)，0–100。 */
+    coverageScore: z.number().min(0).max(100),
+    specialists: z.array(teamRoleSpecialistSchema),
+    weakAxes: z.array(playerStyleAxisSchema)
+  })
+});
+
+export type TeamRosterInput = z.infer<typeof teamRosterInputSchema>;
+export type TeamMemberSummary = z.infer<typeof teamMemberSummarySchema>;
+export type TeamMetricLeader = z.infer<typeof teamMetricLeaderSchema>;
+export type TeamRoleSpecialist = z.infer<typeof teamRoleSpecialistSchema>;
+export type TeamCohortSummary = z.infer<typeof teamCohortSummarySchema>;

package/src/trails.ts

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { sideSchema, teamEconomySchema, grenadeTypeSchema } from "cs2-demo-format";
+
+/**
+ * 开局动线：单选手在指定经济类型回合（默认长枪局）开局窗口内的
+ * 走位轨迹 + 道具投掷。由 @cs2dak/presentation 从 replay/rounds/grenades 派生，
+ * 坐标保持 world 坐标系，radar 投影由渲染端（@cs2dak/maps）完成。
+ */
+
+export const trailPointSchema = z.object({
+  /** 距 freeze 结束的秒数。 */
+  t: z.number().nonnegative(),
+  x: z.number(),
+  y: z.number()
+});
+
+export const trailGrenadeSchema = z.object({
+  /** 投掷时刻（距 freeze 结束的秒数）。 */
+  t: z.number().nonnegative(),
+  x: z.number(),
+  y: z.number(),
+  grenade: grenadeTypeSchema,
+  /** 生效时刻（距 freeze 结束的秒数）。 */
+  effectT: z.number().nonnegative(),
+  /** 效果消失时刻；导出包缺失时 null，渲染端按道具类型取默认时长。 */
+  destroyT: z.number().nonnegative().nullable(),
+  /** 落点（world 坐标）。 */
+  effectX: z.number(),
+  effectY: z.number()
+});
+
+export const openingTrailRoundSchema = z.object({
+  matchId: z.string(),
+  roundNumber: z.number().int().positive(),
+  side: sideSchema,
+  economyType: teamEconomySchema,
+  points: z.array(trailPointSchema),
+  grenades: z.array(trailGrenadeSchema)
+});
+
+export const openingTrailsModelSchema = z.object({
+  version: z.literal("cs2-demo-analysis-kit/opening-trails-0.2"),
+  matchId: z.string(),
+  mapName: z.string(),
+  steamId64: z.string(),
+  playerName: z.string(),
+  /** 该导出包是否含回放流；false 时 rounds 为空。 */
+  available: z.boolean(),
+  windowSeconds: z.number().positive(),
+  rounds: z.array(openingTrailRoundSchema)
+});
+
+export type TrailPoint = z.infer<typeof trailPointSchema>;
+export type TrailGrenade = z.infer<typeof trailGrenadeSchema>;
+export type OpeningTrailRound = z.infer<typeof openingTrailRoundSchema>;
+export type OpeningTrailsModel = z.infer<typeof openingTrailsModelSchema>;

package/src/upstream.ts

@@ -0,0 +1,110 @@
+import { z } from "zod";
+import {
+  sideSchema,
+  teamKeySchema,
+  economyTypeSchema,
+  teamEconomySchema,
+  vec3Schema,
+  playerIndexSchema,
+  playerRowSchema,
+  roundRowSchema,
+  killRowSchema,
+  damageRowSchema,
+  playerEconomyRowSchema,
+  playerStatsRowSchema,
+  blindRowSchema,
+  bombRowSchema,
+  grenadeRowSchema,
+  clutchRowSchema,
+  shotTrackSchema,
+  shotsSchema,
+  replaySchema,
+  replayRoundSchema,
+  replayPlayerTrackSchema,
+  replayProjectileSchema,
+  duelsSchema,
+  duelWindowSchema,
+  duelPlayerTrackSchema,
+  duelAnchorSchema,
+} from "cs2-demo-format";
+
+export {
+  SCHEMAS_BY_KEY,
+  blindRowSchema,
+  blindsSchema,
+  bombEventTypeSchema,
+  bombRowSchema,
+  bombsSchema,
+  clutchRowSchema,
+  clutchesSchema,
+  damageRowSchema,
+  damagesSchema,
+  decodeDelta,
+  duelAnchorSchema,
+  duelPlayerTrackSchema,
+  duelsSchema,
+  duelWindowSchema,
+  economyTypeSchema,
+  endReasonSchema,
+  FLAG_ALIVE,
+  FLAG_HAS_BOMB,
+  FLAG_HAS_DEFUSE_KIT,
+  grenadeRowSchema,
+  grenadeTypeSchema,
+  grenadesSchema,
+  hitgroupSchema,
+  killRowSchema,
+  killsSchema,
+  manifestSchema,
+  matchSchema,
+  playerEconomiesSchema,
+  playerEconomyRowSchema,
+  playerIndexSchema,
+  playerRowSchema,
+  playersSchema,
+  playerStatsRowSchema,
+  playerStatsSchema,
+  replaySchema,
+  replayPlayerTrackSchema,
+  replayProjectileSchema,
+  replayRoundSchema,
+  roundRowSchema,
+  roundsSchema,
+  shotTrackSchema,
+  shotsSchema,
+  sideSchema,
+  steamId64Schema,
+  teamEconomySchema,
+  teamEconomyTypeSchema,
+  teamKeySchema,
+  teamSummarySchema,
+  vec3Schema,
+} from "cs2-demo-format";
+
+export type Side = z.infer<typeof sideSchema>;
+export type TeamKey = z.infer<typeof teamKeySchema>;
+export type EconomyType = z.infer<typeof economyTypeSchema>;
+export type TeamEconomyType = z.infer<typeof teamEconomySchema>;
+export type Vec3 = z.infer<typeof vec3Schema>;
+export type PlayerIndex = z.infer<typeof playerIndexSchema>;
+
+export type PackagePlayer = z.infer<typeof playerRowSchema>;
+export type PackageRound = z.infer<typeof roundRowSchema>;
+export type PackageKill = z.infer<typeof killRowSchema>;
+export type PackageDamage = z.infer<typeof damageRowSchema>;
+export type PackagePlayerEconomy = z.infer<typeof playerEconomyRowSchema>;
+export type PackagePlayerStats = z.infer<typeof playerStatsRowSchema>;
+export type PackageBlind = z.infer<typeof blindRowSchema>;
+export type PackageBomb = z.infer<typeof bombRowSchema>;
+export type PackageGrenade = z.infer<typeof grenadeRowSchema>;
+export type PackageClutch = z.infer<typeof clutchRowSchema>;
+export type PackageShots = z.infer<typeof shotsSchema>;
+export type PackageShotTrack = z.infer<typeof shotTrackSchema>;
+export type Replay = z.infer<typeof replaySchema>;
+export type ReplayRound = z.infer<typeof replayRoundSchema>;
+export type ReplayPlayerTrack = z.infer<typeof replayPlayerTrackSchema>;
+export type ReplayProjectile = z.infer<typeof replayProjectileSchema>;
+export type Duels = z.infer<typeof duelsSchema>;
+export type DuelWindow = z.infer<typeof duelWindowSchema>;
+export type DuelPlayerTrack = z.infer<typeof duelPlayerTrackSchema>;
+export type DuelAnchor = z.infer<typeof duelAnchorSchema>;

package/src/veto.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+
+export const seriesFormatSchema = z.enum(["bo1", "bo3", "bo5"]);
+export const vetoActionTypeSchema = z.enum(["ban", "pick", "decider"]);
+export const vetoTeamRefSchema = z.enum(["teamA", "teamB"]).nullable();
+
+export const seriesVetoStepSchema = z.object({
+  stepOrder: z.number().int().positive(),
+  actionType: vetoActionTypeSchema,
+  mapName: z.string().min(1),
+  teamKey: vetoTeamRefSchema,
+  side: z.enum(["t", "ct"]).nullable()
+});
+
+export const seriesVetoSchema = z.object({
+  version: z.literal("cs2-demo-analysis-kit/series-veto-0.1"),
+  seriesId: z.string(),
+  format: seriesFormatSchema,
+  teamAName: z.string(),
+  teamBName: z.string(),
+  mapPool: z.array(z.string().min(1)),
+  maps: z.object({
+    picked: z.array(z.object({
+      mapName: z.string().min(1),
+      teamKey: z.enum(["teamA", "teamB"]).nullable()
+    })),
+    banned: z.array(z.object({
+      mapName: z.string().min(1),
+      teamKey: z.enum(["teamA", "teamB"]).nullable()
+    })),
+    decider: z.string().min(1).nullable()
+  }),
+  sideChoices: z.array(z.object({
+    mapName: z.string().min(1),
+    teamKey: z.enum(["teamA", "teamB"]).nullable(),
+    side: z.enum(["t", "ct"])
+  })),
+  steps: z.array(seriesVetoStepSchema)
+});
+
+export type SeriesFormat = z.infer<typeof seriesFormatSchema>;
+export type VetoActionType = z.infer<typeof vetoActionTypeSchema>;
+export type SeriesVetoStep = z.infer<typeof seriesVetoStepSchema>;
+export type SeriesVeto = z.infer<typeof seriesVetoSchema>;