@ttt-productions/q-core 0.1.28 → 0.1.30

package/dist/sports/basketball.js.map

@@ -1 +1 @@
-{"version":3,"file":"basketball.js","sourceRoot":"","sources":["../../src/sports/basketball.ts"],"names":[],"mappings":"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","sourcesContent":["// The basketball adapter: player-scored — a team's score is the sum of its players' points — with\n// a hall of fame and a historical baseline. Its scoring, display, and bulk-entry members are in\n// ./basketball-scoring.ts.\n\nimport { SPORT_LINE_SCHEMAS } from '../doc-schemas/aggregate-stats.js';\nimport type {\n  BasketballPlayerTotals,\n  BasketballTeamSeasonStats,\n} from '../doc-schemas/aggregate-stats.js';\nimport type { BasketballPlayerStats } from '../doc-schemas/game-stats.js';\nimport {\n  BASKETBALL_PLAYER_STAT_KEYS,\n  BASKETBALL_STAT_EVENT_TYPE_KEYS,\n  BASKETBALL_TEAM_STAT_KEYS,\n  SPORT_KEY_BY_LEAGUE_TYPE,\n} from '../types/sports.js';\nimport {\n  BASKETBALL_BULK_ENTRY,\n  BASKETBALL_EVENT_LABELS,\n  BASKETBALL_FIELD_LABELS,\n  BASKETBALL_SCOREBOARD,\n  BASKETBALL_SCORING,\n  BASKETBALL_SCORING_PANEL,\n  describeBasketballEvent,\n  emptyBasketballTeamLine,\n} from './basketball-scoring.js';\nimport type { ColumnSort, StatColumn } from './column-catalog.js';\nimport { lifetimeSummaryFromColumns } from './lifetime-summary.js';\nimport {\n  GAMES_PLAYED_COLUMN,\n  TEAM_SEASON_BASE_COLUMN,\n  TEAM_SEASON_BASE_COLUMNS,\n} from './shared-columns.js';\nimport type { SportAdapter } from './sport-adapter.js';\n\n// Each figure's copy, declared once and shared by the player and team columns that show it.\nconst POINTS = { id: 'points', label: 'Points', shortLabel: 'PTS' } as const;\nconst POINTS_PER_GAME = {\n  id: 'pointsPerGame',\n  label: 'Points per game',\n  shortLabel: 'PPG',\n} as const;\nconst REBOUNDS = { id: 'rebounds', label: 'Rebounds', shortLabel: 'REB' } as const;\nconst REBOUNDS_PER_GAME = {\n  id: 'reboundsPerGame',\n  label: 'Rebounds per game',\n  shortLabel: 'RPG',\n} as const;\nconst ASSISTS = { id: 'assists', label: 'Assists', shortLabel: 'AST' } as const;\nconst ASSISTS_PER_GAME = {\n  id: 'assistsPerGame',\n  label: 'Assists per game',\n  shortLabel: 'APG',\n} as const;\n// FP is stored on every player line, never computed for display (`deriveLine` writes it).\nconst FANTASY_POINTS = { id: 'fantasyPoints', label: 'Fantasy points', shortLabel: 'FP' } as const;\nconst FANTASY_POINTS_PER_GAME = {\n  id: 'fantasyPointsPerGame',\n  label: 'Fantasy points per game',\n  shortLabel: 'FP/G',\n} as const;\n\nconst BY_POINTS: readonly ColumnSort[] = [{ columnId: POINTS.id, direction: 'desc' }];\n\nconst playerTotalsColumns: readonly StatColumn<BasketballPlayerTotals>[] = [\n  GAMES_PLAYED_COLUMN,\n  { ...POINTS, value: (line) => line.points, perGame: POINTS_PER_GAME, sort: 'desc' },\n  { ...REBOUNDS, value: (line) => line.rebounds, perGame: REBOUNDS_PER_GAME, sort: 'desc' },\n  { ...ASSISTS, value: (line) => line.assists, perGame: ASSISTS_PER_GAME, sort: 'desc' },\n  {\n    ...FANTASY_POINTS,\n    value: (line) => line.fantasyPoints,\n    perGame: FANTASY_POINTS_PER_GAME,\n    sort: 'desc',\n  },\n];\n\nconst gamePlayerColumns: readonly StatColumn<BasketballPlayerStats>[] = [\n  { ...POINTS, value: (line) => line.points, sort: 'desc' },\n  { ...REBOUNDS, value: (line) => line.rebounds, sort: 'desc' },\n  { ...ASSISTS, value: (line) => line.assists, sort: 'desc' },\n  { ...FANTASY_POINTS, value: (line) => line.fantasyPoints, sort: 'desc' },\n];\n\nconst teamSeasonColumns: readonly StatColumn<BasketballTeamSeasonStats>[] = [\n  ...TEAM_SEASON_BASE_COLUMNS,\n  { ...REBOUNDS, value: (line) => line.rebounds, perGame: REBOUNDS_PER_GAME, sort: 'desc' },\n  { ...ASSISTS, value: (line) => line.assists, perGame: ASSISTS_PER_GAME, sort: 'desc' },\n];\n\nexport const BASKETBALL_ADAPTER: SportAdapter<'Basketball'> = {\n  leagueType: 'Basketball',\n  sportKey: SPORT_KEY_BY_LEAGUE_TYPE.Basketball,\n  eventTypes: BASKETBALL_STAT_EVENT_TYPE_KEYS,\n  teamStatKeys: BASKETBALL_TEAM_STAT_KEYS,\n  playerStatKeys: BASKETBALL_PLAYER_STAT_KEYS,\n  hallOfFame: true,\n  historicalBaseline: true,\n  lineSchemas: SPORT_LINE_SCHEMAS.Basketball,\n  ...BASKETBALL_SCORING,\n  display: {\n    label: 'Basketball',\n    iconKey: 'basketballBall',\n    lifetimeSummary: lifetimeSummaryFromColumns(playerTotalsColumns),\n    eventLabels: BASKETBALL_EVENT_LABELS,\n    fieldLabels: BASKETBALL_FIELD_LABELS,\n    describeEvent: describeBasketballEvent,\n    scoreboard: BASKETBALL_SCOREBOARD,\n    scoringPanel: BASKETBALL_SCORING_PANEL,\n  },\n  columns: {\n    playerTotals: {\n      columns: playerTotalsColumns,\n      defaultSort: BY_POINTS,\n      presets: [\n        {\n          id: 'totals',\n          label: 'Totals',\n          columnIds: [\n            GAMES_PLAYED_COLUMN.id,\n            POINTS.id,\n            REBOUNDS.id,\n            ASSISTS.id,\n            FANTASY_POINTS.id,\n          ],\n        },\n        {\n          id: 'perGame',\n          label: 'Per game',\n          columnIds: [\n            GAMES_PLAYED_COLUMN.id,\n            POINTS_PER_GAME.id,\n            REBOUNDS_PER_GAME.id,\n            ASSISTS_PER_GAME.id,\n            FANTASY_POINTS_PER_GAME.id,\n          ],\n        },\n      ],\n    },\n    gamePlayer: {\n      columns: gamePlayerColumns,\n      defaultSort: BY_POINTS,\n      defaultLayout: [POINTS.id, REBOUNDS.id, ASSISTS.id, FANTASY_POINTS.id],\n    },\n    teamSeason: {\n      columns: teamSeasonColumns,\n      defaultSort: [\n        { columnId: TEAM_SEASON_BASE_COLUMN.wins.id, direction: 'desc' },\n        { columnId: TEAM_SEASON_BASE_COLUMN.losses.id, direction: 'asc' },\n        { columnId: TEAM_SEASON_BASE_COLUMN.pointDifferential.id, direction: 'desc' },\n      ],\n      defaultLayout: [\n        TEAM_SEASON_BASE_COLUMN.wins.id,\n        TEAM_SEASON_BASE_COLUMN.losses.id,\n        TEAM_SEASON_BASE_COLUMN.pointsFor.id,\n        TEAM_SEASON_BASE_COLUMN.pointsAgainst.id,\n        TEAM_SEASON_BASE_COLUMN.pointDifferential.id,\n        REBOUNDS.id,\n        ASSISTS.id,\n      ],\n    },\n  },\n  emptyStats: (game) => ({\n    teamStats: Object.fromEntries(\n      game.teamIds.map((teamId) => [teamId, emptyBasketballTeamLine()]),\n    ),\n    playerStats: {},\n  }),\n  bulkEntry: BASKETBALL_BULK_ENTRY,\n};\n"]}
+{"version":3,"file":"basketball.js","sourceRoot":"","sources":["../../src/sports/basketball.ts"],"names":[],"mappings":"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","sourcesContent":["import { SPORT_LINE_SCHEMAS } from '../doc-schemas/aggregate-stats.js';\nimport type {\n  BasketballPlayerTotals,\n  BasketballTeamSeasonStats,\n} from '../doc-schemas/aggregate-stats.js';\nimport type { BasketballPlayerStats } from '../doc-schemas/game-stats.js';\nimport {\n  BASKETBALL_PLAYER_STAT_KEYS,\n  BASKETBALL_STAT_EVENT_TYPE_KEYS,\n  BASKETBALL_TEAM_STAT_KEYS,\n  SPORT_KEY_BY_LEAGUE_TYPE,\n} from '../types/sports.js';\nimport {\n  BASKETBALL_BULK_ENTRY,\n  BASKETBALL_EVENT_LABELS,\n  BASKETBALL_FIELD_LABELS,\n  BASKETBALL_SCOREBOARD,\n  BASKETBALL_SCORING,\n  BASKETBALL_SCORING_PANEL,\n  describeBasketballEvent,\n  emptyBasketballTeamLine,\n} from './basketball-scoring.js';\nimport type { ColumnSort, StatColumn } from './column-catalog.js';\nimport { lifetimeSummaryFromColumns } from './lifetime-summary.js';\nimport {\n  GAMES_PLAYED_COLUMN,\n  TEAM_SEASON_BASE_COLUMN,\n  TEAM_SEASON_BASE_COLUMNS,\n} from './shared-columns.js';\nimport type { SportAdapter } from './sport-adapter.js';\n\nconst POINTS = { id: 'points', label: 'Points', shortLabel: 'PTS' } as const;\nconst POINTS_PER_GAME = {\n  id: 'pointsPerGame',\n  label: 'Points per game',\n  shortLabel: 'PPG',\n} as const;\nconst REBOUNDS = { id: 'rebounds', label: 'Rebounds', shortLabel: 'REB' } as const;\nconst REBOUNDS_PER_GAME = {\n  id: 'reboundsPerGame',\n  label: 'Rebounds per game',\n  shortLabel: 'RPG',\n} as const;\nconst ASSISTS = { id: 'assists', label: 'Assists', shortLabel: 'AST' } as const;\nconst ASSISTS_PER_GAME = {\n  id: 'assistsPerGame',\n  label: 'Assists per game',\n  shortLabel: 'APG',\n} as const;\nconst FANTASY_POINTS = { id: 'fantasyPoints', label: 'Fantasy points', shortLabel: 'FP' } as const;\nconst FANTASY_POINTS_PER_GAME = {\n  id: 'fantasyPointsPerGame',\n  label: 'Fantasy points per game',\n  shortLabel: 'FP/G',\n} as const;\n\nconst BY_POINTS: readonly ColumnSort[] = [{ columnId: POINTS.id, direction: 'desc' }];\n\nconst playerTotalsColumns: readonly StatColumn<BasketballPlayerTotals>[] = [\n  GAMES_PLAYED_COLUMN,\n  { ...POINTS, value: (line) => line.points, perGame: POINTS_PER_GAME, sort: 'desc' },\n  { ...REBOUNDS, value: (line) => line.rebounds, perGame: REBOUNDS_PER_GAME, sort: 'desc' },\n  { ...ASSISTS, value: (line) => line.assists, perGame: ASSISTS_PER_GAME, sort: 'desc' },\n  {\n    ...FANTASY_POINTS,\n    value: (line) => line.fantasyPoints,\n    perGame: FANTASY_POINTS_PER_GAME,\n    sort: 'desc',\n  },\n];\n\nconst gamePlayerColumns: readonly StatColumn<BasketballPlayerStats>[] = [\n  { ...POINTS, value: (line) => line.points, sort: 'desc' },\n  { ...REBOUNDS, value: (line) => line.rebounds, sort: 'desc' },\n  { ...ASSISTS, value: (line) => line.assists, sort: 'desc' },\n  { ...FANTASY_POINTS, value: (line) => line.fantasyPoints, sort: 'desc' },\n];\n\nconst teamSeasonColumns: readonly StatColumn<BasketballTeamSeasonStats>[] = [\n  ...TEAM_SEASON_BASE_COLUMNS,\n  { ...REBOUNDS, value: (line) => line.rebounds, perGame: REBOUNDS_PER_GAME, sort: 'desc' },\n  { ...ASSISTS, value: (line) => line.assists, perGame: ASSISTS_PER_GAME, sort: 'desc' },\n];\n\nexport const BASKETBALL_ADAPTER: SportAdapter<'Basketball'> = {\n  leagueType: 'Basketball',\n  sportKey: SPORT_KEY_BY_LEAGUE_TYPE.Basketball,\n  eventTypes: BASKETBALL_STAT_EVENT_TYPE_KEYS,\n  teamStatKeys: BASKETBALL_TEAM_STAT_KEYS,\n  playerStatKeys: BASKETBALL_PLAYER_STAT_KEYS,\n  hallOfFame: true,\n  historicalBaseline: true,\n  lineSchemas: SPORT_LINE_SCHEMAS.Basketball,\n  ...BASKETBALL_SCORING,\n  display: {\n    label: 'Basketball',\n    iconKey: 'basketballBall',\n    lifetimeSummary: lifetimeSummaryFromColumns(playerTotalsColumns),\n    eventLabels: BASKETBALL_EVENT_LABELS,\n    fieldLabels: BASKETBALL_FIELD_LABELS,\n    describeEvent: describeBasketballEvent,\n    scoreboard: BASKETBALL_SCOREBOARD,\n    scoringPanel: BASKETBALL_SCORING_PANEL,\n  },\n  columns: {\n    playerTotals: {\n      columns: playerTotalsColumns,\n      defaultSort: BY_POINTS,\n      presets: [\n        {\n          id: 'totals',\n          label: 'Totals',\n          columnIds: [\n            GAMES_PLAYED_COLUMN.id,\n            POINTS.id,\n            REBOUNDS.id,\n            ASSISTS.id,\n            FANTASY_POINTS.id,\n          ],\n        },\n        {\n          id: 'perGame',\n          label: 'Per game',\n          columnIds: [\n            GAMES_PLAYED_COLUMN.id,\n            POINTS_PER_GAME.id,\n            REBOUNDS_PER_GAME.id,\n            ASSISTS_PER_GAME.id,\n            FANTASY_POINTS_PER_GAME.id,\n          ],\n        },\n      ],\n    },\n    gamePlayer: {\n      columns: gamePlayerColumns,\n      defaultSort: BY_POINTS,\n      defaultLayout: [POINTS.id, REBOUNDS.id, ASSISTS.id, FANTASY_POINTS.id],\n    },\n    teamSeason: {\n      columns: teamSeasonColumns,\n      defaultSort: [\n        { columnId: TEAM_SEASON_BASE_COLUMN.wins.id, direction: 'desc' },\n        { columnId: TEAM_SEASON_BASE_COLUMN.losses.id, direction: 'asc' },\n        { columnId: TEAM_SEASON_BASE_COLUMN.pointDifferential.id, direction: 'desc' },\n      ],\n      defaultLayout: [\n        TEAM_SEASON_BASE_COLUMN.wins.id,\n        TEAM_SEASON_BASE_COLUMN.losses.id,\n        TEAM_SEASON_BASE_COLUMN.pointsFor.id,\n        TEAM_SEASON_BASE_COLUMN.pointsAgainst.id,\n        TEAM_SEASON_BASE_COLUMN.pointDifferential.id,\n        REBOUNDS.id,\n        ASSISTS.id,\n      ],\n    },\n  },\n  emptyStats: (game) => ({\n    teamStats: Object.fromEntries(\n      game.teamIds.map((teamId) => [teamId, emptyBasketballTeamLine()]),\n    ),\n    playerStats: {},\n  }),\n  bulkEntry: BASKETBALL_BULK_ENTRY,\n};\n"]}

