rategame-shared 1.1.534 → 1.1.535

package/dist/schemas/pollPrediction.d.ts

@@ -96,6 +96,7 @@ export declare const pollPredictionRoundSchema: z.ZodObject<{
         tieEndRank?: number | undefined;
     }>, "many">>;
     chalkScore: z.ZodOptional<z.ZodNumber>;
+    participantCount: z.ZodOptional<z.ZodNumber>;
     createdAt: z.ZodNumber;
     updatedAt: z.ZodNumber;
     scoredAt: z.ZodOptional<z.ZodNumber>;
@@ -133,6 +134,7 @@ export declare const pollPredictionRoundSchema: z.ZodObject<{
         tieEndRank?: number | undefined;
     }[] | undefined;
     chalkScore?: number | undefined;
+    participantCount?: number | undefined;
     scoredAt?: number | undefined;
 }, {
     id: string;
@@ -168,6 +170,7 @@ export declare const pollPredictionRoundSchema: z.ZodObject<{
         tieEndRank?: number | undefined;
     }[] | undefined;
     chalkScore?: number | undefined;
+    participantCount?: number | undefined;
     scoredAt?: number | undefined;
 }>;
 export declare const pollPredictionBallotTeamResultSchema: z.ZodObject<{
@@ -2319,9 +2322,9 @@ export declare const pollPredictionBallotSchema: z.ZodObject<{
         }[];
     } | undefined;
     chalkScore?: number | undefined;
+    participantCount?: number | undefined;
     scoredAt?: number | undefined;
     chalkDelta?: number | undefined;
-    participantCount?: number | undefined;
 }, {
     id: string;
     user: {
@@ -2397,9 +2400,9 @@ export declare const pollPredictionBallotSchema: z.ZodObject<{
         }[];
     } | undefined;
     chalkScore?: number | undefined;
+    participantCount?: number | undefined;
     scoredAt?: number | undefined;
     chalkDelta?: number | undefined;
-    participantCount?: number | undefined;
 }>;
 export declare const pollPredictionSubmitBallotDtoSchema: z.ZodObject<{
     teamIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
@@ -2479,6 +2482,7 @@ export declare const pollPredictionHomeResponseSchema: z.ZodObject<{
             tieEndRank?: number | undefined;
         }>, "many">>;
         chalkScore: z.ZodOptional<z.ZodNumber>;
+        participantCount: z.ZodOptional<z.ZodNumber>;
         createdAt: z.ZodNumber;
         updatedAt: z.ZodNumber;
         scoredAt: z.ZodOptional<z.ZodNumber>;
@@ -2516,6 +2520,7 @@ export declare const pollPredictionHomeResponseSchema: z.ZodObject<{
             tieEndRank?: number | undefined;
         }[] | undefined;
         chalkScore?: number | undefined;
+        participantCount?: number | undefined;
         scoredAt?: number | undefined;
     }, {
         id: string;
@@ -2551,6 +2556,7 @@ export declare const pollPredictionHomeResponseSchema: z.ZodObject<{
             tieEndRank?: number | undefined;
         }[] | undefined;
         chalkScore?: number | undefined;
+        participantCount?: number | undefined;
         scoredAt?: number | undefined;
     }>;
     ballot: z.ZodNullable<z.ZodObject<{
@@ -4509,9 +4515,9 @@ export declare const pollPredictionHomeResponseSchema: z.ZodObject<{
             }[];
         } | undefined;
         chalkScore?: number | undefined;
+        participantCount?: number | undefined;
         scoredAt?: number | undefined;
         chalkDelta?: number | undefined;
-        participantCount?: number | undefined;
     }, {
         id: string;
         user: {
@@ -4587,9 +4593,9 @@ export declare const pollPredictionHomeResponseSchema: z.ZodObject<{
             }[];
         } | undefined;
         chalkScore?: number | undefined;
+        participantCount?: number | undefined;
         scoredAt?: number | undefined;
         chalkDelta?: number | undefined;
-        participantCount?: number | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     round: {
@@ -4626,6 +4632,7 @@ export declare const pollPredictionHomeResponseSchema: z.ZodObject<{
             tieEndRank?: number | undefined;
         }[] | undefined;
         chalkScore?: number | undefined;
+        participantCount?: number | undefined;
         scoredAt?: number | undefined;
     };
     ballot: {
@@ -4703,9 +4710,9 @@ export declare const pollPredictionHomeResponseSchema: z.ZodObject<{
             }[];
         } | undefined;
         chalkScore?: number | undefined;
+        participantCount?: number | undefined;
         scoredAt?: number | undefined;
         chalkDelta?: number | undefined;
-        participantCount?: number | undefined;
     } | null;
 }, {
     round: {
@@ -4742,6 +4749,7 @@ export declare const pollPredictionHomeResponseSchema: z.ZodObject<{
             tieEndRank?: number | undefined;
         }[] | undefined;
         chalkScore?: number | undefined;
+        participantCount?: number | undefined;
         scoredAt?: number | undefined;
     };
     ballot: {
@@ -4819,9 +4827,9 @@ export declare const pollPredictionHomeResponseSchema: z.ZodObject<{
             }[];
         } | undefined;
         chalkScore?: number | undefined;
+        participantCount?: number | undefined;
         scoredAt?: number | undefined;
         chalkDelta?: number | undefined;
-        participantCount?: number | undefined;
     } | null;
 }>;
 export declare const pollPredictionLeaderboardEntrySchema: z.ZodObject<Pick<{
@@ -12606,9 +12614,9 @@ export declare const pollPredictionUserBallotsResponseSchema: z.ZodObject<{
             }[];
         } | undefined;
         chalkScore?: number | undefined;
