128 lines
7.3 KiB
TypeScript
128 lines
7.3 KiB
TypeScript
/**
|
||
* PLACEHOLDER loaner cards and starter decks (DESIGN §2) so the engine, UI and
|
||
* sims can run before council-data's docs/game/starter-cards.json lands.
|
||
* Loaners are off-chain preview cards: not NFTs, never minted or moved.
|
||
* engine-b / council-data replace STARTER_POOL with derived cards (cards.ts).
|
||
*/
|
||
import { DEFAULT_DERIVATION, deriveCard, type CardInput, type DerivationRules } from './derive.ts';
|
||
import { Rng } from './rng.ts';
|
||
import type { Faction, GameCard, Stat } from './types.ts';
|
||
|
||
type Spec = [pageId: number, title: string, faction: Faction, cost: number, home: Stat];
|
||
|
||
/** DESIGN §1.3 powerByCost and §10.1 keyword choice (cost 1 = vanilla +vanillaBonus). pageIds outside shared/catalog.ts are unverified. */
|
||
const POWER_BY_COST = [0, 1, 2, 4, 6, 8, 10];
|
||
const VANILLA_BONUS = 1;
|
||
const FACTION_KEYWORD: Record<Faction, string> = {
|
||
Culture: 'viral', Nature: 'rising', People: 'local', Science: 'encyclopedic', History: 'nostalgic', Space: 'translated',
|
||
};
|
||
|
||
export const STARTER_POOL: readonly Spec[] = [
|
||
[22780, 'Octopus', 'Nature', 1, 'depth'],
|
||
[19331, 'Moon', 'Space', 1, 'reach'],
|
||
[23053, 'Periodic table', 'Science', 1, 'depth'],
|
||
[3383, 'Bronze Age', 'History', 1, 'depth'],
|
||
[5843419, 'Chess', 'Culture', 2, 'attention'],
|
||
[9228, 'Earth', 'Space', 2, 'reach'],
|
||
[2008, 'Ada Lovelace', 'People', 2, 'attention'],
|
||
[21830, 'Honey bee', 'Nature', 2, 'depth'],
|
||
[736, 'Albert Einstein', 'People', 3, 'reach'],
|
||
[10979, 'Fungus', 'Nature', 3, 'depth'],
|
||
[26903, 'Solar System', 'Space', 3, 'reach'],
|
||
[30758, 'Roman Empire', 'History', 3, 'depth'],
|
||
[9649, 'Evolution', 'Science', 4, 'depth'],
|
||
[8424, 'Jazz', 'Culture', 4, 'attention'],
|
||
[12898, 'Marie Curie', 'People', 4, 'reach'],
|
||
[14533, 'Silk Road', 'History', 4, 'reach'],
|
||
[19468, 'Mount Everest', 'Nature', 5, 'attention'],
|
||
[22936, 'Photosynthesis', 'Science', 5, 'depth'],
|
||
[18110, 'Leonardo da Vinci', 'People', 5, 'reach'],
|
||
[14627, 'Ancient Egypt', 'History', 5, 'attention'],
|
||
[4177, 'Black hole', 'Space', 6, 'attention'],
|
||
[25443, 'Quantum mechanics', 'Science', 6, 'depth'],
|
||
[17867, 'Library of Alexandria', 'History', 6, 'depth'],
|
||
[20217, 'Music', 'Culture', 6, 'reach'],
|
||
];
|
||
|
||
export function loanerCard(spec: Spec, copy = 0): GameCard {
|
||
const [pageId, title, faction, cost, home] = spec;
|
||
const keyword = cost === 1 ? null : FACTION_KEYWORD[faction];
|
||
return {
|
||
cardId: `loaner:${pageId}:${copy}`, pageId, title, faction, rarity: 'Common', cost,
|
||
power: POWER_BY_COST[cost] + (keyword ? 0 : VANILLA_BONUS), home, trend: 0, keyword, source: 'loaner', check: 'loaner',
|
||
};
|
||
}
|
||
|
||
/** Every placeholder loaner card, once each (24 cards). Draft modes can sample from this. */
|
||
export function previewPool(): GameCard[] { return STARTER_POOL.map(spec => loanerCard(spec)); }
|
||
|
||
/** A deterministic 12-card loaner deck: 2 cards of each cost 1–6, chosen by `seed`. */
|
||
export function starterDeck(seed: number | string): GameCard[] {
|
||
const rng = Rng.fromSeed(`starter:${seed}`);
|
||
const deck: GameCard[] = [];
|
||
for (let cost = 1; cost <= 6; cost++) {
|
||
deck.push(...rng.shuffle(STARTER_POOL.filter(spec => spec[3] === cost)).slice(0, 2).map(spec => loanerCard(spec)));
|
||
}
|
||
return deck;
|
||
}
|
||
|
||
// ---------- DESIGN §2.1 starter decks v1 (PR #18) ----------
|
||
|
||
type Pin = [cost: number, title: string, faction: Faction, home: Stat];
|
||
|
||
/** Real pageIds for the shared/catalog.ts cards; the others have none yet (§2.1), see loanerPageId. */
|
||
const CATALOG_PAGE_IDS: Record<string, number> = { Moon: 19331, 'Periodic table': 23053, Octopus: 22780, 'Albert Einstein': 736 };
|
||
|
||
export interface StarterDeckDef { id: string; name: string; cards: readonly Pin[] }
|
||
|
||
/** Four 12-card loaner decks, each with the curve 1,1,2,2,3,3,3,4,4,5,5,6, 6+6 factions and 4 cards per home stat. */
|
||
export const STARTER_DECKS: readonly StarterDeckDef[] = [
|
||
{ id: 'stargazers', name: 'Stargazers', cards: [
|
||
[1, 'Moon', 'Space', 'reach'], [1, 'Electron', 'Science', 'depth'], [2, 'Mars', 'Space', 'attention'],
|
||
[2, 'Periodic table', 'Science', 'depth'], [3, 'Saturn', 'Space', 'reach'], [3, 'Photosynthesis', 'Science', 'attention'],
|
||
[3, 'Black hole', 'Space', 'depth'], [4, 'Quantum mechanics', 'Science', 'reach'], [4, 'Milky Way', 'Space', 'attention'],
|
||
[5, 'DNA', 'Science', 'attention'], [5, 'Sun', 'Space', 'reach'], [6, 'Theory of relativity', 'Science', 'depth'],
|
||
] },
|
||
{ id: 'field-guide', name: 'Field Guide', cards: [
|
||
[1, 'Octopus', 'Nature', 'depth'], [1, 'Stonehenge', 'History', 'attention'], [2, 'Axolotl', 'Nature', 'attention'],
|
||
[2, 'Rosetta Stone', 'History', 'reach'], [3, 'Coral reef', 'Nature', 'depth'], [3, 'Roman Empire', 'History', 'reach'],
|
||
[3, 'Honey bee', 'Nature', 'attention'], [4, 'Ancient Egypt', 'History', 'depth'], [4, 'Amazon rainforest', 'Nature', 'reach'],
|
||
[5, 'Blue whale', 'Nature', 'attention'], [5, 'Great Wall of China', 'History', 'reach'], [6, 'World War II', 'History', 'depth'],
|
||
] },
|
||
{ id: 'headliners', name: 'Headliners', cards: [
|
||
[1, 'Haiku', 'Culture', 'attention'], [1, 'Ada Lovelace', 'People', 'depth'], [2, 'Jazz', 'Culture', 'attention'],
|
||
[2, 'Marie Curie', 'People', 'reach'], [3, 'Mona Lisa', 'Culture', 'reach'], [3, 'Frida Kahlo', 'People', 'attention'],
|
||
[3, 'Chess', 'Culture', 'depth'], [4, 'Leonardo da Vinci', 'People', 'reach'], [4, 'The Beatles', 'Culture', 'attention'],
|
||
[5, 'William Shakespeare', 'People', 'depth'], [5, 'Olympic Games', 'Culture', 'reach'], [6, 'Wolfgang Amadeus Mozart', 'People', 'depth'],
|
||
] },
|
||
{ id: 'pioneers', name: 'Pioneers', cards: [
|
||
[1, 'Sputnik 1', 'Space', 'reach'], [1, 'Nikola Tesla', 'People', 'attention'], [2, 'Hubble Space Telescope', 'Space', 'depth'],
|
||
[2, 'Isaac Newton', 'People', 'reach'], [3, 'Neil Armstrong', 'People', 'attention'], [3, 'Jupiter', 'Space', 'reach'],
|
||
[3, 'Galileo Galilei', 'People', 'depth'], [4, 'Albert Einstein', 'People', 'attention'], [4, 'International Space Station', 'Space', 'depth'],
|
||
[5, 'Apollo 11', 'Space', 'attention'], [5, 'Charles Darwin', 'People', 'reach'], [6, 'Solar System', 'Space', 'depth'],
|
||
] },
|
||
];
|
||
|
||
const kebab = (title: string) => title.toLowerCase().normalize('NFKD').replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
|
||
|
||
/** §2.1: the real pageId for the shared/catalog.ts cards, null for the rest (copies then count per cardId). */
|
||
export function loanerPageId(title: string): number | null {
|
||
return Object.hasOwn(CATALOG_PAGE_IDS, title) ? CATALOG_PAGE_IDS[title] : null;
|
||
}
|
||
|
||
/** The §1 CardInput for a pinned loaner. Snapshot stats are unused (pinned replaces §1.1–1.5). */
|
||
export function loanerInput([cost, title, faction, home]: Pin): CardInput {
|
||
return { cardId: `loaner:${kebab(title)}`, pageId: loanerPageId(title), title, category: faction, rarity: 'Common',
|
||
snapshot: { stats: { attention: null, depth: 0, reach: 0 } }, live: { trendPercent: null, dailyAverage: null },
|
||
check: 'loaner', pinned: { cost, home, faction } };
|
||
}
|
||
|
||
const NO_TABLE = { attention: [], depth: [], reach: [] };
|
||
|
||
/** A §2.1 starter deck by id, derived with the given rules (modes that change the curve change loaners too). */
|
||
export function starterDeckById(id: string, rules: DerivationRules = DEFAULT_DERIVATION): GameCard[] {
|
||
const def = STARTER_DECKS.find(deck => deck.id === id);
|
||
if (!def) throw new RangeError(`Unknown starter deck: ${id}`);
|
||
return def.cards.map(pin => deriveCard(loanerInput(pin), NO_TABLE, rules));
|
||
}
|