package/dist/sports/bulk-entry.d.ts

@@ -3,60 +3,38 @@ import type { GameStats } from '../doc-schemas/sport-game.js';
 import type { BulkEntryKind } from '../types/stats.js';
 import type { SportStatEventBody, StatVoidBody } from './scoring.js';
 import type { GameTeamIds } from './sport-adapter.js';
-/** A recorded round's live event — one no void voids — so an edit of that round can void it. */
 export interface LiveRoundEvent {
     readonly eventId: string;
     readonly roundNumber: number;
 }
-/** What the form edits: the game, the scorer's current state, and the game's roster. */
 export interface BulkEntryContext {
     readonly game: GameTeamIds;
-    /** The scorer's optimistic rollup, the queue's pending events applied. */
     readonly state: GameStats;
-    /** Every roster entry of the game, grouped by team in the order the form lists them. */
     readonly rosterPlayerIds: readonly string[];
     readonly absentRosterPlayerIds: readonly string[];
-    /** For a sport played in rounds, the game's unvoided round events; empty for any other sport. */
     readonly liveRoundEvents: readonly LiveRoundEvent[];
 }
-/**
- * One event of a submission, in batch order: a sport event's type and payload, or the target of a
- * void. At submit — the tap — the dialog mints each sport event's id and stamps its `recordedAt`, and
- * the queue sends the drafts as one unit it never splits across calls.
- */
 export type StatEventDraft = SportStatEventBody | StatVoidBody;
 export interface BulkEntryForm<K extends BulkEntryKind, Values> {
     readonly kind: K;
-    /** The form's resolver: its rules for this game and state. */
     readonly formSchema: (context: BulkEntryContext) => z.ZodType<Values>;
     readonly formDefaults: (context: BulkEntryContext) => Values;
-    /** The drafts a submission becomes; empty when nothing changed. */
     readonly toEvents: (values: Values, context: BulkEntryContext) => readonly StatEventDraft[];
 }
-/** Each roster entry's player counters, by roster entry id. */
 export interface PlayerLinesValues {
     readonly lines: Readonly<Record<string, Readonly<Record<string, number>>>>;
 }
-/** Each team's final score, by team id. */
 export interface TeamScoresValues {
     readonly scores: Readonly<Record<string, number>>;
 }
-/** Each round, first to last: every team's points by team id, `null` where the round is not recorded. */
 export interface RoundsValues {
     readonly rounds: readonly Readonly<Record<string, number | null>>[];
 }
 export type PlayerLinesBulkEntry = BulkEntryForm<'playerLines', PlayerLinesValues>;
 export type TeamScoresBulkEntry = BulkEntryForm<'teamScores', TeamScoresValues>;
 export type RoundsBulkEntry = BulkEntryForm<'rounds', RoundsValues>;
-/** The dialog picks its form body by `kind`, from an exhaustive map over the kind union. */
 export type BulkEntry = PlayerLinesBulkEntry | TeamScoresBulkEntry | RoundsBulkEntry;
-/** The form's refusal when a submission would pass the per-write event cap. */
 export declare const BULK_ENTRY_TOO_LARGE_MESSAGE = "This entry changes more stats than one save can hold. Save part of it, then enter the rest.";
-/** The form's refusal of a value that is not a whole number of zero or more. */
 export declare const BULK_ENTRY_COUNT_MESSAGE = "Enter a whole number, zero or more.";
-/**
- * Every bulk-entry cell that holds a count: the count atom's check, answered with the one message the
- * form shows for any failure of it — which the atom's own issues cannot carry.
- */
 export declare const bulkEntryCountField: z.ZodCustom<number, number>;
 //# sourceMappingURL=bulk-entry.d.ts.map