+        participantCount?: number | undefined;
         scoredAt?: number | undefined;
         chalkDelta?: number | undefined;
-        participantCount?: number | undefined;
     }, {
         id: string;
         user: {
@@ -12684,9 +12692,9 @@ export declare const pollPredictionUserBallotsResponseSchema: z.ZodObject<{
             }[];
         } | undefined;
         chalkScore?: number | undefined;
+        participantCount?: number | undefined;
         scoredAt?: number | undefined;
         chalkDelta?: number | undefined;
-        participantCount?: number | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     summary: {
@@ -12776,9 +12784,9 @@ export declare const pollPredictionUserBallotsResponseSchema: z.ZodObject<{
             }[];
         } | undefined;
         chalkScore?: number | undefined;
+        participantCount?: number | undefined;
         scoredAt?: number | undefined;
         chalkDelta?: number | undefined;
-        participantCount?: number | undefined;
     }[];
 }, {
     summary: {
@@ -12868,8 +12876,8 @@ export declare const pollPredictionUserBallotsResponseSchema: z.ZodObject<{
             }[];
         } | undefined;
         chalkScore?: number | undefined;
+        participantCount?: number | undefined;
         scoredAt?: number | undefined;
         chalkDelta?: number | undefined;
-        participantCount?: number | undefined;
     }[];
 }>;

package/dist/schemas/pollPrediction.js

@@ -45,8 +45,10 @@ exports.pollPredictionRoundSchema = zod_1.z.object({
     })),
     // Complete official AP poll captured during refresh and used to grade this round.
     actualTeams: zod_1.z.array(exports.pollPredictionTeamSchema).optional(),
-    // Final score of the unchanged previous poll's first 25 teams, including bonuses.
+    // Rank delta of the unchanged previous poll's first 25 teams, before bonuses; the points baseline.
     chalkScore: zod_1.z.number().optional(),
+    // Ranked users for this week, including prior participants with zero-point skipped weeks.
+    participantCount: zod_1.z.number().int().min(0).optional(),
     createdAt: zod_1.z.number(),
     updatedAt: zod_1.z.number(),
     // Unix milliseconds when results were scored and materialized.
