Files
wikideck/scripts/game-card-data.mjs
T

52 lines
3.2 KiB
JavaScript

#!/usr/bin/env node
// Generates shared/game/card-data.ts from council-data's frozen files (docs/game/*.json).
// The engine does no I/O, so the data is embedded as constants. Rerun after the JSON changes:
// node scripts/game-card-data.mjs
import { readFileSync, writeFileSync } from 'node:fs';
const root = new URL('../', import.meta.url);
const sample = JSON.parse(readFileSync(new URL('docs/game/card-sample.json', root), 'utf8'));
const starter = JSON.parse(readFileSync(new URL('docs/game/starter-cards.json', root), 'utf8'));
// DESIGN §1.1: 99 ascending cut points per stat. Cut k (1..99) is the value at rank floor(k·n/100)
// of the sample's sorted scores; null attention is excluded from its table.
function cuts(values) {
const sorted = values.filter(v => typeof v === 'number').sort((a, b) => a - b);
if (sorted.length < 2) throw new Error('sample too small');
return Array.from({ length: 99 }, (_, i) => sorted[Math.min(sorted.length - 1, Math.floor((i + 1) * sorted.length / 100))]);
}
// Prefer council-data's published table (card-sample.json `percentiles`); fall back to computing it.
const official = sample.percentiles && ['attention', 'depth', 'reach'].every(stat => sample.percentiles[stat]?.length === 99);
const table = official ? { attention: sample.percentiles.attention, depth: sample.percentiles.depth, reach: sample.percentiles.reach }
: Object.fromEntries(['attention', 'depth', 'reach'].map(stat => [stat, cuts(sample.cards.map(c => c.stats?.[stat]))]));
const method = official ? sample.percentilesMethod : 'computed here: value at rank floor(k*n/100)';
const daysIn = month => { const [y, m] = month.split('-').map(Number); return new Date(Date.UTC(y, m, 0)).getUTCDate(); };
const pool = starter.cards.map(c => ({
pageId: c.pageId, title: c.title, category: c.category,
stats: { attention: c.stats.attention ?? null, depth: c.stats.depth, reach: c.stats.reach },
trendPercent: c.trendPercent ?? null,
dailyAverage: typeof c.monthlyViews === 'number' && c.latestMonth ? Math.round(c.monthlyViews / daysIn(c.latestMonth) * 100) / 100 : null,
}));
const out = `// GENERATED by scripts/game-card-data.mjs from docs/game/card-sample.json (${sample.cards.length} cards,
// generated ${sample.generatedAt}) and docs/game/starter-cards.json (frozen ${starter.frozenAt}). Do not edit by hand.
// Percentiles: ${method}
import type { PercentileTable } from './derive.ts';
import type { Faction } from './types.ts';
/** DESIGN §1.1 reference table "card-sample-2026-11-16": 99 cut points per stat. */
export const CARD_SAMPLE_PERCENTILES: PercentileTable = ${JSON.stringify(table)};
export interface LoanerSnapshot {
pageId: number; title: string; category: Faction;
stats: { attention: number | null; depth: number; reach: number };
trendPercent: number | null; dailyAverage: number | null;
}
/** Frozen loaner pool (§2): real snapshots of random articles, for filling deck slots and draft modes. */
export const LOANER_SNAPSHOTS: readonly LoanerSnapshot[] = ${JSON.stringify(pool, null, 1).replace(/\n\s*/g, ' ')};
`;
writeFileSync(new URL('shared/game/card-data.ts', root), out);
console.log(`card-data.ts: ${pool.length} loaners, percentile tables from ${sample.cards.length} sample cards`);