@ttt-productions/q-core 0.1.28 → 0.1.29

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

@@ -1 +1 @@
-{"version":3,"file":"scoring-display.d.ts","sourceRoot":"","sources":["../../src/sports/scoring-display.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CAC3C;AAED,2FAA2F;AAC3F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,8FAA8F;AAC9F,MAAM,WAAW,eAAe,CAC9B,SAAS,SAAS,cAAc,EAChC,WAAW,SAAS,cAAc;IAElC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,sGAAsG;AACtG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,cAAc,EAAE,KAAK,MAAM,CAAC;CAC1F;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CAC9E;AAED,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,gGAAgG;AAChG,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACzD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACxD,iGAAiG;IACjG,QAAQ,CAAC,oBAAoB,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5D,QAAQ,CAAC,cAAc,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACvD;AAED,0CAA0C;AAC1C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACnD;AAED,gGAAgG;AAChG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IACnD,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,YAAY,GAAG,wBAAwB,GAAG,sBAAsB,GAAG,kBAAkB,CAAC;AAElG,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,qBAAqB,EAC9B,WAAW,EAAE;IACX,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1D,GACA,MAAM,GAAG,IAAI,CAUf"}
+{"version":3,"file":"scoring-display.d.ts","sourceRoot":"","sources":["../../src/sports/scoring-display.ts"],"names":[],"mappings":"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"}

package/dist/sports/scoring-display.js

@@ -1,17 +1,8 @@
-// What the scoring screen, the scoreboard, and the play-by-play render for a sport, declared by its
-// adapter so no shared surface branches on a sport (RULE-QS-SPORT-904, RULE-QS-SPORT-916). Every label lives here or
-// in the adapter, never in a component (RULE-STD-ENG-005).
 import { isStatCorrection, isStatVoid } from './scoring.js';
-/** A signed change as a play shows it: `+3`, `-2`. */
 export function formatSignedValue(value) {
     return value > 0 ? `+${value}` : String(value);
 }
 export const VOID_PLAY_DESCRIPTION = 'Undo of an earlier play';
-/**
- * The play-by-play line of a store-level event, the same for every sport: a correction names the
- * field it moved through the sport's field labels, and never reads as a play. `null` for a sport's
- * own event.
- */
 export function describeStoreEvent(event, resolve, fieldLabels) {
     if (isStatVoid(event))
         return VOID_PLAY_DESCRIPTION;

package/dist/sports/scoring-display.js.map

@@ -1 +1 @@
-{"version":3,"file":"scoring-display.js","sourceRoot":"","sources":["../../src/sports/scoring-display.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,qHAAqH;AACrH,2DAA2D;AAM3D,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAkF5D,sDAAsD;AACtD,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAoB,EACpB,OAA8B,EAC9B,WAGC;IAED,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,qBAAqB,CAAC;IACpD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;IACxF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;IAC/C,MAAM,IAAI,GACR,KAAK,CAAC,YAAY,KAAK,SAAS;QAC9B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5B,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;IAC9E,OAAO,GAAG,KAAK,iBAAiB,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;AAC/E,CAAC","sourcesContent":["// What the scoring screen, the scoreboard, and the play-by-play render for a sport, declared by its\n// adapter so no shared surface branches on a sport (RULE-QS-SPORT-904, RULE-QS-SPORT-916). Every label lives here or\n// in the adapter, never in a component (RULE-STD-ENG-005).\n\nimport type { GameStatEvent, GameStatEventType } from '../doc-schemas/game-stats.js';\nimport type { StatCounterKey } from '../types/sports.js';\nimport type { ScoringPanelKind } from '../types/stats.js';\nimport type { GamePlayerLine, GameTeamLine } from './scoring.js';\nimport { isStatCorrection, isStatVoid } from './scoring.js';\n\n/**\n * Names read at render time (RULE-STD-ARCH-103, RULE-QS-SPORT-914): a person by user id — a removed ghost resolving to\n * \"removed player\" — and a team by team id. An event's stored name snapshot is never one of them.\n */\nexport interface StatEventNameResolver {\n  readonly player: (userId: string) => string;\n  readonly team: (teamId: string) => string;\n}\n\n/** An event type's button label on the scoring panel and its label in the play-by-play. */\nexport interface StatEventLabel {\n  readonly button: string;\n  readonly play: string;\n}\n\n/** Each field of a team line and of a player line, by label — what a correction row names. */\nexport interface StatFieldLabels<\n  TeamField extends StatCounterKey,\n  PlayerField extends StatCounterKey,\n> {\n  readonly team: Readonly<Record<TeamField, string>>;\n  readonly player: Readonly<Record<PlayerField, string>>;\n}\n\n/** One figure a team card shows: from the team's game line and the player lines keyed to its side. */\nexport interface ScoreboardFigure {\n  readonly id: string;\n  readonly label: string;\n  readonly value: (teamLine: GameTeamLine, sideLines: readonly GamePlayerLine[]) => number;\n}\n\n/**\n * The one scoreboard every game screen renders: each team's figures, the jump-ball marker where the\n * sport has one, and — for a sport played in rounds — each team's round-by-round grid.\n */\nexport interface Scoreboard {\n  readonly figures: readonly ScoreboardFigure[];\n  /**\n   * Whether the sport has a jump-ball possession marker: the team cards show it, and the game's\n   * scorers set it through its own writer, never a stat event.\n   */\n  readonly jumpBall: boolean;\n  /**\n   * Present only for a sport played in rounds: a team line's slot per round, `null` where the round\n   * is not recorded, so the grid tells an unplayed round from a scoreless one.\n   */\n  readonly roundSlots?: (teamLine: GameTeamLine) => readonly (number | null)[];\n}\n\n/** A sport played in rounds: how many, and what one is called (\"Round n / 14\"). */\nexport interface RoundsDisplay {\n  readonly count: number;\n  readonly label: string;\n}\n\n/** Pick a present player, then tap one of their events; the team row carries the team's own. */\nexport interface PlayerEventsScoringPanel {\n  readonly kind: Extract<ScoringPanelKind, 'playerEvents'>;\n  readonly playerEventTypes: readonly GameStatEventType[];\n  /** The events that open the assist picker: the team's other present players, and \"No assist\". */\n  readonly assistableEventTypes: readonly GameStatEventType[];\n  readonly teamEventTypes: readonly GameStatEventType[];\n}\n\n/** One button per event for each team. */\nexport interface TeamPointsScoringPanel {\n  readonly kind: Extract<ScoringPanelKind, 'teamPoints'>;\n  readonly eventTypes: readonly GameStatEventType[];\n}\n\n/** Each team's +1 through +`maxPoints` for the next round, and one button for a blank round. */\nexport interface RoundsScoringPanel {\n  readonly kind: Extract<ScoringPanelKind, 'rounds'>;\n  readonly scoreEventType: GameStatEventType;\n  readonly blankEventType: GameStatEventType;\n  readonly maxPoints: number;\n}\n\nexport type ScoringPanel = PlayerEventsScoringPanel | TeamPointsScoringPanel | RoundsScoringPanel;\n\n/** A signed change as a play shows it: `+3`, `-2`. */\nexport function formatSignedValue(value: number): string {\n  return value > 0 ? `+${value}` : String(value);\n}\n\nexport const VOID_PLAY_DESCRIPTION = 'Undo of an earlier play';\n\n/**\n * The play-by-play line of a store-level event, the same for every sport: a correction names the\n * field it moved through the sport's field labels, and never reads as a play. `null` for a sport's\n * own event.\n */\nexport function describeStoreEvent(\n  event: GameStatEvent,\n  resolve: StatEventNameResolver,\n  fieldLabels: {\n    readonly team: Partial<Record<StatCounterKey, string>>;\n    readonly player: Partial<Record<StatCounterKey, string>>;\n  },\n): string | null {\n  if (isStatVoid(event)) return VOID_PLAY_DESCRIPTION;\n  if (!isStatCorrection(event)) return null;\n  const labels = event.playerUserId === undefined ? fieldLabels.team : fieldLabels.player;\n  const field = labels[event.stat] ?? event.stat;\n  const line =\n    event.playerUserId === undefined\n      ? resolve.team(event.teamId)\n      : `${resolve.player(event.playerUserId)} (${resolve.team(event.teamId)})`;\n  return `${field} corrected by ${formatSignedValue(event.value)} for ${line}`;\n}\n"]}
+{"version":3,"file":"scoring-display.js","sourceRoot":"","sources":["../../src/sports/scoring-display.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA0D5D,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAE/D,MAAM,UAAU,kBAAkB,CAChC,KAAoB,EACpB,OAA8B,EAC9B,WAGC;IAED,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,qBAAqB,CAAC;IACpD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;IACxF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;IAC/C,MAAM,IAAI,GACR,KAAK,CAAC,YAAY,KAAK,SAAS;QAC9B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5B,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;IAC9E,OAAO,GAAG,KAAK,iBAAiB,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;AAC/E,CAAC","sourcesContent":["import type { GameStatEvent, GameStatEventType } from '../doc-schemas/game-stats.js';\nimport type { StatCounterKey } from '../types/sports.js';\nimport type { ScoringPanelKind } from '../types/stats.js';\nimport type { GamePlayerLine, GameTeamLine } from './scoring.js';\nimport { isStatCorrection, isStatVoid } from './scoring.js';\n\nexport interface StatEventNameResolver {\n  readonly player: (userId: string) => string;\n  readonly team: (teamId: string) => string;\n}\n\nexport interface StatEventLabel {\n  readonly button: string;\n  readonly play: string;\n}\n\nexport interface StatFieldLabels<\n  TeamField extends StatCounterKey,\n  PlayerField extends StatCounterKey,\n> {\n  readonly team: Readonly<Record<TeamField, string>>;\n  readonly player: Readonly<Record<PlayerField, string>>;\n}\n\nexport interface ScoreboardFigure {\n  readonly id: string;\n  readonly label: string;\n  readonly value: (teamLine: GameTeamLine, sideLines: readonly GamePlayerLine[]) => number;\n}\n\nexport interface Scoreboard {\n  readonly figures: readonly ScoreboardFigure[];\n  readonly jumpBall: boolean;\n  readonly roundSlots?: (teamLine: GameTeamLine) => readonly (number | null)[];\n}\n\nexport interface RoundsDisplay {\n  readonly count: number;\n  readonly label: string;\n}\n\nexport interface PlayerEventsScoringPanel {\n  readonly kind: Extract<ScoringPanelKind, 'playerEvents'>;\n  readonly playerEventTypes: readonly GameStatEventType[];\n  readonly assistableEventTypes: readonly GameStatEventType[];\n  readonly teamEventTypes: readonly GameStatEventType[];\n}\n\nexport interface TeamPointsScoringPanel {\n  readonly kind: Extract<ScoringPanelKind, 'teamPoints'>;\n  readonly eventTypes: readonly GameStatEventType[];\n}\n\nexport interface RoundsScoringPanel {\n  readonly kind: Extract<ScoringPanelKind, 'rounds'>;\n  readonly scoreEventType: GameStatEventType;\n  readonly blankEventType: GameStatEventType;\n  readonly maxPoints: number;\n}\n\nexport type ScoringPanel = PlayerEventsScoringPanel | TeamPointsScoringPanel | RoundsScoringPanel;\n\nexport function formatSignedValue(value: number): string {\n  return value > 0 ? `+${value}` : String(value);\n}\n\nexport const VOID_PLAY_DESCRIPTION = 'Undo of an earlier play';\n\nexport function describeStoreEvent(\n  event: GameStatEvent,\n  resolve: StatEventNameResolver,\n  fieldLabels: {\n    readonly team: Partial<Record<StatCounterKey, string>>;\n    readonly player: Partial<Record<StatCounterKey, string>>;\n  },\n): string | null {\n  if (isStatVoid(event)) return VOID_PLAY_DESCRIPTION;\n  if (!isStatCorrection(event)) return null;\n  const labels = event.playerUserId === undefined ? fieldLabels.team : fieldLabels.player;\n  const field = labels[event.stat] ?? event.stat;\n  const line =\n    event.playerUserId === undefined\n      ? resolve.team(event.teamId)\n      : `${resolve.player(event.playerUserId)} (${resolve.team(event.teamId)})`;\n  return `${field} corrected by ${formatSignedValue(event.value)} for ${line}`;\n}\n"]}

package/dist/sports/scoring.d.ts

@@ -6,11 +6,6 @@ import type { FinalizationNotReadyReason, StatEventRecorderField, StatEventRefus
 import type { FinalizedGame, GameContribution } from './contribution.js';
 import type { GameTeamIds } from './sport-adapter.js';
 type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
-/**
- * What an event says happened — its type and its payload. Its id, its `recordedAt`, and what the
- * writing core stamps on it are not part of it, so a stored event, a queued one, and a drafted one
- * are all bodies.
- */
 export type StatEventBody = DistributiveOmit<GameStatEvent, 'eventId' | 'recordedAt' | StatEventRecorderField | StatEventSnapshotField>;
 export type StatVoidBody = Extract<StatEventBody, {
     type: typeof STAT_VOID_EVENT_TYPE;
@@ -18,25 +13,17 @@ export type StatVoidBody = Extract<StatEventBody, {
 export type StatCorrectionBody = Extract<StatEventBody, {
     type: typeof STAT_CORRECTION_EVENT_TYPE;
 }>;
-/** One of a sport's own events, as opposed to the store-level void and correction. */
 export type SportStatEventBody = Exclude<StatEventBody, StatVoidBody | StatCorrectionBody>;
 export declare function isStatVoid(event: StatEventBody): event is StatVoidBody;
 export declare function isStatCorrection(event: StatEventBody): event is StatCorrectionBody;
-/** Whether `event` is one of the sport events `eventTypes` declares — never a void or a correction. */
 export declare function isSportStatEventIn(eventTypes: readonly string[], event: StatEventBody | undefined): event is SportStatEventBody;
-/** One team's line in a game's rollup, whichever sport it counts. */
 export type GameTeamLine = GameStats['teamStats'][string];
-/** One roster entry's line in a game's rollup, whichever sport it counts. */
 export type GamePlayerLine = GameStats['playerStats'][string];
-/** A stat line of any kind as `deriveLine` reads and returns it: its counters, derived fields, and ends. */
 export type StatLineValues = {
     readonly [field: string]: number | readonly (number | null)[];
 };
-/** The game an event is validated against: its teams, and the roster entries the batch names. */
 export interface StatEventRoster {
-    /** A team of the game is one of these — never inferred from which team lines a rollup holds. */
     readonly teamIds: readonly string[];
-    /** The roster entries the driver read for the batch — never the whole roster. */
     readonly rosterPlayerIds: ReadonlySet<string>;
 }
 export type StatEventVerdict = {
@@ -54,44 +41,21 @@ export type FinalizationReadiness = {
     readonly reason: FinalizationNotReadyReason;
 };
 export declare const FINALIZATION_READY: FinalizationReadiness;
-/** The fields a `STAT_CORRECTION` may change, on a team line and on a player line. */
 export interface CorrectableFields {
     readonly team: readonly StatCounterKey[];
     readonly player: readonly StatCounterKey[];
 }
 export interface SportScoring {
-    /**
-     * Whether a new event may be recorded against `state`: its type is the sport's, its team is one
-     * of the game's, every person it names is a roster entry of that team, and its values are a real
-     * result. Only the store driver calls it, and only for a new event — a replay never re-validates
-     * what was already accepted.
-     */
     readonly validate: (state: GameStats, event: StatEventBody, roster: StatEventRoster) => StatEventVerdict;
-    /**
-     * `state` with one sport event or one `STAT_CORRECTION` applied. A missing line is created from
-     * the sport's empty line (RULE-QS-SPORT-915); a player line whose counters all return to zero is dropped;
-     * a team line never is. Throws on a void, another sport's event, or a correction to a field not in
-     * `correctableFields`.
-     */
     readonly apply: (state: GameStats, event: StatEventBody) => GameStats;
-    /** The exact inverse of `apply(target)` for one of the sport's own events (RULE-QS-SPORT-913). */
     readonly undo: (state: GameStats, target: StatEventBody) => GameStats;
-    /** `line` with every derived field of its kind; the only caller of any derivation formula. */
     readonly deriveLine: (kind: StatLineKind, line: StatLineValues) => StatLineValues;
     readonly correctableFields: CorrectableFields;
-    /** The next round to record for a sport played in rounds, `null` once all are or for any other sport. */
     readonly nextRound: (state: GameStats) => number | null;
-    /** Whether the game may be finalized (RULE-QS-SPORT-922). */
     readonly finalizationReadiness: (state: GameStats, game: GameTeamIds) => FinalizationReadiness;
-    /**
-     * The games-played decision finalize stores: the roster entries credited no game played, from
-     * each entry's own line and absence, in roster order (RULE-QS-SPORT-924).
-     */
     readonly participation: (state: GameStats, rosterPlayerIds: readonly string[], absentRosterPlayerIds: readonly string[]) => string[];
-    /** What a completed game adds to every derived destination (RULE-QS-SPORT-927). */
     readonly contribution: (game: FinalizedGame) => GameContribution;
 }
-/** Whether every counter of a line is zero — a player line the rollup then leaves out. */
 export declare function isAllZeroLine(line: StatLineValues, counterKeys: readonly string[]): boolean;
 export {};
 //# sourceMappingURL=scoring.d.ts.map

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

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

package/dist/sports/scoring.js

@@ -1,11 +1,3 @@
-// The scoring half of the sport adapter contract: the pure members the store driver, the replay, the
-// client's optimistic queue, and the aggregate cores call (RULE-QS-SPORT-903). None issues a Firestore
-// operation or an increment, reads a clock, or mints an id.
-//
-// Every member is typed over every sport's shapes, so any registered adapter is called the same way.
-// The registry chose the adapter by the game's `leagueType`, which is what makes the rollup it is
-// handed that sport's (RULE-QS-SPORT-902); an event of another sport is refused by `validate` and thrown on
-// by `apply` and `undo`, never guessed at.
 import { STAT_CORRECTION_EVENT_TYPE, STAT_VOID_EVENT_TYPE } from '../types/stats.js';
 export function isStatVoid(event) {
     return event.type === STAT_VOID_EVENT_TYPE;
@@ -13,7 +5,6 @@ export function isStatVoid(event) {
 export function isStatCorrection(event) {
     return event.type === STAT_CORRECTION_EVENT_TYPE;
 }
-/** Whether `event` is one of the sport events `eventTypes` declares — never a void or a correction. */
 export function isSportStatEventIn(eventTypes, event) {
     return event !== undefined && eventTypes.includes(event.type);
 }
@@ -22,7 +13,6 @@ export function refuseStatEvent(code) {
     return { ok: false, code };
 }
 export const FINALIZATION_READY = { ready: true };
-/** Whether every counter of a line is zero — a player line the rollup then leaves out. */
 export function isAllZeroLine(line, counterKeys) {
     return counterKeys.every((key) => line[key] === 0 || line[key] === undefined);
 }

package/dist/sports/scoring.js.map

@@ -1 +1 @@
-{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../../src/sports/scoring.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,uGAAuG;AACvG,4DAA4D;AAC5D,EAAE;AACF,qGAAqG;AACrG,kGAAkG;AAClG,4GAA4G;AAC5G,2CAA2C;AAK3C,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AA8BrF,MAAM,UAAU,UAAU,CAAC,KAAoB;IAC7C,OAAO,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,OAAO,KAAK,CAAC,IAAI,KAAK,0BAA0B,CAAC;AACnD,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,kBAAkB,CAChC,UAA6B,EAC7B,KAAgC;IAEhC,OAAO,KAAK,KAAK,SAAS,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAqBD,MAAM,CAAC,MAAM,mBAAmB,GAAqB,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AAElE,MAAM,UAAU,eAAe,CAAC,IAA0B;IACxD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC;AAKD,MAAM,CAAC,MAAM,kBAAkB,GAA0B,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAiDzE,0FAA0F;AAC1F,MAAM,UAAU,aAAa,CAAC,IAAoB,EAAE,WAA8B;IAChF,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;AAChF,CAAC","sourcesContent":["// The scoring half of the sport adapter contract: the pure members the store driver, the replay, the\n// client's optimistic queue, and the aggregate cores call (RULE-QS-SPORT-903). None issues a Firestore\n// operation or an increment, reads a clock, or mints an id.\n//\n// Every member is typed over every sport's shapes, so any registered adapter is called the same way.\n// The registry chose the adapter by the game's `leagueType`, which is what makes the rollup it is\n// handed that sport's (RULE-QS-SPORT-902); an event of another sport is refused by `validate` and thrown on\n// by `apply` and `undo`, never guessed at.\n\nimport type { GameStatEvent } from '../doc-schemas/game-stats.js';\nimport type { GameStats } from '../doc-schemas/sport-game.js';\nimport type { StatCounterKey } from '../types/sports.js';\nimport { STAT_CORRECTION_EVENT_TYPE, STAT_VOID_EVENT_TYPE } from '../types/stats.js';\nimport type {\n  FinalizationNotReadyReason,\n  StatEventRecorderField,\n  StatEventRefusalCode,\n  StatEventSnapshotField,\n  StatLineKind,\n} from '../types/stats.js';\nimport type { FinalizedGame, GameContribution } from './contribution.js';\nimport type { GameTeamIds } from './sport-adapter.js';\n\ntype DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;\n\n/**\n * What an event says happened — its type and its payload. Its id, its `recordedAt`, and what the\n * writing core stamps on it are not part of it, so a stored event, a queued one, and a drafted one\n * are all bodies.\n */\nexport type StatEventBody = DistributiveOmit<\n  GameStatEvent,\n  'eventId' | 'recordedAt' | StatEventRecorderField | StatEventSnapshotField\n>;\nexport type StatVoidBody = Extract<StatEventBody, { type: typeof STAT_VOID_EVENT_TYPE }>;\nexport type StatCorrectionBody = Extract<\n  StatEventBody,\n  { type: typeof STAT_CORRECTION_EVENT_TYPE }\n>;\n/** One of a sport's own events, as opposed to the store-level void and correction. */\nexport type SportStatEventBody = Exclude<StatEventBody, StatVoidBody | StatCorrectionBody>;\n\nexport function isStatVoid(event: StatEventBody): event is StatVoidBody {\n  return event.type === STAT_VOID_EVENT_TYPE;\n}\n\nexport function isStatCorrection(event: StatEventBody): event is StatCorrectionBody {\n  return event.type === STAT_CORRECTION_EVENT_TYPE;\n}\n\n/** Whether `event` is one of the sport events `eventTypes` declares — never a void or a correction. */\nexport function isSportStatEventIn(\n  eventTypes: readonly string[],\n  event: StatEventBody | undefined,\n): event is SportStatEventBody {\n  return event !== undefined && eventTypes.includes(event.type);\n}\n\n/** One team's line in a game's rollup, whichever sport it counts. */\nexport type GameTeamLine = GameStats['teamStats'][string];\n/** One roster entry's line in a game's rollup, whichever sport it counts. */\nexport type GamePlayerLine = GameStats['playerStats'][string];\n\n/** A stat line of any kind as `deriveLine` reads and returns it: its counters, derived fields, and ends. */\nexport type StatLineValues = { readonly [field: string]: number | readonly (number | null)[] };\n\n/** The game an event is validated against: its teams, and the roster entries the batch names. */\nexport interface StatEventRoster {\n  /** A team of the game is one of these — never inferred from which team lines a rollup holds. */\n  readonly teamIds: readonly string[];\n  /** The roster entries the driver read for the batch — never the whole roster. */\n  readonly rosterPlayerIds: ReadonlySet<string>;\n}\n\nexport type StatEventVerdict =\n  { readonly ok: true } | { readonly ok: false; readonly code: StatEventRefusalCode };\n\nexport const STAT_EVENT_ACCEPTED: StatEventVerdict = { ok: true };\n\nexport function refuseStatEvent(code: StatEventRefusalCode): StatEventVerdict {\n  return { ok: false, code };\n}\n\nexport type FinalizationReadiness =\n  { readonly ready: true } | { readonly ready: false; readonly reason: FinalizationNotReadyReason };\n\nexport const FINALIZATION_READY: FinalizationReadiness = { ready: true };\n\n/** The fields a `STAT_CORRECTION` may change, on a team line and on a player line. */\nexport interface CorrectableFields {\n  readonly team: readonly StatCounterKey[];\n  readonly player: readonly StatCounterKey[];\n}\n\nexport interface SportScoring {\n  /**\n   * Whether a new event may be recorded against `state`: its type is the sport's, its team is one\n   * of the game's, every person it names is a roster entry of that team, and its values are a real\n   * result. Only the store driver calls it, and only for a new event — a replay never re-validates\n   * what was already accepted.\n   */\n  readonly validate: (\n    state: GameStats,\n    event: StatEventBody,\n    roster: StatEventRoster,\n  ) => StatEventVerdict;\n  /**\n   * `state` with one sport event or one `STAT_CORRECTION` applied. A missing line is created from\n   * the sport's empty line (RULE-QS-SPORT-915); a player line whose counters all return to zero is dropped;\n   * a team line never is. Throws on a void, another sport's event, or a correction to a field not in\n   * `correctableFields`.\n   */\n  readonly apply: (state: GameStats, event: StatEventBody) => GameStats;\n  /** The exact inverse of `apply(target)` for one of the sport's own events (RULE-QS-SPORT-913). */\n  readonly undo: (state: GameStats, target: StatEventBody) => GameStats;\n  /** `line` with every derived field of its kind; the only caller of any derivation formula. */\n  readonly deriveLine: (kind: StatLineKind, line: StatLineValues) => StatLineValues;\n  readonly correctableFields: CorrectableFields;\n  /** The next round to record for a sport played in rounds, `null` once all are or for any other sport. */\n  readonly nextRound: (state: GameStats) => number | null;\n  /** Whether the game may be finalized (RULE-QS-SPORT-922). */\n  readonly finalizationReadiness: (state: GameStats, game: GameTeamIds) => FinalizationReadiness;\n  /**\n   * The games-played decision finalize stores: the roster entries credited no game played, from\n   * each entry's own line and absence, in roster order (RULE-QS-SPORT-924).\n   */\n  readonly participation: (\n    state: GameStats,\n    rosterPlayerIds: readonly string[],\n    absentRosterPlayerIds: readonly string[],\n  ) => string[];\n  /** What a completed game adds to every derived destination (RULE-QS-SPORT-927). */\n  readonly contribution: (game: FinalizedGame) => GameContribution;\n}\n\n/** Whether every counter of a line is zero — a player line the rollup then leaves out. */\nexport function isAllZeroLine(line: StatLineValues, counterKeys: readonly string[]): boolean {\n  return counterKeys.every((key) => line[key] === 0 || line[key] === undefined);\n}\n"]}
+{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../../src/sports/scoring.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAwBrF,MAAM,UAAU,UAAU,CAAC,KAAoB;IAC7C,OAAO,KAAK,CAAC,IAAI,KAAK,oBAAoB,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,OAAO,KAAK,CAAC,IAAI,KAAK,0BAA0B,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,UAA6B,EAC7B,KAAgC;IAEhC,OAAO,KAAK,KAAK,SAAS,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAeD,MAAM,CAAC,MAAM,mBAAmB,GAAqB,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AAElE,MAAM,UAAU,eAAe,CAAC,IAA0B;IACxD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC;AAKD,MAAM,CAAC,MAAM,kBAAkB,GAA0B,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AA2BzE,MAAM,UAAU,aAAa,CAAC,IAAoB,EAAE,WAA8B;IAChF,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;AAChF,CAAC","sourcesContent":["import type { GameStatEvent } from '../doc-schemas/game-stats.js';\nimport type { GameStats } from '../doc-schemas/sport-game.js';\nimport type { StatCounterKey } from '../types/sports.js';\nimport { STAT_CORRECTION_EVENT_TYPE, STAT_VOID_EVENT_TYPE } from '../types/stats.js';\nimport type {\n  FinalizationNotReadyReason,\n  StatEventRecorderField,\n  StatEventRefusalCode,\n  StatEventSnapshotField,\n  StatLineKind,\n} from '../types/stats.js';\nimport type { FinalizedGame, GameContribution } from './contribution.js';\nimport type { GameTeamIds } from './sport-adapter.js';\n\ntype DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;\n\nexport type StatEventBody = DistributiveOmit<\n  GameStatEvent,\n  'eventId' | 'recordedAt' | StatEventRecorderField | StatEventSnapshotField\n>;\nexport type StatVoidBody = Extract<StatEventBody, { type: typeof STAT_VOID_EVENT_TYPE }>;\nexport type StatCorrectionBody = Extract<\n  StatEventBody,\n  { type: typeof STAT_CORRECTION_EVENT_TYPE }\n>;\nexport type SportStatEventBody = Exclude<StatEventBody, StatVoidBody | StatCorrectionBody>;\n\nexport function isStatVoid(event: StatEventBody): event is StatVoidBody {\n  return event.type === STAT_VOID_EVENT_TYPE;\n}\n\nexport function isStatCorrection(event: StatEventBody): event is StatCorrectionBody {\n  return event.type === STAT_CORRECTION_EVENT_TYPE;\n}\n\nexport function isSportStatEventIn(\n  eventTypes: readonly string[],\n  event: StatEventBody | undefined,\n): event is SportStatEventBody {\n  return event !== undefined && eventTypes.includes(event.type);\n}\n\nexport type GameTeamLine = GameStats['teamStats'][string];\nexport type GamePlayerLine = GameStats['playerStats'][string];\n\nexport type StatLineValues = { readonly [field: string]: number | readonly (number | null)[] };\n\nexport interface StatEventRoster {\n  readonly teamIds: readonly string[];\n  readonly rosterPlayerIds: ReadonlySet<string>;\n}\n\nexport type StatEventVerdict =\n  { readonly ok: true } | { readonly ok: false; readonly code: StatEventRefusalCode };\n\nexport const STAT_EVENT_ACCEPTED: StatEventVerdict = { ok: true };\n\nexport function refuseStatEvent(code: StatEventRefusalCode): StatEventVerdict {\n  return { ok: false, code };\n}\n\nexport type FinalizationReadiness =\n  { readonly ready: true } | { readonly ready: false; readonly reason: FinalizationNotReadyReason };\n\nexport const FINALIZATION_READY: FinalizationReadiness = { ready: true };\n\nexport interface CorrectableFields {\n  readonly team: readonly StatCounterKey[];\n  readonly player: readonly StatCounterKey[];\n}\n\nexport interface SportScoring {\n  readonly validate: (\n    state: GameStats,\n    event: StatEventBody,\n    roster: StatEventRoster,\n  ) => StatEventVerdict;\n  readonly apply: (state: GameStats, event: StatEventBody) => GameStats;\n  readonly undo: (state: GameStats, target: StatEventBody) => GameStats;\n  readonly deriveLine: (kind: StatLineKind, line: StatLineValues) => StatLineValues;\n  readonly correctableFields: CorrectableFields;\n  readonly nextRound: (state: GameStats) => number | null;\n  readonly finalizationReadiness: (state: GameStats, game: GameTeamIds) => FinalizationReadiness;\n  readonly participation: (\n    state: GameStats,\n    rosterPlayerIds: readonly string[],\n    absentRosterPlayerIds: readonly string[],\n  ) => string[];\n  readonly contribution: (game: FinalizedGame) => GameContribution;\n}\n\nexport function isAllZeroLine(line: StatLineValues, counterKeys: readonly string[]): boolean {\n  return counterKeys.every((key) => line[key] === 0 || line[key] === undefined);\n}\n"]}

package/dist/sports/shared-columns.d.ts

@@ -52,6 +52,5 @@ export declare const TEAM_SEASON_BASE_COLUMN: {
         pointsAgainst: number;
     }>;
 };
-/** The standings base in catalog order; each sport composes it with its own extras and layout. */
 export declare const TEAM_SEASON_BASE_COLUMNS: readonly StatColumn<TeamSeasonBaseStats>[];
 //# sourceMappingURL=shared-columns.d.ts.map

package/dist/sports/shared-columns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared-columns.d.ts","sourceRoot":"","sources":["../../src/sports/shared-columns.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtE,eAAO,MAAM,mBAAmB,EAAE,UAAU,CAAC,cAAc,CAM1D,CAAC;AAuDF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQ1B,CAAC;AAEX,kGAAkG;AAClG,eAAO,MAAM,wBAAwB,EAAE,SAAS,UAAU,CAAC,mBAAmB,CAAC,EAQ9E,CAAC"}
+{"version":3,"file":"shared-columns.d.ts","sourceRoot":"","sources":["../../src/sports/shared-columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtE,eAAO,MAAM,mBAAmB,EAAE,UAAU,CAAC,cAAc,CAM1D,CAAC;AAoDF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQ1B,CAAC;AAEX,eAAO,MAAM,wBAAwB,EAAE,SAAS,UAAU,CAAC,mBAAmB,CAAC,EAQ9E,CAAC"}

package/dist/sports/shared-columns.js

@@ -1,6 +1,3 @@
-// Columns every sport's catalogs share. A column's id is stable — a saved table layout stores it —
-// so an id never names a different figure later.
-// Games played (GP) is in every player-totals and standings catalog, and has no per-game variant.
 export const GAMES_PLAYED_COLUMN = {
     id: 'gamesPlayed',
     label: 'Games played',
@@ -45,7 +42,6 @@ const POINTS_AGAINST = {
     perGame: { id: 'pointsAgainstPerGame', label: 'Points against per game', shortLabel: 'PA/G' },
     sort: 'asc',
 };
-// Derived at read; no line stores a differential.
 const POINT_DIFFERENTIAL = {
     id: 'pointDifferential',
     label: 'Point differential',
@@ -53,8 +49,6 @@ const POINT_DIFFERENTIAL = {
     value: (line) => line.pointsFor - line.pointsAgainst,
     sort: 'desc',
 };
-// The standings base every sport's season line carries, by key so a sport's layout and standings
-// order name its columns. W, L, T, and the differential have no per-game variant.
 export const TEAM_SEASON_BASE_COLUMN = {
     gamesPlayed: GAMES_PLAYED_COLUMN,
     wins: WINS,
@@ -64,7 +58,6 @@ export const TEAM_SEASON_BASE_COLUMN = {
     pointsAgainst: POINTS_AGAINST,
     pointDifferential: POINT_DIFFERENTIAL,
 };
-/** The standings base in catalog order; each sport composes it with its own extras and layout. */
 export const TEAM_SEASON_BASE_COLUMNS = [
     GAMES_PLAYED_COLUMN,
     WINS,

package/dist/sports/shared-columns.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared-columns.js","sourceRoot":"","sources":["../../src/sports/shared-columns.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,iDAAiD;AAKjD,kGAAkG;AAClG,MAAM,CAAC,MAAM,mBAAmB,GAA+B;IAC7D,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,cAAc;IACrB,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW;IACjC,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,IAAI,GAAoC;IAC5C,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,MAAM;IACb,UAAU,EAAE,GAAG;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI;IAC1B,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,MAAM,GAAoC;IAC9C,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,QAAQ;IACf,UAAU,EAAE,GAAG;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM;IAC5B,IAAI,EAAE,KAAK;CACZ,CAAC;AAEF,MAAM,IAAI,GAAoC;IAC5C,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,MAAM;IACb,UAAU,EAAE,GAAG;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI;IAC1B,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,UAAU,GAAoC;IAClD,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,YAAY;IACnB,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS;IAC/B,OAAO,EAAE,EAAE,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,EAAE;IACrF,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,cAAc,GAAoC;IACtD,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,gBAAgB;IACvB,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa;IACnC,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,yBAAyB,EAAE,UAAU,EAAE,MAAM,EAAE;IAC7F,IAAI,EAAE,KAAK;CACZ,CAAC;AAEF,kDAAkD;AAClD,MAAM,kBAAkB,GAAoC;IAC1D,EAAE,EAAE,mBAAmB;IACvB,KAAK,EAAE,oBAAoB;IAC3B,UAAU,EAAE,KAAK;IACjB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,aAAa;IACpD,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,iGAAiG;AACjG,kFAAkF;AAClF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,WAAW,EAAE,mBAAmB;IAChC,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,IAAI;IACV,SAAS,EAAE,UAAU;IACrB,aAAa,EAAE,cAAc;IAC7B,iBAAiB,EAAE,kBAAkB;CAC7B,CAAC;AAEX,kGAAkG;AAClG,MAAM,CAAC,MAAM,wBAAwB,GAA+C;IAClF,mBAAmB;IACnB,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,UAAU;IACV,cAAc;IACd,kBAAkB;CACnB,CAAC","sourcesContent":["// Columns every sport's catalogs share. A column's id is stable — a saved table layout stores it —\n// so an id never names a different figure later.\n\nimport type { TeamSeasonBaseStats } from '../doc-schemas/aggregate-stats.js';\nimport type { GamesPlayedRow, StatColumn } from './column-catalog.js';\n\n// Games played (GP) is in every player-totals and standings catalog, and has no per-game variant.\nexport const GAMES_PLAYED_COLUMN: StatColumn<GamesPlayedRow> = {\n  id: 'gamesPlayed',\n  label: 'Games played',\n  shortLabel: 'GP',\n  value: (line) => line.gamesPlayed,\n  sort: 'desc',\n};\n\nconst WINS: StatColumn<TeamSeasonBaseStats> = {\n  id: 'wins',\n  label: 'Wins',\n  shortLabel: 'W',\n  value: (line) => line.wins,\n  sort: 'desc',\n};\n\nconst LOSSES: StatColumn<TeamSeasonBaseStats> = {\n  id: 'losses',\n  label: 'Losses',\n  shortLabel: 'L',\n  value: (line) => line.losses,\n  sort: 'asc',\n};\n\nconst TIES: StatColumn<TeamSeasonBaseStats> = {\n  id: 'ties',\n  label: 'Ties',\n  shortLabel: 'T',\n  value: (line) => line.ties,\n  sort: 'desc',\n};\n\nconst POINTS_FOR: StatColumn<TeamSeasonBaseStats> = {\n  id: 'pointsFor',\n  label: 'Points for',\n  shortLabel: 'PF',\n  value: (line) => line.pointsFor,\n  perGame: { id: 'pointsForPerGame', label: 'Points for per game', shortLabel: 'PF/G' },\n  sort: 'desc',\n};\n\nconst POINTS_AGAINST: StatColumn<TeamSeasonBaseStats> = {\n  id: 'pointsAgainst',\n  label: 'Points against',\n  shortLabel: 'PA',\n  value: (line) => line.pointsAgainst,\n  perGame: { id: 'pointsAgainstPerGame', label: 'Points against per game', shortLabel: 'PA/G' },\n  sort: 'asc',\n};\n\n// Derived at read; no line stores a differential.\nconst POINT_DIFFERENTIAL: StatColumn<TeamSeasonBaseStats> = {\n  id: 'pointDifferential',\n  label: 'Point differential',\n  shortLabel: '+/-',\n  value: (line) => line.pointsFor - line.pointsAgainst,\n  sort: 'desc',\n};\n\n// The standings base every sport's season line carries, by key so a sport's layout and standings\n// order name its columns. W, L, T, and the differential have no per-game variant.\nexport const TEAM_SEASON_BASE_COLUMN = {\n  gamesPlayed: GAMES_PLAYED_COLUMN,\n  wins: WINS,\n  losses: LOSSES,\n  ties: TIES,\n  pointsFor: POINTS_FOR,\n  pointsAgainst: POINTS_AGAINST,\n  pointDifferential: POINT_DIFFERENTIAL,\n} as const;\n\n/** The standings base in catalog order; each sport composes it with its own extras and layout. */\nexport const TEAM_SEASON_BASE_COLUMNS: readonly StatColumn<TeamSeasonBaseStats>[] = [\n  GAMES_PLAYED_COLUMN,\n  WINS,\n  LOSSES,\n  TIES,\n  POINTS_FOR,\n  POINTS_AGAINST,\n  POINT_DIFFERENTIAL,\n];\n"]}
+{"version":3,"file":"shared-columns.js","sourceRoot":"","sources":["../../src/sports/shared-columns.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,mBAAmB,GAA+B;IAC7D,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,cAAc;IACrB,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW;IACjC,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,IAAI,GAAoC;IAC5C,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,MAAM;IACb,UAAU,EAAE,GAAG;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI;IAC1B,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,MAAM,GAAoC;IAC9C,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,QAAQ;IACf,UAAU,EAAE,GAAG;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM;IAC5B,IAAI,EAAE,KAAK;CACZ,CAAC;AAEF,MAAM,IAAI,GAAoC;IAC5C,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,MAAM;IACb,UAAU,EAAE,GAAG;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI;IAC1B,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,UAAU,GAAoC;IAClD,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,YAAY;IACnB,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS;IAC/B,OAAO,EAAE,EAAE,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,EAAE;IACrF,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,cAAc,GAAoC;IACtD,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,gBAAgB;IACvB,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa;IACnC,OAAO,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,yBAAyB,EAAE,UAAU,EAAE,MAAM,EAAE;IAC7F,IAAI,EAAE,KAAK;CACZ,CAAC;AAEF,MAAM,kBAAkB,GAAoC;IAC1D,EAAE,EAAE,mBAAmB;IACvB,KAAK,EAAE,oBAAoB;IAC3B,UAAU,EAAE,KAAK;IACjB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,aAAa;IACpD,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,WAAW,EAAE,mBAAmB;IAChC,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,IAAI;IACV,SAAS,EAAE,UAAU;IACrB,aAAa,EAAE,cAAc;IAC7B,iBAAiB,EAAE,kBAAkB;CAC7B,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAA+C;IAClF,mBAAmB;IACnB,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,UAAU;IACV,cAAc;IACd,kBAAkB;CACnB,CAAC","sourcesContent":["import type { TeamSeasonBaseStats } from '../doc-schemas/aggregate-stats.js';\nimport type { GamesPlayedRow, StatColumn } from './column-catalog.js';\n\nexport const GAMES_PLAYED_COLUMN: StatColumn<GamesPlayedRow> = {\n  id: 'gamesPlayed',\n  label: 'Games played',\n  shortLabel: 'GP',\n  value: (line) => line.gamesPlayed,\n  sort: 'desc',\n};\n\nconst WINS: StatColumn<TeamSeasonBaseStats> = {\n  id: 'wins',\n  label: 'Wins',\n  shortLabel: 'W',\n  value: (line) => line.wins,\n  sort: 'desc',\n};\n\nconst LOSSES: StatColumn<TeamSeasonBaseStats> = {\n  id: 'losses',\n  label: 'Losses',\n  shortLabel: 'L',\n  value: (line) => line.losses,\n  sort: 'asc',\n};\n\nconst TIES: StatColumn<TeamSeasonBaseStats> = {\n  id: 'ties',\n  label: 'Ties',\n  shortLabel: 'T',\n  value: (line) => line.ties,\n  sort: 'desc',\n};\n\nconst POINTS_FOR: StatColumn<TeamSeasonBaseStats> = {\n  id: 'pointsFor',\n  label: 'Points for',\n  shortLabel: 'PF',\n  value: (line) => line.pointsFor,\n  perGame: { id: 'pointsForPerGame', label: 'Points for per game', shortLabel: 'PF/G' },\n  sort: 'desc',\n};\n\nconst POINTS_AGAINST: StatColumn<TeamSeasonBaseStats> = {\n  id: 'pointsAgainst',\n  label: 'Points against',\n  shortLabel: 'PA',\n  value: (line) => line.pointsAgainst,\n  perGame: { id: 'pointsAgainstPerGame', label: 'Points against per game', shortLabel: 'PA/G' },\n  sort: 'asc',\n};\n\nconst POINT_DIFFERENTIAL: StatColumn<TeamSeasonBaseStats> = {\n  id: 'pointDifferential',\n  label: 'Point differential',\n  shortLabel: '+/-',\n  value: (line) => line.pointsFor - line.pointsAgainst,\n  sort: 'desc',\n};\n\nexport const TEAM_SEASON_BASE_COLUMN = {\n  gamesPlayed: GAMES_PLAYED_COLUMN,\n  wins: WINS,\n  losses: LOSSES,\n  ties: TIES,\n  pointsFor: POINTS_FOR,\n  pointsAgainst: POINTS_AGAINST,\n  pointDifferential: POINT_DIFFERENTIAL,\n} as const;\n\nexport const TEAM_SEASON_BASE_COLUMNS: readonly StatColumn<TeamSeasonBaseStats>[] = [\n  GAMES_PLAYED_COLUMN,\n  WINS,\n  LOSSES,\n  TIES,\n  POINTS_FOR,\n  POINTS_AGAINST,\n  POINT_DIFFERENTIAL,\n];\n"]}

package/dist/sports/sport-adapter.d.ts

@@ -26,15 +26,8 @@ export interface SportTypeMap {
         readonly playerStatKey: never;
     };
 }
-/**
- * The schema of each of the sport's stat lines, by kind. A stored line is read as this sport's line
- * through its schema — chosen by the adapter `leagueType` selected, never inferred from the line's
- * shape (RULE-QS-SPORT-902).
- */
 export type SportLineSchemas<L extends LeagueType> = (typeof SPORT_LINE_SCHEMAS)[L];
-/** `never` for a kind the sport keeps no line of. */
 export type SportLine<L extends LeagueType, K extends StatLineKind> = z.infer<SportLineSchemas<L>[K]>;
-/** The game `stats` payload of one sport: its team lines and roster-entry lines. */
 export type SportGameStats<L extends LeagueType> = z.infer<(typeof SPORT_GAME_STATS_SCHEMAS)[L]>;
 export declare const COLUMN_CATALOG_LINE_KINDS: {
     readonly playerTotals: "membershipRow";
@@ -42,62 +35,37 @@ export declare const COLUMN_CATALOG_LINE_KINDS: {
     readonly teamSeason: "teamSeason";
 };
 export type ColumnCatalogRow<L extends LeagueType, K extends ColumnCatalogKey> = SportLine<L, (typeof COLUMN_CATALOG_LINE_KINDS)[K]>;
-/** A sport's three column catalogs, each over its own row type; a sport missing one does not compile. */
 export type SportColumnCatalogs<L extends LeagueType> = {
     readonly [K in ColumnCatalogKey]: ColumnCatalog<ColumnCatalogRow<L, K>>;
 };
-/** What shared surfaces render for the sport instead of branching on it (RULE-QS-SPORT-904, RULE-QS-SPORT-929). */
 export interface SportDisplay<L extends LeagueType> {
     readonly label: string;
     readonly iconKey: SportIconKey;
-    /** The profile's lifetime summary for the sport: its totals, and its per-game averages beneath. */
     readonly lifetimeSummary: LifetimeSummary<SportLine<L, 'lifetime'>>;
-    /** Each of the sport's event types: its scoring-panel button and its play-by-play label. */
     readonly eventLabels: Readonly<Record<SportTypeMap[L]['eventType'], StatEventLabel>>;
-    /** Each counter of a team line and of a player line — what a correction row and the Correct a game form name. */
     readonly fieldLabels: StatFieldLabels<SportTypeMap[L]['teamStatKey'], SportTypeMap[L]['playerStatKey']>;
-    /** One play-by-play line for any stored event but a void, a correction included. */
     readonly describeEvent: (event: GameStatEvent, resolve: StatEventNameResolver) => string;
-    /** Present only for a sport played in rounds: the header's round line and the scoreboard's grid. */
     readonly rounds?: RoundsDisplay;
     readonly scoreboard: Scoreboard;
-    /** The one component of the scoring screen that is the sport's own, named by its kind. */
     readonly scoringPanel: ScoringPanel;
 }
-/** The game an empty rollup is built for: its real (non-bye) teams. */
 export interface GameTeamIds {
     readonly teamIds: readonly string[];
 }
-/**
- * One sport's adapter: its facts, its scoring members, its display, its column catalogs, and its
- * bulk entry. The scoring members are typed over every sport, so any registered adapter is called
- * the same way.
- */
 export interface SportAdapter<L extends LeagueType> extends SportScoring {
     readonly leagueType: L;
-    /** The storage key: `sportHallOfFame/{sportKey}`, `historicalStats/{sportKey}`, `lifetimeStats.{sportKey}`. */
     readonly sportKey: (typeof SPORT_KEY_BY_LEAGUE_TYPE)[L];
-    /** The sport's own event types; the store-level void and correction belong to every sport. */
     readonly eventTypes: readonly SportTypeMap[L]['eventType'][];
-    /** The counters of a team line and of a player line — what the aggregates sum and a ghost link merges. */
     readonly teamStatKeys: readonly SportTypeMap[L]['teamStatKey'][];
     readonly playerStatKeys: readonly SportTypeMap[L]['playerStatKey'][];
-    /** Whether the sport keeps `sportHallOfFame/{sportKey}` and the hall-of-fame page serves it. */
     readonly hallOfFame: boolean;
-    /** Whether an admin may enter pre-Q-Sports career totals for the sport. */
     readonly historicalBaseline: boolean;
     readonly lineSchemas: SportLineSchemas<L>;
     readonly display: SportDisplay<L>;
     readonly columns: SportColumnCatalogs<L>;
-    /**
-     * The rollup of a game with no events (RULE-QS-SPORT-915): a team line for each of the game's teams, and
-     * no player lines. Every call returns new objects.
-     */
     readonly emptyStats: (game: GameTeamIds) => SportGameStats<L>;
-    /** The sport's bulk-entry form, whose rules `validate` enforces again on every event it becomes. */
     readonly bulkEntry: BulkEntry;
 }
-/** Every registered adapter, by `leagueType`. Indexing it with a generic sport keeps the sport. */
 export type SportAdapterRegistry = {
     readonly [L in LeagueType]: SportAdapter<L>;
 };

package/dist/sports/sport-adapter.d.ts.map

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

package/dist/sports/sport-adapter.js

@@ -1,10 +1,3 @@
-// The sport adapter contract: one adapter per sport owns everything about that sport, and every
-// shared surface asks it rather than branching on a sport (RULE-QS-SPORT-903, RULE-QS-SPORT-904). Every member is
-// pure — no Firestore operation, no clock, no minted id, no React — so both app roots run the one
-// copy (RULE-STD-ARCH-101, RULE-STD-ARCH-202).
-// The line kind each stats table reads its rows from. Standings rows are team season lines; the
-// game page's rows are player game lines; every player-totals table — league rankings, the team
-// page, the hall of fame — reads rows shaped as membership rows.
 export const COLUMN_CATALOG_LINE_KINDS = {
     playerTotals: 'membershipRow',
     gamePlayer: 'gamePlayer',

package/dist/sports/sport-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"sport-adapter.js","sourceRoot":"","sources":["../../src/sports/sport-adapter.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,kHAAkH;AAClH,kGAAkG;AAClG,+CAA+C;AAmE/C,gGAAgG;AAChG,gGAAgG;AAChG,iEAAiE;AACjE,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,YAAY,EAAE,eAAe;IAC7B,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;CACiC,CAAC","sourcesContent":["// The sport adapter contract: one adapter per sport owns everything about that sport, and every\n// shared surface asks it rather than branching on a sport (RULE-QS-SPORT-903, RULE-QS-SPORT-904). Every member is\n// pure — no Firestore operation, no clock, no minted id, no React — so both app roots run the one\n// copy (RULE-STD-ARCH-101, RULE-STD-ARCH-202).\n\nimport type { z } from 'zod';\nimport type { SPORT_LINE_SCHEMAS } from '../doc-schemas/aggregate-stats.js';\nimport type { SPORT_GAME_STATS_SCHEMAS } from '../doc-schemas/sport-game.js';\nimport type {\n  BasketballPlayerStatKey,\n  BasketballStatEventType,\n  BasketballTeamStatKey,\n  CurlingStatEventType,\n  CurlingTeamStatKey,\n  FootballStatEventType,\n  FootballTeamStatKey,\n  LeagueType,\n  SPORT_KEY_BY_LEAGUE_TYPE,\n  SportIconKey,\n} from '../types/sports.js';\nimport type { StatLineKind } from '../types/stats.js';\nimport type { GameStatEvent } from '../doc-schemas/game-stats.js';\nimport type { BulkEntry } from './bulk-entry.js';\nimport type { ColumnCatalog, ColumnCatalogKey } from './column-catalog.js';\nimport type { LifetimeSummary } from './lifetime-summary.js';\nimport type { SportScoring } from './scoring.js';\nimport type {\n  RoundsDisplay,\n  Scoreboard,\n  ScoringPanel,\n  StatEventLabel,\n  StatEventNameResolver,\n  StatFieldLabels,\n} from './scoring-display.js';\n\n// Each sport's declared vocabulary, keyed by `leagueType`. Its lines, and the game payload built\n// from them, come from `SPORT_LINE_SCHEMAS`.\nexport interface SportTypeMap {\n  readonly Basketball: {\n    readonly eventType: BasketballStatEventType;\n    readonly teamStatKey: BasketballTeamStatKey;\n    readonly playerStatKey: BasketballPlayerStatKey;\n  };\n  readonly Curling: {\n    readonly eventType: CurlingStatEventType;\n    readonly teamStatKey: CurlingTeamStatKey;\n    readonly playerStatKey: never;\n  };\n  readonly Football: {\n    readonly eventType: FootballStatEventType;\n    readonly teamStatKey: FootballTeamStatKey;\n    readonly playerStatKey: never;\n  };\n}\n\n/**\n * The schema of each of the sport's stat lines, by kind. A stored line is read as this sport's line\n * through its schema — chosen by the adapter `leagueType` selected, never inferred from the line's\n * shape (RULE-QS-SPORT-902).\n */\nexport type SportLineSchemas<L extends LeagueType> = (typeof SPORT_LINE_SCHEMAS)[L];\n\n/** `never` for a kind the sport keeps no line of. */\nexport type SportLine<L extends LeagueType, K extends StatLineKind> = z.infer<\n  SportLineSchemas<L>[K]\n>;\n\n/** The game `stats` payload of one sport: its team lines and roster-entry lines. */\nexport type SportGameStats<L extends LeagueType> = z.infer<(typeof SPORT_GAME_STATS_SCHEMAS)[L]>;\n\n// The line kind each stats table reads its rows from. Standings rows are team season lines; the\n// game page's rows are player game lines; every player-totals table — league rankings, the team\n// page, the hall of fame — reads rows shaped as membership rows.\nexport const COLUMN_CATALOG_LINE_KINDS = {\n  playerTotals: 'membershipRow',\n  gamePlayer: 'gamePlayer',\n  teamSeason: 'teamSeason',\n} as const satisfies Record<ColumnCatalogKey, StatLineKind>;\n\nexport type ColumnCatalogRow<L extends LeagueType, K extends ColumnCatalogKey> = SportLine<\n  L,\n  (typeof COLUMN_CATALOG_LINE_KINDS)[K]\n>;\n\n/** A sport's three column catalogs, each over its own row type; a sport missing one does not compile. */\nexport type SportColumnCatalogs<L extends LeagueType> = {\n  readonly [K in ColumnCatalogKey]: ColumnCatalog<ColumnCatalogRow<L, K>>;\n};\n\n/** What shared surfaces render for the sport instead of branching on it (RULE-QS-SPORT-904, RULE-QS-SPORT-929). */\nexport interface SportDisplay<L extends LeagueType> {\n  readonly label: string;\n  readonly iconKey: SportIconKey;\n  /** The profile's lifetime summary for the sport: its totals, and its per-game averages beneath. */\n  readonly lifetimeSummary: LifetimeSummary<SportLine<L, 'lifetime'>>;\n  /** Each of the sport's event types: its scoring-panel button and its play-by-play label. */\n  readonly eventLabels: Readonly<Record<SportTypeMap[L]['eventType'], StatEventLabel>>;\n  /** Each counter of a team line and of a player line — what a correction row and the Correct a game form name. */\n  readonly fieldLabels: StatFieldLabels<\n    SportTypeMap[L]['teamStatKey'],\n    SportTypeMap[L]['playerStatKey']\n  >;\n  /** One play-by-play line for any stored event but a void, a correction included. */\n  readonly describeEvent: (event: GameStatEvent, resolve: StatEventNameResolver) => string;\n  /** Present only for a sport played in rounds: the header's round line and the scoreboard's grid. */\n  readonly rounds?: RoundsDisplay;\n  readonly scoreboard: Scoreboard;\n  /** The one component of the scoring screen that is the sport's own, named by its kind. */\n  readonly scoringPanel: ScoringPanel;\n}\n\n/** The game an empty rollup is built for: its real (non-bye) teams. */\nexport interface GameTeamIds {\n  readonly teamIds: readonly string[];\n}\n\n/**\n * One sport's adapter: its facts, its scoring members, its display, its column catalogs, and its\n * bulk entry. The scoring members are typed over every sport, so any registered adapter is called\n * the same way.\n */\nexport interface SportAdapter<L extends LeagueType> extends SportScoring {\n  readonly leagueType: L;\n  /** The storage key: `sportHallOfFame/{sportKey}`, `historicalStats/{sportKey}`, `lifetimeStats.{sportKey}`. */\n  readonly sportKey: (typeof SPORT_KEY_BY_LEAGUE_TYPE)[L];\n  /** The sport's own event types; the store-level void and correction belong to every sport. */\n  readonly eventTypes: readonly SportTypeMap[L]['eventType'][];\n  /** The counters of a team line and of a player line — what the aggregates sum and a ghost link merges. */\n  readonly teamStatKeys: readonly SportTypeMap[L]['teamStatKey'][];\n  readonly playerStatKeys: readonly SportTypeMap[L]['playerStatKey'][];\n  /** Whether the sport keeps `sportHallOfFame/{sportKey}` and the hall-of-fame page serves it. */\n  readonly hallOfFame: boolean;\n  /** Whether an admin may enter pre-Q-Sports career totals for the sport. */\n  readonly historicalBaseline: boolean;\n  readonly lineSchemas: SportLineSchemas<L>;\n  readonly display: SportDisplay<L>;\n  readonly columns: SportColumnCatalogs<L>;\n  /**\n   * The rollup of a game with no events (RULE-QS-SPORT-915): a team line for each of the game's teams, and\n   * no player lines. Every call returns new objects.\n   */\n  readonly emptyStats: (game: GameTeamIds) => SportGameStats<L>;\n  /** The sport's bulk-entry form, whose rules `validate` enforces again on every event it becomes. */\n  readonly bulkEntry: BulkEntry;\n}\n\n/** Every registered adapter, by `leagueType`. Indexing it with a generic sport keeps the sport. */\nexport type SportAdapterRegistry = { readonly [L in LeagueType]: SportAdapter<L> };\n\nexport type AnySportAdapter = SportAdapterRegistry[LeagueType];\n"]}
+{"version":3,"file":"sport-adapter.js","sourceRoot":"","sources":["../../src/sports/sport-adapter.ts"],"names":[],"mappings":"AAwDA,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,YAAY,EAAE,eAAe;IAC7B,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;CACiC,CAAC","sourcesContent":["import type { z } from 'zod';\nimport type { SPORT_LINE_SCHEMAS } from '../doc-schemas/aggregate-stats.js';\nimport type { SPORT_GAME_STATS_SCHEMAS } from '../doc-schemas/sport-game.js';\nimport type {\n  BasketballPlayerStatKey,\n  BasketballStatEventType,\n  BasketballTeamStatKey,\n  CurlingStatEventType,\n  CurlingTeamStatKey,\n  FootballStatEventType,\n  FootballTeamStatKey,\n  LeagueType,\n  SPORT_KEY_BY_LEAGUE_TYPE,\n  SportIconKey,\n} from '../types/sports.js';\nimport type { StatLineKind } from '../types/stats.js';\nimport type { GameStatEvent } from '../doc-schemas/game-stats.js';\nimport type { BulkEntry } from './bulk-entry.js';\nimport type { ColumnCatalog, ColumnCatalogKey } from './column-catalog.js';\nimport type { LifetimeSummary } from './lifetime-summary.js';\nimport type { SportScoring } from './scoring.js';\nimport type {\n  RoundsDisplay,\n  Scoreboard,\n  ScoringPanel,\n  StatEventLabel,\n  StatEventNameResolver,\n  StatFieldLabels,\n} from './scoring-display.js';\n\nexport interface SportTypeMap {\n  readonly Basketball: {\n    readonly eventType: BasketballStatEventType;\n    readonly teamStatKey: BasketballTeamStatKey;\n    readonly playerStatKey: BasketballPlayerStatKey;\n  };\n  readonly Curling: {\n    readonly eventType: CurlingStatEventType;\n    readonly teamStatKey: CurlingTeamStatKey;\n    readonly playerStatKey: never;\n  };\n  readonly Football: {\n    readonly eventType: FootballStatEventType;\n    readonly teamStatKey: FootballTeamStatKey;\n    readonly playerStatKey: never;\n  };\n}\n\nexport type SportLineSchemas<L extends LeagueType> = (typeof SPORT_LINE_SCHEMAS)[L];\n\nexport type SportLine<L extends LeagueType, K extends StatLineKind> = z.infer<\n  SportLineSchemas<L>[K]\n>;\n\nexport type SportGameStats<L extends LeagueType> = z.infer<(typeof SPORT_GAME_STATS_SCHEMAS)[L]>;\n\nexport const COLUMN_CATALOG_LINE_KINDS = {\n  playerTotals: 'membershipRow',\n  gamePlayer: 'gamePlayer',\n  teamSeason: 'teamSeason',\n} as const satisfies Record<ColumnCatalogKey, StatLineKind>;\n\nexport type ColumnCatalogRow<L extends LeagueType, K extends ColumnCatalogKey> = SportLine<\n  L,\n  (typeof COLUMN_CATALOG_LINE_KINDS)[K]\n>;\n\nexport type SportColumnCatalogs<L extends LeagueType> = {\n  readonly [K in ColumnCatalogKey]: ColumnCatalog<ColumnCatalogRow<L, K>>;\n};\n\nexport interface SportDisplay<L extends LeagueType> {\n  readonly label: string;\n  readonly iconKey: SportIconKey;\n  readonly lifetimeSummary: LifetimeSummary<SportLine<L, 'lifetime'>>;\n  readonly eventLabels: Readonly<Record<SportTypeMap[L]['eventType'], StatEventLabel>>;\n  readonly fieldLabels: StatFieldLabels<\n    SportTypeMap[L]['teamStatKey'],\n    SportTypeMap[L]['playerStatKey']\n  >;\n  readonly describeEvent: (event: GameStatEvent, resolve: StatEventNameResolver) => string;\n  readonly rounds?: RoundsDisplay;\n  readonly scoreboard: Scoreboard;\n  readonly scoringPanel: ScoringPanel;\n}\n\nexport interface GameTeamIds {\n  readonly teamIds: readonly string[];\n}\n\nexport interface SportAdapter<L extends LeagueType> extends SportScoring {\n  readonly leagueType: L;\n  readonly sportKey: (typeof SPORT_KEY_BY_LEAGUE_TYPE)[L];\n  readonly eventTypes: readonly SportTypeMap[L]['eventType'][];\n  readonly teamStatKeys: readonly SportTypeMap[L]['teamStatKey'][];\n  readonly playerStatKeys: readonly SportTypeMap[L]['playerStatKey'][];\n  readonly hallOfFame: boolean;\n  readonly historicalBaseline: boolean;\n  readonly lineSchemas: SportLineSchemas<L>;\n  readonly display: SportDisplay<L>;\n  readonly columns: SportColumnCatalogs<L>;\n  readonly emptyStats: (game: GameTeamIds) => SportGameStats<L>;\n  readonly bulkEntry: BulkEntry;\n}\n\nexport type SportAdapterRegistry = { readonly [L in LeagueType]: SportAdapter<L> };\n\nexport type AnySportAdapter = SportAdapterRegistry[LeagueType];\n"]}

package/dist/sports/store-driver.d.ts

@@ -4,19 +4,11 @@ import type { StatEventSubmission } from '../schemas/scoring.js';
 import type { RecordedStatEventOutcome, StatEventRefusalCode } from '../types/stats.js';
 import { type StatEventRoster } from './scoring.js';
 import type { AnySportAdapter, GameTeamIds } from './sport-adapter.js';
-/** The document id a submission is stored at. */
 export declare function statEventSubmissionId(submission: StatEventSubmission): string;
-/**
- * The ids a batch reads before it decides anything: every submission's own id, and every void's
- * target — the driver needs the stored document at each, or knows none is stored. A correction's is
- * never read: the driver refuses one before it looks at the store.
- */
 export declare function statEventIdsToRead(submissions: readonly StatEventSubmission[]): string[];
-/** An event the batch stores now: its id, its place in the replay, and every field its caller sent. */
 export interface AcceptedStatEvent {
     readonly eventId: string;
     readonly sequence: number;
-    /** The document's fields but the recorder facts, which the writing core stamps (RULE-STD-ARCH-106). */
     readonly fields: Readonly<Record<string, unknown>>;
 }
 export interface RecordedStatEventResult {
@@ -26,17 +18,13 @@ export interface RecordedStatEventResult {
 }
 export type StatEventBatchDecision = {
     readonly ok: true;
-    /** The rollup after the batch — unchanged when every event was already recorded. */
     readonly stats: GameStats;
     readonly statEventSequence: number;
-    /** Each submission's result, in the order sent. */
     readonly results: readonly RecordedStatEventResult[];
-    /** The events to create, in sequence order; empty when every event was already recorded. */
     readonly accepted: readonly AcceptedStatEvent[];
 } | {
     readonly ok: false;
     readonly code: StatEventRefusalCode;
-    /** The first submission refused; nothing of the batch is written. */
     readonly eventId: string;
 };
 export interface StatEventBatch {
@@ -45,25 +33,9 @@ export interface StatEventBatch {
         readonly stats: GameStats;
         readonly statEventSequence: number;
     };
-    /** The game's teams and the roster entries the batch names that exist. */
     readonly roster: StatEventRoster;
     readonly submissions: readonly StatEventSubmission[];
-    /** The stored event at an id `statEventIdsToRead` named, or `undefined` where none is stored. */
     readonly storedEvent: (eventId: string) => GameStatEvent | undefined;
 }
-/**
- * Decide one scoring write. Every submission in order, against a running rollup that starts from
- * the stored one with a team line for each of the game's teams:
- *
- * - a correction → refused; only the game-reconcile core appends one;
- * - an id already stored, or earlier in the batch → acknowledged when it is the same event, and
- *   refused (`eventIdConflict`) when it is not;
- * - a new sport event → the adapter validates it and applies it, and it takes the next sequence;
- * - a new void → its target, stored or earlier in the batch, must be one of the sport's events; the
- *   adapter undoes it, and it takes the next sequence. A void that would leave a stat below zero —
- *   the target's field moved down by a later edit — is refused (`undoBelowZero`).
- *
- * The first refusal refuses the whole batch.
- */
 export declare function decideStatEventBatch(batch: StatEventBatch): StatEventBatchDecision;
 //# sourceMappingURL=store-driver.d.ts.map

package/dist/sports/store-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-driver.d.ts","sourceRoot":"","sources":["../../src/sports/store-driver.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAExF,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEvE,iDAAiD;AACjD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,GAAG,MAAM,EAAE,CAQxF;AAED,uGAAuG;AACvG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,sBAAsB,GAC9B;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACrD,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACjD,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/F,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,iGAAiG;IACjG,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;CACtE;AAkED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,sBAAsB,CA4DlF"}
+{"version":3,"file":"store-driver.d.ts","sourceRoot":"","sources":["../../src/sports/store-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAExF,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEvE,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAE7E;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,GAAG,MAAM,EAAE,CAQxF;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,sBAAsB,GAC9B;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACjD,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/F,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;CACtE;AA2DD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,sBAAsB,CA2DlF"}

package/dist/sports/store-driver.js

@@ -1,26 +1,10 @@
-// The store driver's decision half: what one scoring write does with the batch of events it was
-// sent, given what the game already holds. It owns ids, the sequence, void resolution, and the fold;
-// everything sport-shaped is the adapter's (RULE-QS-SPORT-903). The writing core reads the game, the stored
-// events the batch names, and the roster entries it names, hands them here, and writes what comes
-// back — one transaction, all or nothing.
-//
-// An event id is the idempotency key (RULE-QS-SPORT-912): an id already stored, or earlier in the batch, is
-// acknowledged when its content matches and never applied again, so re-sending a batch whose first
-// send timed out after committing changes nothing. A void's id is derived from its target, so a
-// second undo of one event is the same document and is acknowledged too.
 import { buildStatVoidId } from '../ids/stat-event-ids.js';
 import { STAT_EVENT_RECORDER_FIELD_KEYS, STAT_EVENT_SNAPSHOT_FIELD_KEYS } from '../types/stats.js';
 import { foldStatEvent, withGameTeamLines } from './replay.js';
 import { isSportStatEventIn, isStatCorrection, isStatVoid, } from './scoring.js';
-/** The document id a submission is stored at. */
 export function statEventSubmissionId(submission) {
     return isStatVoid(submission) ? buildStatVoidId(submission.targetEventId) : submission.eventId;
 }
-/**
- * The ids a batch reads before it decides anything: every submission's own id, and every void's
- * target — the driver needs the stored document at each, or knows none is stored. A correction's is
- * never read: the driver refuses one before it looks at the store.
- */
 export function statEventIdsToRead(submissions) {
     const ids = new Set();
     for (const submission of submissions) {
@@ -32,7 +16,6 @@ export function statEventIdsToRead(submissions) {
     }
     return [...ids];
 }
-// The fields of a stored event the writing core derives, which a caller's re-send never carries.
 const DERIVED_FIELDS = new Set([
     ...STAT_EVENT_RECORDER_FIELD_KEYS,
     ...STAT_EVENT_SNAPSHOT_FIELD_KEYS,
@@ -47,47 +30,26 @@ function sameFields(left, right) {
     return (keys.length === Object.keys(rightFields).length &&
         keys.every((key) => Object.is(leftFields[key], rightFields[key])));
 }
-/**
- * Whether a submission is the event already held at its id. A void is the same void when it names
- * the same target; a sport event only when every field its caller supplies is the same.
- */
 function isSameEvent(submission, held) {
     if (isStatVoid(submission))
         return isStatVoid(held) && held.targetEventId === submission.targetEventId;
     return sameFields(submission, held);
 }
-/** Whether any counter, or any recorded round, of any line is below zero. */
 function holdsNegativeValue(stats) {
     const lines = [...Object.values(stats.teamStats), ...Object.values(stats.playerStats)];
     return lines.some((line) => Object.values(line).some((value) => Array.isArray(value)
         ? value.some((slot) => typeof slot === 'number' && slot < 0)
         : typeof value === 'number' && value < 0));
 }
-/** The stored fields of a new event: the void's derived id, or the caller's own id and fields. */
 function acceptedFields(submission, eventId, sequence) {
     return { ...callerFields(submission), eventId, sequence };
 }
-/**
- * Decide one scoring write. Every submission in order, against a running rollup that starts from
- * the stored one with a team line for each of the game's teams:
- *
- * - a correction → refused; only the game-reconcile core appends one;
- * - an id already stored, or earlier in the batch → acknowledged when it is the same event, and
- *   refused (`eventIdConflict`) when it is not;
- * - a new sport event → the adapter validates it and applies it, and it takes the next sequence;
- * - a new void → its target, stored or earlier in the batch, must be one of the sport's events; the
- *   adapter undoes it, and it takes the next sequence. A void that would leave a stat below zero —
- *   the target's field moved down by a later edit — is refused (`undoBelowZero`).
- *
- * The first refusal refuses the whole batch.
- */
 export function decideStatEventBatch(batch) {
     const { adapter, game, roster, submissions, storedEvent } = batch;
     let stats = withGameTeamLines(adapter, game.stats, game);
     let sequence = game.statEventSequence;
     const results = [];
     const accepted = [];
-    // Every event the batch has placed so far — stored or new — by id, with the sequence it holds.
     const placed = new Map();
     for (const submission of submissions) {
         const eventId = statEventSubmissionId(submission);