package/dist/sports/bulk-entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bulk-entry.d.ts","sourceRoot":"","sources":["../../src/sports/bulk-entry.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,gGAAgG;AAChG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,wFAAwF;IACxF,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IAClD,iGAAiG;IACjG,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE,CAAC;CACrD;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,YAAY,CAAC;AAE/D,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,aAAa,EAAE,MAAM;IAC5D,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtE,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,MAAM,CAAC;IAC7D,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,KAAK,SAAS,cAAc,EAAE,CAAC;CAC7F;AAED,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5E;AAED,2CAA2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,yGAAyG;AACzG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;CACrE;AAED,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;AACnF,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;AAChF,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AAEpE,4FAA4F;AAC5F,MAAM,MAAM,SAAS,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,eAAe,CAAC;AAErF,+EAA+E;AAC/E,eAAO,MAAM,4BAA4B,gGACsD,CAAC;AAEhG,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,wCAAwC,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,6BAG/B,CAAC"}
+{"version":3,"file":"bulk-entry.d.ts","sourceRoot":"","sources":["../../src/sports/bulk-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IAClD,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE,CAAC;CACrD;AAED,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,YAAY,CAAC;AAE/D,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,aAAa,EAAE,MAAM;IAC5D,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtE,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,MAAM,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,KAAK,SAAS,cAAc,EAAE,CAAC;CAC7F;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;CACrE;AAED,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;AACnF,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;AAChF,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AAEpE,MAAM,MAAM,SAAS,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,eAAe,CAAC;AAErF,eAAO,MAAM,4BAA4B,gGACsD,CAAC;AAEhG,eAAO,MAAM,wBAAwB,wCAAwC,CAAC;AAE9E,eAAO,MAAM,mBAAmB,6BAG/B,CAAC"}

package/dist/sports/bulk-entry.js

@@ -1,16 +1,6 @@
-// A sport's bulk entry: the form the shared bulk-entry dialog renders for the sport's kind, and the
-// events a submission becomes. The form's rules are built from the sport's constants, and every one
-// of them is also an event rule the adapter's `validate` enforces, because the callable sees events,
-// never form values, and captains use it (RULE-QS-SPORT-906).
 import { z } from 'zod';
 import { countSchema } from '../doc-schemas/atoms.js';
-/** The form's refusal when a submission would pass the per-write event cap. */
 export const BULK_ENTRY_TOO_LARGE_MESSAGE = 'This entry changes more stats than one save can hold. Save part of it, then enter the rest.';
-/** The form's refusal of a value that is not a whole number of zero or more. */
 export const BULK_ENTRY_COUNT_MESSAGE = 'Enter a whole number, zero or more.';
-/**
- * Every bulk-entry cell that holds a count: the count atom's check, answered with the one message the
- * form shows for any failure of it — which the atom's own issues cannot carry.
- */
 export const bulkEntryCountField = z.custom((value) => countSchema.safeParse(value).success, BULK_ENTRY_COUNT_MESSAGE);
 //# sourceMappingURL=bulk-entry.js.map

package/dist/sports/bulk-entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"bulk-entry.js","sourceRoot":"","sources":["../../src/sports/bulk-entry.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,oGAAoG;AACpG,qGAAqG;AACrG,8DAA8D;AAE9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AA8DtD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,4BAA4B,GACvC,6FAA6F,CAAC;AAEhG,gFAAgF;AAChF,MAAM,CAAC,MAAM,wBAAwB,GAAG,qCAAqC,CAAC;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CACzC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,EAC/C,wBAAwB,CACzB,CAAC","sourcesContent":["// A sport's bulk entry: the form the shared bulk-entry dialog renders for the sport's kind, and the\n// events a submission becomes. The form's rules are built from the sport's constants, and every one\n// of them is also an event rule the adapter's `validate` enforces, because the callable sees events,\n// never form values, and captains use it (RULE-QS-SPORT-906).\n\nimport { z } from 'zod';\nimport { countSchema } from '../doc-schemas/atoms.js';\nimport type { GameStats } from '../doc-schemas/sport-game.js';\nimport type { BulkEntryKind } from '../types/stats.js';\nimport type { SportStatEventBody, StatVoidBody } from './scoring.js';\nimport type { GameTeamIds } from './sport-adapter.js';\n\n/** A recorded round's live event — one no void voids — so an edit of that round can void it. */\nexport interface LiveRoundEvent {\n  readonly eventId: string;\n  readonly roundNumber: number;\n}\n\n/** What the form edits: the game, the scorer's current state, and the game's roster. */\nexport interface BulkEntryContext {\n  readonly game: GameTeamIds;\n  /** The scorer's optimistic rollup, the queue's pending events applied. */\n  readonly state: GameStats;\n  /** Every roster entry of the game, grouped by team in the order the form lists them. */\n  readonly rosterPlayerIds: readonly string[];\n  readonly absentRosterPlayerIds: readonly string[];\n  /** For a sport played in rounds, the game's unvoided round events; empty for any other sport. */\n  readonly liveRoundEvents: readonly LiveRoundEvent[];\n}\n\n/**\n * One event of a submission, in batch order: a sport event's type and payload, or the target of a\n * void. At submit — the tap — the dialog mints each sport event's id and stamps its `recordedAt`, and\n * the queue sends the drafts as one unit it never splits across calls.\n */\nexport type StatEventDraft = SportStatEventBody | StatVoidBody;\n\nexport interface BulkEntryForm<K extends BulkEntryKind, Values> {\n  readonly kind: K;\n  /** The form's resolver: its rules for this game and state. */\n  readonly formSchema: (context: BulkEntryContext) => z.ZodType<Values>;\n  readonly formDefaults: (context: BulkEntryContext) => Values;\n  /** The drafts a submission becomes; empty when nothing changed. */\n  readonly toEvents: (values: Values, context: BulkEntryContext) => readonly StatEventDraft[];\n}\n\n/** Each roster entry's player counters, by roster entry id. */\nexport interface PlayerLinesValues {\n  readonly lines: Readonly<Record<string, Readonly<Record<string, number>>>>;\n}\n\n/** Each team's final score, by team id. */\nexport interface TeamScoresValues {\n  readonly scores: Readonly<Record<string, number>>;\n}\n\n/** Each round, first to last: every team's points by team id, `null` where the round is not recorded. */\nexport interface RoundsValues {\n  readonly rounds: readonly Readonly<Record<string, number | null>>[];\n}\n\nexport type PlayerLinesBulkEntry = BulkEntryForm<'playerLines', PlayerLinesValues>;\nexport type TeamScoresBulkEntry = BulkEntryForm<'teamScores', TeamScoresValues>;\nexport type RoundsBulkEntry = BulkEntryForm<'rounds', RoundsValues>;\n\n/** The dialog picks its form body by `kind`, from an exhaustive map over the kind union. */\nexport type BulkEntry = PlayerLinesBulkEntry | TeamScoresBulkEntry | RoundsBulkEntry;\n\n/** The form's refusal when a submission would pass the per-write event cap. */\nexport const BULK_ENTRY_TOO_LARGE_MESSAGE =\n  'This entry changes more stats than one save can hold. Save part of it, then enter the rest.';\n\n/** The form's refusal of a value that is not a whole number of zero or more. */\nexport const BULK_ENTRY_COUNT_MESSAGE = 'Enter a whole number, zero or more.';\n\n/**\n * Every bulk-entry cell that holds a count: the count atom's check, answered with the one message the\n * form shows for any failure of it — which the atom's own issues cannot carry.\n */\nexport const bulkEntryCountField = z.custom<number>(\n  (value) => countSchema.safeParse(value).success,\n  BULK_ENTRY_COUNT_MESSAGE,\n);\n"]}
+{"version":3,"file":"bulk-entry.js","sourceRoot":"","sources":["../../src/sports/bulk-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AA8CtD,MAAM,CAAC,MAAM,4BAA4B,GACvC,6FAA6F,CAAC;AAEhG,MAAM,CAAC,MAAM,wBAAwB,GAAG,qCAAqC,CAAC;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CACzC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,EAC/C,wBAAwB,CACzB,CAAC","sourcesContent":["import { z } from 'zod';\nimport { countSchema } from '../doc-schemas/atoms.js';\nimport type { GameStats } from '../doc-schemas/sport-game.js';\nimport type { BulkEntryKind } from '../types/stats.js';\nimport type { SportStatEventBody, StatVoidBody } from './scoring.js';\nimport type { GameTeamIds } from './sport-adapter.js';\n\nexport interface LiveRoundEvent {\n  readonly eventId: string;\n  readonly roundNumber: number;\n}\n\nexport interface BulkEntryContext {\n  readonly game: GameTeamIds;\n  readonly state: GameStats;\n  readonly rosterPlayerIds: readonly string[];\n  readonly absentRosterPlayerIds: readonly string[];\n  readonly liveRoundEvents: readonly LiveRoundEvent[];\n}\n\nexport type StatEventDraft = SportStatEventBody | StatVoidBody;\n\nexport interface BulkEntryForm<K extends BulkEntryKind, Values> {\n  readonly kind: K;\n  readonly formSchema: (context: BulkEntryContext) => z.ZodType<Values>;\n  readonly formDefaults: (context: BulkEntryContext) => Values;\n  readonly toEvents: (values: Values, context: BulkEntryContext) => readonly StatEventDraft[];\n}\n\nexport interface PlayerLinesValues {\n  readonly lines: Readonly<Record<string, Readonly<Record<string, number>>>>;\n}\n\nexport interface TeamScoresValues {\n  readonly scores: Readonly<Record<string, number>>;\n}\n\nexport interface RoundsValues {\n  readonly rounds: readonly Readonly<Record<string, number | null>>[];\n}\n\nexport type PlayerLinesBulkEntry = BulkEntryForm<'playerLines', PlayerLinesValues>;\nexport type TeamScoresBulkEntry = BulkEntryForm<'teamScores', TeamScoresValues>;\nexport type RoundsBulkEntry = BulkEntryForm<'rounds', RoundsValues>;\n\nexport type BulkEntry = PlayerLinesBulkEntry | TeamScoresBulkEntry | RoundsBulkEntry;\n\nexport const BULK_ENTRY_TOO_LARGE_MESSAGE =\n  'This entry changes more stats than one save can hold. Save part of it, then enter the rest.';\n\nexport const BULK_ENTRY_COUNT_MESSAGE = 'Enter a whole number, zero or more.';\n\nexport const bulkEntryCountField = z.custom<number>(\n  (value) => countSchema.safeParse(value).success,\n  BULK_ENTRY_COUNT_MESSAGE,\n);\n"]}

package/dist/sports/column-catalog.d.ts

@@ -1,54 +1,38 @@
 export declare const SORT_DIRECTION_KEYS: readonly ["asc", "desc"];
 export type SortDirection = (typeof SORT_DIRECTION_KEYS)[number];
-/** A line that can be averaged per game. */
 export interface GamesPlayedRow {
     readonly gamesPlayed: number;
 }
-/** A column's per-game variant. Its own id lets a layout show it beside the total or instead of it. */
 export interface PerGameColumn {
     readonly id: string;
     readonly label: string;
     readonly shortLabel: string;
 }
 export interface StatColumn<Row> {
-    /** Presets, default layouts, and a table's View state name the column by this id. */
     readonly id: string;
-    /** The full label: wide density and the accessible name. */
     readonly label: string;
-    /** The header's label in compact and regular density (PTS). */
     readonly shortLabel: string;
-    /** A stored field of the row or a derivation over it; nothing is stored for a column. */
     readonly value: (row: Row) => number;
-    /**
-     * Offered only where the rows carry `gamesPlayed`; its figure is
-     * `perGameAverage(value(row), row.gamesPlayed)`. On any other row type the member is `never`.
-     */
     readonly perGame?: [Row] extends [GamesPlayedRow] ? PerGameColumn : never;
-    /** The direction of the column's first sort: `desc`, or `asc` where fewer is better. */
     readonly sort: SortDirection;
 }
-/** One tiebreak of a catalog's default order. */
 export interface ColumnSort {
     readonly columnId: string;
     readonly direction: SortDirection;
 }
-/** A named column set the View menu offers as one tap. `columnIds` may name per-game ids. */
 export interface ColumnPreset {
     readonly id: string;
     readonly label: string;
     readonly columnIds: readonly string[];
 }
 export interface ColumnCatalogBase<Row> {
-    /** Catalog order: where a Custom layout inserts a column it has never seen. */
     readonly columns: readonly StatColumn<Row>[];
     readonly defaultSort: readonly ColumnSort[];
 }
-/** A catalog whose coded default layout is its first preset. */
 export interface PresetColumnCatalog<Row> extends ColumnCatalogBase<Row> {
     readonly presets: readonly [ColumnPreset, ...ColumnPreset[]];
     readonly defaultLayout?: never;
 }
-/** A catalog with no presets: its coded default layout is the ordered visible column ids. */
 export interface DefaultLayoutColumnCatalog<Row> extends ColumnCatalogBase<Row> {
     readonly defaultLayout: readonly string[];
     readonly presets?: never;
@@ -58,6 +42,5 @@ export declare const COLUMN_CATALOG_KEYS: readonly ["playerTotals", "gamePlayer"
 export type ColumnCatalogKey = (typeof COLUMN_CATALOG_KEYS)[number];
 export declare const GAMES_PLAYED_CATALOG_KEYS: readonly ["playerTotals", "teamSeason"];
 export type GamesPlayedCatalogKey = (typeof GAMES_PLAYED_CATALOG_KEYS)[number];
-/** The one per-game derivation: every per-game figure the app shows comes from here. */
 export declare function perGameAverage(total: number, gamesPlayed: number): number | null;
 //# sourceMappingURL=column-catalog.d.ts.map

package/dist/sports/column-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"column-catalog.d.ts","sourceRoot":"","sources":["../../src/sports/column-catalog.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB,0BAA2B,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,uGAAuG;AACvG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU,CAAC,GAAG;IAC7B,qFAAqF;IACrF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,aAAa,GAAG,KAAK,CAAC;IAC1E,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED,iDAAiD;AACjD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;CACnC;AAED,6FAA6F;AAC7F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB,CAAC,GAAG;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB,CAAC,GAAG,CAAE,SAAQ,iBAAiB,CAAC,GAAG,CAAC;IACtE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,YAAY,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC;IAC7D,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;CAChC;AAED,6FAA6F;AAC7F,MAAM,WAAW,0BAA0B,CAAC,GAAG,CAAE,SAAQ,iBAAiB,CAAC,GAAG,CAAC;IAC7E,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC;CAC1B;AAID,MAAM,MAAM,aAAa,CAAC,GAAG,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAC;AAM5F,eAAO,MAAM,mBAAmB,uDAAwD,CAAC;AACzF,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIpE,eAAO,MAAM,yBAAyB,yCAGU,CAAC;AACjD,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEhF"}
+{"version":3,"file":"column-catalog.d.ts","sourceRoot":"","sources":["../../src/sports/column-catalog.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,0BAA2B,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU,CAAC,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,aAAa,GAAG,KAAK,CAAC;IAC1E,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB,CAAC,GAAG;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB,CAAC,GAAG,CAAE,SAAQ,iBAAiB,CAAC,GAAG,CAAC;IACtE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,YAAY,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC;IAC7D,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B,CAAC,GAAG,CAAE,SAAQ,iBAAiB,CAAC,GAAG,CAAC;IAC7E,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,CAAC,GAAG,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAC;AAE5F,eAAO,MAAM,mBAAmB,uDAAwD,CAAC;AACzF,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,yBAAyB,yCAGU,CAAC;AACjD,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEhF"}

package/dist/sports/column-catalog.js

@@ -1,19 +1,9 @@
-// The column contract the one stats table renders. The table knows nothing about a sport: it takes
-// a catalog of these columns and rows of the catalog's line type, and every per-game figure it
-// shows comes from `perGameAverage`.
 export const SORT_DIRECTION_KEYS = ['asc', 'desc'];
-// The catalogs every sport declares, one per kind of stats table: `playerTotals` (league player
-// rankings, the team page, the hall of fame), `gamePlayer` (the game page), `teamSeason`
-// (standings — its `defaultSort` is the sport's standings order, which the rank and the playoff line
-// follow). A stats table names the catalog it renders by this key.
 export const COLUMN_CATALOG_KEYS = ['playerTotals', 'gamePlayer', 'teamSeason'];
-// The catalogs whose rows carry games played, so a per-game column can average them. A game's player
-// line counts one game, so `gamePlayer` is not among them.
 export const GAMES_PLAYED_CATALOG_KEYS = [
     'playerTotals',
     'teamSeason',
 ];
-/** The one per-game derivation: every per-game figure the app shows comes from here. */
 export function perGameAverage(total, gamesPlayed) {
     return gamesPlayed === 0 ? null : total / gamesPlayed;
 }

package/dist/sports/column-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"column-catalog.js","sourceRoot":"","sources":["../../src/sports/column-catalog.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,+FAA+F;AAC/F,qCAAqC;AAErC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAoE5D,gGAAgG;AAChG,yFAAyF;AACzF,qGAAqG;AACrG,mEAAmE;AACnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,cAAc,EAAE,YAAY,EAAE,YAAY,CAAU,CAAC;AAGzF,qGAAqG;AACrG,2DAA2D;AAC3D,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,cAAc;IACd,YAAY;CACkC,CAAC;AAGjD,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,WAAmB;IAC/D,OAAO,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,WAAW,CAAC;AACxD,CAAC","sourcesContent":["// The column contract the one stats table renders. The table knows nothing about a sport: it takes\n// a catalog of these columns and rows of the catalog's line type, and every per-game figure it\n// shows comes from `perGameAverage`.\n\nexport const SORT_DIRECTION_KEYS = ['asc', 'desc'] as const;\nexport type SortDirection = (typeof SORT_DIRECTION_KEYS)[number];\n\n/** A line that can be averaged per game. */\nexport interface GamesPlayedRow {\n  readonly gamesPlayed: number;\n}\n\n/** A column's per-game variant. Its own id lets a layout show it beside the total or instead of it. */\nexport interface PerGameColumn {\n  readonly id: string;\n  readonly label: string;\n  readonly shortLabel: string;\n}\n\nexport interface StatColumn<Row> {\n  /** Presets, default layouts, and a table's View state name the column by this id. */\n  readonly id: string;\n  /** The full label: wide density and the accessible name. */\n  readonly label: string;\n  /** The header's label in compact and regular density (PTS). */\n  readonly shortLabel: string;\n  /** A stored field of the row or a derivation over it; nothing is stored for a column. */\n  readonly value: (row: Row) => number;\n  /**\n   * Offered only where the rows carry `gamesPlayed`; its figure is\n   * `perGameAverage(value(row), row.gamesPlayed)`. On any other row type the member is `never`.\n   */\n  readonly perGame?: [Row] extends [GamesPlayedRow] ? PerGameColumn : never;\n  /** The direction of the column's first sort: `desc`, or `asc` where fewer is better. */\n  readonly sort: SortDirection;\n}\n\n/** One tiebreak of a catalog's default order. */\nexport interface ColumnSort {\n  readonly columnId: string;\n  readonly direction: SortDirection;\n}\n\n/** A named column set the View menu offers as one tap. `columnIds` may name per-game ids. */\nexport interface ColumnPreset {\n  readonly id: string;\n  readonly label: string;\n  readonly columnIds: readonly string[];\n}\n\nexport interface ColumnCatalogBase<Row> {\n  /** Catalog order: where a Custom layout inserts a column it has never seen. */\n  readonly columns: readonly StatColumn<Row>[];\n  readonly defaultSort: readonly ColumnSort[];\n}\n\n/** A catalog whose coded default layout is its first preset. */\nexport interface PresetColumnCatalog<Row> extends ColumnCatalogBase<Row> {\n  readonly presets: readonly [ColumnPreset, ...ColumnPreset[]];\n  readonly defaultLayout?: never;\n}\n\n/** A catalog with no presets: its coded default layout is the ordered visible column ids. */\nexport interface DefaultLayoutColumnCatalog<Row> extends ColumnCatalogBase<Row> {\n  readonly defaultLayout: readonly string[];\n  readonly presets?: never;\n}\n\n// The `never` members make a catalog that declares both `presets` and `defaultLayout`, or neither,\n// a type error: the table must never have to choose between two default layouts.\nexport type ColumnCatalog<Row> = PresetColumnCatalog<Row> | DefaultLayoutColumnCatalog<Row>;\n\n// The catalogs every sport declares, one per kind of stats table: `playerTotals` (league player\n// rankings, the team page, the hall of fame), `gamePlayer` (the game page), `teamSeason`\n// (standings — its `defaultSort` is the sport's standings order, which the rank and the playoff line\n// follow). A stats table names the catalog it renders by this key.\nexport const COLUMN_CATALOG_KEYS = ['playerTotals', 'gamePlayer', 'teamSeason'] as const;\nexport type ColumnCatalogKey = (typeof COLUMN_CATALOG_KEYS)[number];\n\n// The catalogs whose rows carry games played, so a per-game column can average them. A game's player\n// line counts one game, so `gamePlayer` is not among them.\nexport const GAMES_PLAYED_CATALOG_KEYS = [\n  'playerTotals',\n  'teamSeason',\n] as const satisfies readonly ColumnCatalogKey[];\nexport type GamesPlayedCatalogKey = (typeof GAMES_PLAYED_CATALOG_KEYS)[number];\n\n/** The one per-game derivation: every per-game figure the app shows comes from here. */\nexport function perGameAverage(total: number, gamesPlayed: number): number | null {\n  return gamesPlayed === 0 ? null : total / gamesPlayed;\n}\n"]}
+{"version":3,"file":"column-catalog.js","sourceRoot":"","sources":["../../src/sports/column-catalog.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAkD5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,cAAc,EAAE,YAAY,EAAE,YAAY,CAAU,CAAC;AAGzF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,cAAc;IACd,YAAY;CACkC,CAAC;AAGjD,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,WAAmB;IAC/D,OAAO,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,WAAW,CAAC;AACxD,CAAC","sourcesContent":["export const SORT_DIRECTION_KEYS = ['asc', 'desc'] as const;\nexport type SortDirection = (typeof SORT_DIRECTION_KEYS)[number];\n\nexport interface GamesPlayedRow {\n  readonly gamesPlayed: number;\n}\n\nexport interface PerGameColumn {\n  readonly id: string;\n  readonly label: string;\n  readonly shortLabel: string;\n}\n\nexport interface StatColumn<Row> {\n  readonly id: string;\n  readonly label: string;\n  readonly shortLabel: string;\n  readonly value: (row: Row) => number;\n  readonly perGame?: [Row] extends [GamesPlayedRow] ? PerGameColumn : never;\n  readonly sort: SortDirection;\n}\n\nexport interface ColumnSort {\n  readonly columnId: string;\n  readonly direction: SortDirection;\n}\n\nexport interface ColumnPreset {\n  readonly id: string;\n  readonly label: string;\n  readonly columnIds: readonly string[];\n}\n\nexport interface ColumnCatalogBase<Row> {\n  readonly columns: readonly StatColumn<Row>[];\n  readonly defaultSort: readonly ColumnSort[];\n}\n\nexport interface PresetColumnCatalog<Row> extends ColumnCatalogBase<Row> {\n  readonly presets: readonly [ColumnPreset, ...ColumnPreset[]];\n  readonly defaultLayout?: never;\n}\n\nexport interface DefaultLayoutColumnCatalog<Row> extends ColumnCatalogBase<Row> {\n  readonly defaultLayout: readonly string[];\n  readonly presets?: never;\n}\n\nexport type ColumnCatalog<Row> = PresetColumnCatalog<Row> | DefaultLayoutColumnCatalog<Row>;\n\nexport const COLUMN_CATALOG_KEYS = ['playerTotals', 'gamePlayer', 'teamSeason'] as const;\nexport type ColumnCatalogKey = (typeof COLUMN_CATALOG_KEYS)[number];\n\nexport const GAMES_PLAYED_CATALOG_KEYS = [\n  'playerTotals',\n  'teamSeason',\n] as const satisfies readonly ColumnCatalogKey[];\nexport type GamesPlayedCatalogKey = (typeof GAMES_PLAYED_CATALOG_KEYS)[number];\n\nexport function perGameAverage(total: number, gamesPlayed: number): number | null {\n  return gamesPlayed === 0 ? null : total / gamesPlayed;\n}\n"]}

package/dist/sports/contribution.d.ts

@@ -2,11 +2,6 @@ import type { GameStats } from '../doc-schemas/sport-game.js';
 import type { LeagueType } from '../types/sports.js';
 import type { StatLineKind } from '../types/stats.js';
 import type { StatLineValues } from './scoring.js';
-/**
- * A completed game as its finalized record holds it: the record's events replayed to lines, and the
- * first page's sport, teams, and participation snapshot. Finalize builds it from the game it is
- * finalizing; every later path builds it from the record, never from the game document (RULE-QS-SPORT-924).
- */
 export interface FinalizedGame {
     readonly leagueType: LeagueType;
     readonly teamIds: readonly string[];
@@ -15,79 +10,28 @@ export interface FinalizedGame {
     readonly absentRosterPlayerIds: readonly string[];
     readonly nonScoringRosterPlayerIds: readonly string[];
 }
-/**
- * What one completed game adds to each destination, before the caller's sign. Every line carries its
- * derived fields through the sport's `deriveLine`.
- */
 export interface GameContribution {
-    /** Per team id: the team's standings line (`teamSeason`). A team with no opponent has none. */
     readonly teamLines: Readonly<Record<string, StatLineValues>>;
-    /** Per roster-entry id: that membership's row (`membershipRow`), credited to the team in its key. */
     readonly membershipRows: Readonly<Record<string, StatLineValues>>;
-    /**
-     * Per person who is not a ghost: the sum of that person's rows, games played included — what the
-     * game adds to `lifetimeStats.{sportKey}` and, where the sport keeps one, the hall of fame
-     * (`lifetime`). A person on both teams of the game counts both sides (RULE-QS-SPORT-928 keeps ghosts out).
-     */
     readonly personLines: Readonly<Record<string, StatLineValues>>;
 }
 export declare const EMPTY_GAME_CONTRIBUTION: GameContribution;
-/** One sport's aggregate mapping, declared once by its adapter (RULE-QS-SPORT-927). */
 export interface ContributionSpec {
-    /** The counters of a player line that a membership row, a lifetime line, and the hall of fame sum. */
     readonly playerStatKeys: readonly string[];
-    /** The player counters summed onto the team's standings line from the lines keyed to that team. */
     readonly teamSeasonPlayerSums: readonly string[];
-    /**
-     * Whether a present entry whose line holds nothing is credited no game played. Basketball's rule:
-     * zero points, rebounds, and assists — zero points alone is not exclusion. Without it only absence
-     * withholds a game played.
-     */
     readonly zeroLineIsNonScoring: boolean;
     readonly deriveLine: (kind: StatLineKind, line: StatLineValues) => StatLineValues;
 }
-/** Whether every number a line holds is zero: a derived line that sums to nothing. */
 export declare function isZeroStatLine(line: StatLineValues): boolean;
-/**
- * The games-played decision for every roster entry: the entries credited no game played. An absent
- * entry is never credited; under `zeroLineIsNonScoring` a present entry whose line holds nothing is
- * not either. Stored on the completed game as `nonScoringRosterPlayerIds` and read, never decided
- * again, by every later path (RULE-QS-SPORT-924). Returned in roster order.
- */
 export declare function decideParticipation(spec: Pick<ContributionSpec, 'playerStatKeys' | 'zeroLineIsNonScoring'>, stats: GameStats, rosterPlayerIds: readonly string[], absentRosterPlayerIds: readonly string[]): string[];
-/** Whether the stored decision credits the entry a game played. */
 export declare function isCreditedGamePlayed(game: Pick<FinalizedGame, 'absentRosterPlayerIds' | 'nonScoringRosterPlayerIds'>, entryId: string): boolean;
-/** `left` with every number of `right` added `sign` times; a field only one holds is kept. */
 export declare function addStatLines(left: StatLineValues, right: StatLineValues, sign?: 1 | -1): Record<string, number>;
-/**
- * The contribution of one completed game under a sport's mapping. Every line derives from the
- * replayed lines and the stored decision only, never from a stored total (RULE-QS-SPORT-922, RULE-QS-SPORT-924):
- *
- * - each team with an opponent: one game, a win, loss, or tie decided from the two replayed scores,
- *   its points for and against, and the spec's player counters summed from the lines keyed to it;
- * - each roster entry of such a team — and any line keyed to one, rostered or not, so no recorded
- *   stat is lost — its row: games played per the stored decision, and the sport's counters, credited
- *   to the team in its key;
- * - each person who is not a ghost: the sum of their rows.
- *
- * A row or person line that sums to nothing is left out.
- */
 export declare function buildGameContribution(spec: ContributionSpec, game: FinalizedGame): GameContribution;
-/** A contribution and the sign it is applied with: +1 to add a game, −1 to take it back. */
 export interface SignedContribution {
     readonly contribution: GameContribution;
     readonly sign: 1 | -1;
 }
-/**
- * Several signed contributions folded into one, every line through the sport's `deriveLine` and a
- * line that sums to nothing left out — the week view's rows, a rebuild's totals, and a ghost link's
- * reversal of the old entries beside the merged one, all through the same arithmetic.
- */
 export declare function sumGameContributions(deriveLine: ContributionSpec['deriveLine'], signed: readonly SignedContribution[]): GameContribution;
-/**
- * A stored line moved by a delta: the line after, `null` when it sums to nothing, or the field that
- * would go below zero.
- */
 export type StatLineChange = {
     readonly ok: true;
     readonly after: StatLineValues | null;
@@ -96,9 +40,8 @@ export type StatLineChange = {
     readonly field: string;
 };
 /**
- * `before` (absent read as no line) moved by `delta` times `sign`, through the sport's `deriveLine`
- * for `kind`. A counter that would go below zero is refused, never clamped: it means the stored line
- * no longer holds what the games put there.
+ * A counter that would go below zero is refused, never clamped: it means the stored line no longer
+ * holds what the games put there.
  */
 export declare function applyStatLineDelta(deriveLine: ContributionSpec['deriveLine'], kind: StatLineKind, before: StatLineValues | undefined, delta: StatLineValues, sign: 1 | -1): StatLineChange;
 //# sourceMappingURL=contribution.d.ts.map

package/dist/sports/contribution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contribution.d.ts","sourceRoot":"","sources":["../../src/sports/contribution.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"contribution.d.ts","sourceRoot":"","sources":["../../src/sports/contribution.ts"],"names":[],"mappings":"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"}

package/dist/sports/contribution.js

@@ -1,17 +1,3 @@
-// The aggregate half of the sport adapter contract: who a completed game credits a game played, and
-// what the game adds to every derived destination (RULE-QS-SPORT-921, RULE-QS-SPORT-924, RULE-QS-SPORT-927). Each sport
-// declares its mapping once, as a `ContributionSpec`; the two members built from it — `participation`
-// and `contribution` — are the only place a game's effect on standings, per-membership rows, lifetime
-// lines, and the hall of fame is decided. Finalize, reopen, a ghost link, every rebuild, validation,
-// and the week view all derive through them, so no two paths can disagree about what a game adds.
-//
-// Everything here is pure: no Firestore operation, no clock, no id minted (RULE-STD-ARCH-202). The aggregate
-// writer in Functions applies a contribution; the browser sums contributions for the week view.
-//
-// A stored derived line that sums to nothing — every counter and games played zero — is the same as
-// no line at all, as an all-zero player line is in a game's rollup: a contribution leaves one out,
-// and applying a contribution removes a line it returns to zero. That is what makes finalize followed
-// by reopen leave every destination exactly as it was.
 import { parseGameRosterPlayerId } from '../ids/compound-ids.js';
 import { isGhostUserId } from '../ids/minted-ids.js';
 import { isAllZeroLine } from './scoring.js';
@@ -20,21 +6,13 @@ export const EMPTY_GAME_CONTRIBUTION = {
     membershipRows: {},
     personLines: {},
 };
-/** The value of a counter on a stored line, absent read as zero. */
 function counter(line, field) {
     const value = line?.[field];
     return typeof value === 'number' ? value : 0;
 }
-/** Whether every number a line holds is zero: a derived line that sums to nothing. */
 export function isZeroStatLine(line) {
     return Object.values(line).every((value) => typeof value !== 'number' || value === 0);
 }
-/**
- * The games-played decision for every roster entry: the entries credited no game played. An absent
- * entry is never credited; under `zeroLineIsNonScoring` a present entry whose line holds nothing is
- * not either. Stored on the completed game as `nonScoringRosterPlayerIds` and read, never decided
- * again, by every later path (RULE-QS-SPORT-924). Returned in roster order.
- */
 export function decideParticipation(spec, stats, rosterPlayerIds, absentRosterPlayerIds) {
     if (!spec.zeroLineIsNonScoring)
         return [];
@@ -47,12 +25,10 @@ export function decideParticipation(spec, stats, rosterPlayerIds, absentRosterPl
         return line === undefined || isAllZeroLine(line, spec.playerStatKeys);
     });
 }
-/** Whether the stored decision credits the entry a game played. */
 export function isCreditedGamePlayed(game, entryId) {
     return (!game.absentRosterPlayerIds.includes(entryId) &&
         !game.nonScoringRosterPlayerIds.includes(entryId));
 }
-/** `left` with every number of `right` added `sign` times; a field only one holds is kept. */
 export function addStatLines(left, right, sign = 1) {
     const sum = {};
     for (const field of new Set([...Object.keys(left), ...Object.keys(right)])) {
@@ -63,19 +39,6 @@ export function addStatLines(left, right, sign = 1) {
     }
     return sum;
 }
-/**
- * The contribution of one completed game under a sport's mapping. Every line derives from the
- * replayed lines and the stored decision only, never from a stored total (RULE-QS-SPORT-922, RULE-QS-SPORT-924):
- *
- * - each team with an opponent: one game, a win, loss, or tie decided from the two replayed scores,
- *   its points for and against, and the spec's player counters summed from the lines keyed to it;
- * - each roster entry of such a team — and any line keyed to one, rostered or not, so no recorded
- *   stat is lost — its row: games played per the stored decision, and the sport's counters, credited
- *   to the team in its key;
- * - each person who is not a ghost: the sum of their rows.
- *
- * A row or person line that sums to nothing is left out.
- */
 export function buildGameContribution(spec, game) {
     const teamStats = game.stats.teamStats;
     const playerStats = game.stats.playerStats;
@@ -127,11 +90,6 @@ export function buildGameContribution(spec, game) {
         personLines[userId] = spec.deriveLine('lifetime', line);
     return { teamLines, membershipRows, personLines };
 }
-/**
- * Several signed contributions folded into one, every line through the sport's `deriveLine` and a
- * line that sums to nothing left out — the week view's rows, a rebuild's totals, and a ghost link's
- * reversal of the old entries beside the merged one, all through the same arithmetic.
- */
 export function sumGameContributions(deriveLine, signed) {
     const fold = (pick, kind) => {
         const totals = new Map();
@@ -155,9 +113,8 @@ export function sumGameContributions(deriveLine, signed) {
     };
 }
 /**
- * `before` (absent read as no line) moved by `delta` times `sign`, through the sport's `deriveLine`
- * for `kind`. A counter that would go below zero is refused, never clamped: it means the stored line
- * no longer holds what the games put there.
+ * A counter that would go below zero is refused, never clamped: it means the stored line no longer
+ * holds what the games put there.
  */
 export function applyStatLineDelta(deriveLine, kind, before, delta, sign) {
     // A derived field is recomputed from the moved counters, never moved itself, so a stale stored FP

package/dist/sports/contribution.js.map

@@ -1 +1 @@
-{"version":3,"file":"contribution.js","sourceRoot":"","sources":["../../src/sports/contribution.ts"],"names":[],"mappings":"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","sourcesContent":["// The aggregate half of the sport adapter contract: who a completed game credits a game played, and\n// what the game adds to every derived destination (RULE-QS-SPORT-921, RULE-QS-SPORT-924, RULE-QS-SPORT-927). Each sport\n// declares its mapping once, as a `ContributionSpec`; the two members built from it — `participation`\n// and `contribution` — are the only place a game's effect on standings, per-membership rows, lifetime\n// lines, and the hall of fame is decided. Finalize, reopen, a ghost link, every rebuild, validation,\n// and the week view all derive through them, so no two paths can disagree about what a game adds.\n//\n// Everything here is pure: no Firestore operation, no clock, no id minted (RULE-STD-ARCH-202). The aggregate\n// writer in Functions applies a contribution; the browser sums contributions for the week view.\n//\n// A stored derived line that sums to nothing — every counter and games played zero — is the same as\n// no line at all, as an all-zero player line is in a game's rollup: a contribution leaves one out,\n// and applying a contribution removes a line it returns to zero. That is what makes finalize followed\n// by reopen leave every destination exactly as it was.\n\nimport type { GameStats } from '../doc-schemas/sport-game.js';\nimport { parseGameRosterPlayerId } from '../ids/compound-ids.js';\nimport { isGhostUserId } from '../ids/minted-ids.js';\nimport type { LeagueType } from '../types/sports.js';\nimport type { StatLineKind } from '../types/stats.js';\nimport { isAllZeroLine } from './scoring.js';\nimport type { StatLineValues } from './scoring.js';\n\n/**\n * A completed game as its finalized record holds it: the record's events replayed to lines, and the\n * first page's sport, teams, and participation snapshot. Finalize builds it from the game it is\n * finalizing; every later path builds it from the record, never from the game document (RULE-QS-SPORT-924).\n */\nexport interface FinalizedGame {\n  readonly leagueType: LeagueType;\n  readonly teamIds: readonly string[];\n  readonly stats: GameStats;\n  readonly rosterPlayerIds: readonly string[];\n  readonly absentRosterPlayerIds: readonly string[];\n  readonly nonScoringRosterPlayerIds: readonly string[];\n}\n\n/**\n * What one completed game adds to each destination, before the caller's sign. Every line carries its\n * derived fields through the sport's `deriveLine`.\n */\nexport interface GameContribution {\n  /** Per team id: the team's standings line (`teamSeason`). A team with no opponent has none. */\n  readonly teamLines: Readonly<Record<string, StatLineValues>>;\n  /** Per roster-entry id: that membership's row (`membershipRow`), credited to the team in its key. */\n  readonly membershipRows: Readonly<Record<string, StatLineValues>>;\n  /**\n   * Per person who is not a ghost: the sum of that person's rows, games played included — what the\n   * game adds to `lifetimeStats.{sportKey}` and, where the sport keeps one, the hall of fame\n   * (`lifetime`). A person on both teams of the game counts both sides (RULE-QS-SPORT-928 keeps ghosts out).\n   */\n  readonly personLines: Readonly<Record<string, StatLineValues>>;\n}\n\nexport const EMPTY_GAME_CONTRIBUTION: GameContribution = {\n  teamLines: {},\n  membershipRows: {},\n  personLines: {},\n};\n\n/** One sport's aggregate mapping, declared once by its adapter (RULE-QS-SPORT-927). */\nexport interface ContributionSpec {\n  /** The counters of a player line that a membership row, a lifetime line, and the hall of fame sum. */\n  readonly playerStatKeys: readonly string[];\n  /** The player counters summed onto the team's standings line from the lines keyed to that team. */\n  readonly teamSeasonPlayerSums: readonly string[];\n  /**\n   * Whether a present entry whose line holds nothing is credited no game played. Basketball's rule:\n   * zero points, rebounds, and assists — zero points alone is not exclusion. Without it only absence\n   * withholds a game played.\n   */\n  readonly zeroLineIsNonScoring: boolean;\n  readonly deriveLine: (kind: StatLineKind, line: StatLineValues) => StatLineValues;\n}\n\n/** The value of a counter on a stored line, absent read as zero. */\nfunction counter(line: StatLineValues | undefined, field: string): number {\n  const value = line?.[field];\n  return typeof value === 'number' ? value : 0;\n}\n\n/** Whether every number a line holds is zero: a derived line that sums to nothing. */\nexport function isZeroStatLine(line: StatLineValues): boolean {\n  return Object.values(line).every((value) => typeof value !== 'number' || value === 0);\n}\n\n/**\n * The games-played decision for every roster entry: the entries credited no game played. An absent\n * entry is never credited; under `zeroLineIsNonScoring` a present entry whose line holds nothing is\n * not either. Stored on the completed game as `nonScoringRosterPlayerIds` and read, never decided\n * again, by every later path (RULE-QS-SPORT-924). Returned in roster order.\n */\nexport function decideParticipation(\n  spec: Pick<ContributionSpec, 'playerStatKeys' | 'zeroLineIsNonScoring'>,\n  stats: GameStats,\n  rosterPlayerIds: readonly string[],\n  absentRosterPlayerIds: readonly string[],\n): string[] {\n  if (!spec.zeroLineIsNonScoring) return [];\n  const absent = new Set(absentRosterPlayerIds);\n  const playerStats = stats.playerStats as Readonly<Record<string, StatLineValues>>;\n  return rosterPlayerIds.filter((entryId) => {\n    if (absent.has(entryId)) return true;\n    const line = playerStats[entryId];\n    return line === undefined || isAllZeroLine(line, spec.playerStatKeys);\n  });\n}\n\n/** Whether the stored decision credits the entry a game played. */\nexport function isCreditedGamePlayed(\n  game: Pick<FinalizedGame, 'absentRosterPlayerIds' | 'nonScoringRosterPlayerIds'>,\n  entryId: string,\n): boolean {\n  return (\n    !game.absentRosterPlayerIds.includes(entryId) &&\n    !game.nonScoringRosterPlayerIds.includes(entryId)\n  );\n}\n\n/** `left` with every number of `right` added `sign` times; a field only one holds is kept. */\nexport function addStatLines(\n  left: StatLineValues,\n  right: StatLineValues,\n  sign: 1 | -1 = 1,\n): Record<string, number> {\n  const sum: Record<string, number> = {};\n  for (const field of new Set([...Object.keys(left), ...Object.keys(right)])) {\n    const [a, b] = [left[field], right[field]];\n    if ((a !== undefined && typeof a !== 'number') || (b !== undefined && typeof b !== 'number'))\n      continue;\n    sum[field] = (a ?? 0) + sign * (b ?? 0);\n  }\n  return sum;\n}\n\n/**\n * The contribution of one completed game under a sport's mapping. Every line derives from the\n * replayed lines and the stored decision only, never from a stored total (RULE-QS-SPORT-922, RULE-QS-SPORT-924):\n *\n * - each team with an opponent: one game, a win, loss, or tie decided from the two replayed scores,\n *   its points for and against, and the spec's player counters summed from the lines keyed to it;\n * - each roster entry of such a team — and any line keyed to one, rostered or not, so no recorded\n *   stat is lost — its row: games played per the stored decision, and the sport's counters, credited\n *   to the team in its key;\n * - each person who is not a ghost: the sum of their rows.\n *\n * A row or person line that sums to nothing is left out.\n */\nexport function buildGameContribution(\n  spec: ContributionSpec,\n  game: FinalizedGame,\n): GameContribution {\n  const teamStats = game.stats.teamStats as Readonly<Record<string, StatLineValues>>;\n  const playerStats = game.stats.playerStats as Readonly<Record<string, StatLineValues>>;\n  const opponentOf = (teamId: string): string | undefined =>\n    game.teamIds.find((other) => other !== teamId);\n  const counted = new Set(game.teamIds.filter((teamId) => opponentOf(teamId) !== undefined));\n\n  const teamLines: Record<string, StatLineValues> = {};\n  for (const teamId of counted) {\n    const scored = counter(teamStats[teamId], 'score');\n    const allowed = counter(teamStats[opponentOf(teamId) as string], 'score');\n    const line: Record<string, number> = {\n      gamesPlayed: 1,\n      wins: scored > allowed ? 1 : 0,\n      losses: scored < allowed ? 1 : 0,\n      ties: scored === allowed ? 1 : 0,\n      pointsFor: scored,\n      pointsAgainst: allowed,\n    };\n    for (const field of spec.teamSeasonPlayerSums) line[field] = 0;\n    for (const [entryId, playerLine] of Object.entries(playerStats)) {\n      if (parseGameRosterPlayerId(entryId)?.teamId !== teamId) continue;\n      for (const field of spec.teamSeasonPlayerSums)\n        line[field] = (line[field] ?? 0) + counter(playerLine, field);\n    }\n    teamLines[teamId] = spec.deriveLine('teamSeason', line);\n  }\n\n  const membershipRows: Record<string, StatLineValues> = {};\n  const personTotals = new Map<string, Record<string, number>>();\n  const entryIds = [...new Set([...game.rosterPlayerIds, ...Object.keys(playerStats)])].sort();\n  for (const entryId of entryIds) {\n    const entry = parseGameRosterPlayerId(entryId);\n    if (entry === null || !counted.has(entry.teamId)) continue;\n    const row: Record<string, number> = {\n      gamesPlayed: isCreditedGamePlayed(game, entryId) ? 1 : 0,\n    };\n    for (const field of spec.playerStatKeys) row[field] = counter(playerStats[entryId], field);\n    if (isZeroStatLine(row)) continue;\n    membershipRows[entryId] = spec.deriveLine('membershipRow', row);\n    if (isGhostUserId(entry.userId)) continue;\n    personTotals.set(entry.userId, addStatLines(personTotals.get(entry.userId) ?? {}, row));\n  }\n\n  const personLines: Record<string, StatLineValues> = {};\n  for (const [userId, line] of personTotals)\n    personLines[userId] = spec.deriveLine('lifetime', line);\n  return { teamLines, membershipRows, personLines };\n}\n\n/** A contribution and the sign it is applied with: +1 to add a game, −1 to take it back. */\nexport interface SignedContribution {\n  readonly contribution: GameContribution;\n  readonly sign: 1 | -1;\n}\n\n/**\n * Several signed contributions folded into one, every line through the sport's `deriveLine` and a\n * line that sums to nothing left out — the week view's rows, a rebuild's totals, and a ghost link's\n * reversal of the old entries beside the merged one, all through the same arithmetic.\n */\nexport function sumGameContributions(\n  deriveLine: ContributionSpec['deriveLine'],\n  signed: readonly SignedContribution[],\n): GameContribution {\n  const fold = (\n    pick: (contribution: GameContribution) => Readonly<Record<string, StatLineValues>>,\n    kind: StatLineKind,\n  ) => {\n    const totals = new Map<string, Record<string, number>>();\n    for (const { contribution, sign } of signed) {\n      for (const [key, line] of Object.entries(pick(contribution))) {\n        totals.set(key, addStatLines(totals.get(key) ?? {}, line, sign));\n      }\n    }\n    const lines: Record<string, StatLineValues> = {};\n    for (const [key, line] of totals) {\n      const derived = deriveLine(kind, line);\n      if (!isZeroStatLine(derived)) lines[key] = derived;\n    }\n    return lines;\n  };\n  return {\n    teamLines: fold((contribution) => contribution.teamLines, 'teamSeason'),\n    membershipRows: fold((contribution) => contribution.membershipRows, 'membershipRow'),\n    personLines: fold((contribution) => contribution.personLines, 'lifetime'),\n  };\n}\n\n/**\n * A stored line moved by a delta: the line after, `null` when it sums to nothing, or the field that\n * would go below zero.\n */\nexport type StatLineChange =\n  | { readonly ok: true; readonly after: StatLineValues | null }\n  | { readonly ok: false; readonly field: string };\n\n/**\n * `before` (absent read as no line) moved by `delta` times `sign`, through the sport's `deriveLine`\n * for `kind`. A counter that would go below zero is refused, never clamped: it means the stored line\n * no longer holds what the games put there.\n */\nexport function applyStatLineDelta(\n  deriveLine: ContributionSpec['deriveLine'],\n  kind: StatLineKind,\n  before: StatLineValues | undefined,\n  delta: StatLineValues,\n  sign: 1 | -1,\n): StatLineChange {\n  // A derived field is recomputed from the moved counters, never moved itself, so a stale stored FP\n  // can neither go below zero nor survive.\n  const after = deriveLine(kind, addStatLines(before ?? {}, delta, sign));\n  const below = Object.entries(after).find(([, value]) => typeof value === 'number' && value < 0);\n  if (below) return { ok: false, field: below[0] };\n  return { ok: true, after: isZeroStatLine(after) ? null : after };\n}\n"]}
+{"version":3,"file":"contribution.js","sourceRoot":"","sources":["../../src/sports/contribution.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GameStats } from '../doc-schemas/sport-game.js';\nimport { parseGameRosterPlayerId } from '../ids/compound-ids.js';\nimport { isGhostUserId } from '../ids/minted-ids.js';\nimport type { LeagueType } from '../types/sports.js';\nimport type { StatLineKind } from '../types/stats.js';\nimport { isAllZeroLine } from './scoring.js';\nimport type { StatLineValues } from './scoring.js';\n\nexport interface FinalizedGame {\n  readonly leagueType: LeagueType;\n  readonly teamIds: readonly string[];\n  readonly stats: GameStats;\n  readonly rosterPlayerIds: readonly string[];\n  readonly absentRosterPlayerIds: readonly string[];\n  readonly nonScoringRosterPlayerIds: readonly string[];\n}\n\nexport interface GameContribution {\n  readonly teamLines: Readonly<Record<string, StatLineValues>>;\n  readonly membershipRows: Readonly<Record<string, StatLineValues>>;\n  readonly personLines: Readonly<Record<string, StatLineValues>>;\n}\n\nexport const EMPTY_GAME_CONTRIBUTION: GameContribution = {\n  teamLines: {},\n  membershipRows: {},\n  personLines: {},\n};\n\nexport interface ContributionSpec {\n  readonly playerStatKeys: readonly string[];\n  readonly teamSeasonPlayerSums: readonly string[];\n  readonly zeroLineIsNonScoring: boolean;\n  readonly deriveLine: (kind: StatLineKind, line: StatLineValues) => StatLineValues;\n}\n\nfunction counter(line: StatLineValues | undefined, field: string): number {\n  const value = line?.[field];\n  return typeof value === 'number' ? value : 0;\n}\n\nexport function isZeroStatLine(line: StatLineValues): boolean {\n  return Object.values(line).every((value) => typeof value !== 'number' || value === 0);\n}\n\nexport function decideParticipation(\n  spec: Pick<ContributionSpec, 'playerStatKeys' | 'zeroLineIsNonScoring'>,\n  stats: GameStats,\n  rosterPlayerIds: readonly string[],\n  absentRosterPlayerIds: readonly string[],\n): string[] {\n  if (!spec.zeroLineIsNonScoring) return [];\n  const absent = new Set(absentRosterPlayerIds);\n  const playerStats = stats.playerStats as Readonly<Record<string, StatLineValues>>;\n  return rosterPlayerIds.filter((entryId) => {\n    if (absent.has(entryId)) return true;\n    const line = playerStats[entryId];\n    return line === undefined || isAllZeroLine(line, spec.playerStatKeys);\n  });\n}\n\nexport function isCreditedGamePlayed(\n  game: Pick<FinalizedGame, 'absentRosterPlayerIds' | 'nonScoringRosterPlayerIds'>,\n  entryId: string,\n): boolean {\n  return (\n    !game.absentRosterPlayerIds.includes(entryId) &&\n    !game.nonScoringRosterPlayerIds.includes(entryId)\n  );\n}\n\nexport function addStatLines(\n  left: StatLineValues,\n  right: StatLineValues,\n  sign: 1 | -1 = 1,\n): Record<string, number> {\n  const sum: Record<string, number> = {};\n  for (const field of new Set([...Object.keys(left), ...Object.keys(right)])) {\n    const [a, b] = [left[field], right[field]];\n    if ((a !== undefined && typeof a !== 'number') || (b !== undefined && typeof b !== 'number'))\n      continue;\n    sum[field] = (a ?? 0) + sign * (b ?? 0);\n  }\n  return sum;\n}\n\nexport function buildGameContribution(\n  spec: ContributionSpec,\n  game: FinalizedGame,\n): GameContribution {\n  const teamStats = game.stats.teamStats as Readonly<Record<string, StatLineValues>>;\n  const playerStats = game.stats.playerStats as Readonly<Record<string, StatLineValues>>;\n  const opponentOf = (teamId: string): string | undefined =>\n    game.teamIds.find((other) => other !== teamId);\n  const counted = new Set(game.teamIds.filter((teamId) => opponentOf(teamId) !== undefined));\n\n  const teamLines: Record<string, StatLineValues> = {};\n  for (const teamId of counted) {\n    const scored = counter(teamStats[teamId], 'score');\n    const allowed = counter(teamStats[opponentOf(teamId) as string], 'score');\n    const line: Record<string, number> = {\n      gamesPlayed: 1,\n      wins: scored > allowed ? 1 : 0,\n      losses: scored < allowed ? 1 : 0,\n      ties: scored === allowed ? 1 : 0,\n      pointsFor: scored,\n      pointsAgainst: allowed,\n    };\n    for (const field of spec.teamSeasonPlayerSums) line[field] = 0;\n    for (const [entryId, playerLine] of Object.entries(playerStats)) {\n      if (parseGameRosterPlayerId(entryId)?.teamId !== teamId) continue;\n      for (const field of spec.teamSeasonPlayerSums)\n        line[field] = (line[field] ?? 0) + counter(playerLine, field);\n    }\n    teamLines[teamId] = spec.deriveLine('teamSeason', line);\n  }\n\n  const membershipRows: Record<string, StatLineValues> = {};\n  const personTotals = new Map<string, Record<string, number>>();\n  const entryIds = [...new Set([...game.rosterPlayerIds, ...Object.keys(playerStats)])].sort();\n  for (const entryId of entryIds) {\n    const entry = parseGameRosterPlayerId(entryId);\n    if (entry === null || !counted.has(entry.teamId)) continue;\n    const row: Record<string, number> = {\n      gamesPlayed: isCreditedGamePlayed(game, entryId) ? 1 : 0,\n    };\n    for (const field of spec.playerStatKeys) row[field] = counter(playerStats[entryId], field);\n    if (isZeroStatLine(row)) continue;\n    membershipRows[entryId] = spec.deriveLine('membershipRow', row);\n    if (isGhostUserId(entry.userId)) continue;\n    personTotals.set(entry.userId, addStatLines(personTotals.get(entry.userId) ?? {}, row));\n  }\n\n  const personLines: Record<string, StatLineValues> = {};\n  for (const [userId, line] of personTotals)\n    personLines[userId] = spec.deriveLine('lifetime', line);\n  return { teamLines, membershipRows, personLines };\n}\n\nexport interface SignedContribution {\n  readonly contribution: GameContribution;\n  readonly sign: 1 | -1;\n}\n\nexport function sumGameContributions(\n  deriveLine: ContributionSpec['deriveLine'],\n  signed: readonly SignedContribution[],\n): GameContribution {\n  const fold = (\n    pick: (contribution: GameContribution) => Readonly<Record<string, StatLineValues>>,\n    kind: StatLineKind,\n  ) => {\n    const totals = new Map<string, Record<string, number>>();\n    for (const { contribution, sign } of signed) {\n      for (const [key, line] of Object.entries(pick(contribution))) {\n        totals.set(key, addStatLines(totals.get(key) ?? {}, line, sign));\n      }\n    }\n    const lines: Record<string, StatLineValues> = {};\n    for (const [key, line] of totals) {\n      const derived = deriveLine(kind, line);\n      if (!isZeroStatLine(derived)) lines[key] = derived;\n    }\n    return lines;\n  };\n  return {\n    teamLines: fold((contribution) => contribution.teamLines, 'teamSeason'),\n    membershipRows: fold((contribution) => contribution.membershipRows, 'membershipRow'),\n    personLines: fold((contribution) => contribution.personLines, 'lifetime'),\n  };\n}\n\nexport type StatLineChange =\n  | { readonly ok: true; readonly after: StatLineValues | null }\n  | { readonly ok: false; readonly field: string };\n\n/**\n * A counter that would go below zero is refused, never clamped: it means the stored line no longer\n * holds what the games put there.\n */\nexport function applyStatLineDelta(\n  deriveLine: ContributionSpec['deriveLine'],\n  kind: StatLineKind,\n  before: StatLineValues | undefined,\n  delta: StatLineValues,\n  sign: 1 | -1,\n): StatLineChange {\n  // A derived field is recomputed from the moved counters, never moved itself, so a stale stored FP\n  // can neither go below zero nor survive.\n  const after = deriveLine(kind, addStatLines(before ?? {}, delta, sign));\n  const below = Object.entries(after).find(([, value]) => typeof value === 'number' && value < 0);\n  if (below) return { ok: false, field: below[0] };\n  return { ok: true, after: isZeroStatLine(after) ? null : after };\n}\n"]}

package/dist/sports/curling-scoring.d.ts

@@ -2,7 +2,6 @@ import type { CurlingTeamStats, GameStatEvent } from '../doc-schemas/game-stats.
 import { type RoundsBulkEntry } from './bulk-entry.js';
 import { type SportScoring } from './scoring.js';
 import { type RoundsDisplay, type RoundsScoringPanel, type Scoreboard, type StatEventNameResolver } from './scoring-display.js';
-/** Every round unrecorded — `null`, where a blank round is `0`. */
 export declare function emptyCurlingTeamLine(): CurlingTeamStats;
 export declare const CURLING_SCORING: SportScoring;
 export declare const CURLING_ROUNDS: RoundsDisplay;

package/dist/sports/curling-scoring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"curling-scoring.d.ts","sourceRoot":"","sources":["../../src/sports/curling-scoring.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AASpF,OAAO,EAIL,KAAK,eAAe,EAGrB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EASL,KAAK,YAAY,EAGlB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAEf,KAAK,qBAAqB,EAE3B,MAAM,sBAAsB,CAAC;AA4B9B,mEAAmE;AACnE,wBAAgB,oBAAoB,IAAI,gBAAgB,CAGvD;AA+ED,eAAO,MAAM,eAAe,EAAE,YAqB7B,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,aAA8D,CAAC;AAE5F,eAAO,MAAM,oBAAoB;;;;;;;;;CAGgC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;;CAG8B,CAAC;AAEhE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAQjG;AAED,eAAO,MAAM,kBAAkB,EAAE,UAIhC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,kBAKnC,CAAC;AAMF,eAAO,MAAM,4BAA4B,oCAA8D,CAAC;AACxG,eAAO,MAAM,gCAAgC,mGACqD,CAAC;AACnG,eAAO,MAAM,gCAAgC,qEACuB,CAAC;AA4ErE,eAAO,MAAM,kBAAkB,EAAE,eA0ChC,CAAC"}
+{"version":3,"file":"curling-scoring.d.ts","sourceRoot":"","sources":["../../src/sports/curling-scoring.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AASpF,OAAO,EAIL,KAAK,eAAe,EAGrB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EASL,KAAK,YAAY,EAGlB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EAEf,KAAK,qBAAqB,EAE3B,MAAM,sBAAsB,CAAC;AAsB9B,wBAAgB,oBAAoB,IAAI,gBAAgB,CAGvD;AAkED,eAAO,MAAM,eAAe,EAAE,YAoB7B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,aAA8D,CAAC;AAE5F,eAAO,MAAM,oBAAoB;;;;;;;;;CAGgC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;;CAG8B,CAAC;AAEhE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAQjG;AAED,eAAO,MAAM,kBAAkB,EAAE,UAIhC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,kBAKnC,CAAC;AAEF,eAAO,MAAM,4BAA4B,oCAA8D,CAAC;AACxG,eAAO,MAAM,gCAAgC,mGACqD,CAAC;AACnG,eAAO,MAAM,gCAAgC,qEACuB,CAAC;AA4ErE,eAAO,MAAM,kBAAkB,EAAE,eA0ChC,CAAC"}