@@ -69,19 +71,19 @@ exports.pollPredictionBallotTeamResultSchema = zod_1.z.object({
 exports.pollPredictionBallotScoreSchema = zod_1.z.object({
     // Sum of rank distances over every team on either list, before bonuses.
     totalDelta: zod_1.z.number().int().min(0),
-    // Number of zero-delta picks; each earns -1 and this is the first score tiebreaker.
+    // Number of zero-delta picks; each earns +1 and this is the first points tiebreaker.
     bullseyes: zod_1.z.number().int().min(0),
-    // Previous-poll teams omitted by both the user and the new AP poll; each earns -3.
+    // Previous-poll teams omitted by both the user and the new AP poll; each earns +3.
     calledDrops: zod_1.z.number().int().min(0),
-    // New AP entrants absent from the previous poll that the user included; each earns -3.
+    // New AP entrants absent from the previous poll that the user included; each earns +3.
     calledClimbs: zod_1.z.number().int().min(0),
-    // First five picks all occupy accepted AP slots; earns -5.
+    // First five picks all occupy accepted AP slots; earns +5.
     perfectTopFive: zod_1.z.boolean(),
-    // User picked the new AP #1 at #1 and it differs from the previous #1; earns -3.
+    // User picked the new AP #1 at #1 and it differs from the previous #1; earns +3.
     calledNewNumberOne: zod_1.z.boolean(),
-    // Sum of all bonus deductions, including bullseyes; zero or negative.
-    bonus: zod_1.z.number().int().max(0),
-    // Final score: totalDelta + bonus. Lower wins and a perfect ballot can be negative.
+    // Sum of positive bonus points, including bullseyes.
+    bonus: zod_1.z.number().int().min(0),
+    // Weekly points: chalk's rank delta - totalDelta + bonus. Higher wins; negative points are allowed.
     total: zod_1.z.number().int(),
     // Sum of deltas for teams in either top 10; smaller wins the second score tiebreaker.
     topTenMiss: zod_1.z.number().int().min(0),
@@ -95,7 +97,7 @@ exports.pollPredictionBallotScoreSchema = zod_1.z.object({
         label: zod_1.z.string(),
         // Number of awards in this category; boolean awards are represented as 0 or 1.
         count: zod_1.z.number().int(),
-        // Total score deduction for this category, not its per-award value.
+        // Total bonus points for this category, not its per-award value.
         points: zod_1.z.number().int(),
     })),
 });
@@ -113,11 +115,11 @@ exports.pollPredictionBallotSchema = zod_1.z.object({
     addedTeams: zod_1.z.array(exports.pollPredictionTeamSchema),
     // Previous AP teams not picked, materialized for the "Out" summary; not additional picks.
     removedTeams: zod_1.z.array(exports.pollPredictionTeamSchema),
-    // This round's chalk score copied onto the ballot for standalone results/feed cards.
+    // This round's chalk rank delta, before bonuses, copied for standalone results/feed cards.
     chalkScore: zod_1.z.number().optional(),
-    // chalkScore - score.total: positive means the user beat chalk.
+    // chalkScore - score.totalDelta: rank improvement over chalk, before adding bonuses.
     chalkDelta: zod_1.z.number().optional(),
-    // Weekly leaderboard size, including prior participants assigned chalk for a skipped week.
+    // Weekly leaderboard size, including prior participants with zero-point skipped weeks.
     participantCount: zod_1.z.number().int().optional(),
     // Materialized grading details, available after the rankings refresh scores the ballot.
     score: exports.pollPredictionBallotScoreSchema.optional(),
@@ -156,7 +158,7 @@ exports.pollPredictionLeaderboardEntrySchema = exports.pollPredictionBallotSchem
     tiebreakAt: true,
 })
     .extend({
-    // Weekly entry origin; chalk is a skipped-week score, not a synthetic ballot. Omitted on aggregates.
+    // Weekly entry origin; chalk marks a skipped week with zero points and no bonuses, not a ballot. Omitted on aggregates.
     source: zod_1.z.enum(["submitted", "chalk"]).optional(),
     // Lightweight score totals for leaderboard rows; detailed results stay on actual ballots.
     score: exports.pollPredictionBallotScoreSchema
@@ -168,26 +170,26 @@ exports.pollPredictionLeaderboardEntrySchema = exports.pollPredictionBallotSchem
         .optional(),
 });
 exports.pollPredictionUserSummarySchema = zod_1.z.object({
-    // User's leaderboard position in the requested season/all-time scope.
+    // User's leaderboard position in the requested season.
     rank: zod_1.z.number().int(),
-    // Sum of final weekly scores in this scope, including skipped-week chalk scores.
+    // Sum of weekly points this season; skipped weeks contribute zero.
     total: zod_1.z.number().int(),
     // Sum of bullseyes across the graded weeks in this scope.
     bullseyes: zod_1.z.number().int(),
-    // Graded weeks, including skipped weeks assigned chalk; not the number of ballot documents.
+    // Graded weeks since first participation, including skipped weeks with zero points; not the ballot count.
     weekCount: zod_1.z.number().int(),
 });
 exports.pollPredictionLeaderboardResponseSchema = zod_1.z.object({
     // Materialized leaderboard rows in final ranking order.
     entries: zod_1.z.array(exports.pollPredictionLeaderboardEntrySchema),
-    // Chalk comparison for the requested leaderboard scope.
+    // Chalk rank delta before bonuses for the requested week, not points for a submitted chalk ballot.
     chalkScore: zod_1.z.number().optional(),
     // Scored week numbers available in the leaderboard's week selector.
     availableWeeks: zod_1.z.array(zod_1.z.number().int()).optional(),
 });
 exports.pollPredictionUserBallotsResponseSchema = zod_1.z.object({
     user: user_1.reducedUserSchema.omit({ email: true }),
-    // Materialized season/all-time totals, including skipped-week chalk scores.
+    // Materialized season totals; skipped weeks contribute zero points.
     summary: exports.pollPredictionUserSummarySchema,
     // Actual submitted ballots only; skipped weeks appear in totals but not in this feed.
     ballots: zod_1.z.array(exports.pollPredictionBallotSchema),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rategame-shared",
-  "version": "1.1.534",
+  "version": "1.1.535",
   "description": "This package contains shared resources for the Rate Game project.",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",