@journey-to-code/games 0.0.0-stage → 0.1.0

package/dist/kingscup.js

@@ -0,0 +1,185 @@
+import { botGiveTarget, drink, DRINK_NOTE, newTally } from "./drinks.js";
+import { clone, FULL, GameError, makeDeck, nextRandom, rankLabel, rankSeats, shuffled, SYMBOL, who } from "./kit.js";
+export const classicKingsCup = { id: "kingscup-classic", name: "Kings Cup", sips: 2 };
+export const gentleKingsCup = { ...classicKingsCup, id: "kingscup-gentle", name: "Gentle (one sip)", sips: 1 };
+/** Each rank's rule: its name, what to do, and whether whoever drew picks someone. */
+export const KINGS_RULES = {
+    14: { name: "Waterfall", text: "Everyone drinks, starting with whoever drew; nobody stops until the person before them does." },
+    2: { name: "You", text: "Pick someone to drink.", pick: "Who drinks?" },
+    3: { name: "Me", text: "Whoever drew drinks." },
+    4: { name: "Floor", text: "Everyone touch the floor! Last one drinks.", pick: "Who was last to touch the floor?" },
+    5: { name: "Thumb master", text: "Whoever drew is thumb master: put your thumb on the table any time, and the last to copy drinks." },
+    6: { name: "Social", text: "Everyone drinks!" },
+    7: { name: "Heaven", text: "Everyone point up! Last one drinks.", pick: "Who was last to point up?" },
+    8: { name: "Mate", text: "Pick a mate: whenever you drink, they drink too.", pick: "Who's your mate?" },
+    9: { name: "Rhyme", text: "Say a word; round the table, everyone rhymes with it. Whoever can't, drinks.", pick: "Who couldn't rhyme?" },
+    10: { name: "Categories", text: "Name a category; round the table, everyone names one thing in it. Whoever can't, drinks.", pick: "Who ran out?" },
+    11: { name: "Make a rule", text: "Make a rule everyone has to follow (no saying 'drink', left hands only…). Break it, drink." },
+    12: { name: "Question master", text: "Whoever drew is question master: answer any question they ask with a question… or drink." },
+    13: { name: "King's Cup", text: "Pour some of your drink into the King's Cup. Whoever draws the fourth king drinks the cup!" },
+};
+const rank = (c) => c.rank;
+const label = (c) => `${rankLabel(rank(c))}${SYMBOL[c.suit]}`;
+export function newKingsCup(rules, seats, seed) {
+    const s = { game: "kingscup", rules, seats, rng: seed >>> 0, hand: 0, dealer: seed % seats, phase: "draw", last: null, kings: 0, thumb: null, question: null, rule: null, loser: null, narration: null };
+    s.deck = shuffled(makeDeck({ ranks: FULL }), nextRandom(s));
+    s.mates = Array(seats).fill(null);
+    s.tally = newTally(seats);
+    s.turn = (s.dealer + 1) % seats;
+    return s;
+}
+/** Drink, and take your mates along. */
+function drinkWithMates(s, seats, n) {
+    const all = new Set(seats);
+    for (const x of seats)
+        if (s.mates[x] !== null)
+            all.add(s.mates[x]);
+    return drink(s.tally, [...all], n);
+}
+function apply(state, seat, move) {
+    const s = clone(state);
+    if (s.phase === "finished")
+        throw new GameError("The game is over.");
+    if (s.turn !== seat)
+        throw new GameError("It's not your turn.");
+    const everyone = Array.from({ length: s.seats }, (_, i) => i);
+    if (move.type === "pick") {
+        if (s.phase !== "pick" || !s.last)
+            throw new GameError("Draw a card first.");
+        const to = Number(move.to);
+        const r = rank(s.last);
+        if (!(to >= 0 && to < s.seats) || (to === seat && (r === 2 || r === 8)))
+            throw new GameError("Pick someone else.");
+        if (r === 8) {
+            for (const x of [seat, to])
+                if (s.mates[x] !== null)
+                    s.mates[s.mates[x]] = null;
+            s.mates[seat] = to;
+            s.mates[to] = seat;
+            s.narration = `${who(seat)} and ${who(to)} are mates 🤝`;
+        }
+        else
+            s.narration = `${KINGS_RULES[r].name}: ${drinkWithMates(s, [to], s.rules.sips)}`;
+        s.phase = "draw";
+        s.turn = (seat + 1) % s.seats;
+        return s;
+    }
+    if (move.type !== "draw" || s.phase !== "draw")
+        throw new GameError("Pick someone first.");
+    const c = s.deck.pop();
+    s.last = c;
+    const r = rank(c);
+    const rule = KINGS_RULES[r];
+    let line = "";
+    if (r === 14)
+        line = drinkWithMates(s, everyone, s.rules.sips + 1);
+    else if (r === 3)
+        line = drinkWithMates(s, [seat], s.rules.sips);
+    else if (r === 6)
+        line = drinkWithMates(s, everyone, 1);
+    else if (r === 5)
+        s.thumb = seat;
+    else if (r === 12)
+        s.question = seat;
+    else if (r === 11)
+        s.rule = seat;
+    else if (r === 13) {
+        s.kings += 1;
+        if (s.kings === 4) {
+            s.loser = seat;
+            s.phase = "finished";
+            s.narration = `${who(seat)} drew the fourth king: ${drinkWithMates(s, [seat], 99)} (the King's Cup!) 👑`;
+            return s;
+        }
+    }
+    s.narration = `${who(seat)} drew the ${label(c)}: ${rule.name}${line ? ` · ${line}` : ""}${r === 13 ? ` (${s.kings} of 4)` : ""}`;
+    if (rule.pick) {
+        s.phase = "pick";
+        return s;
+    }
+    s.turn = (seat + 1) % s.seats;
+    if (!s.deck.length) {
+        s.phase = "finished";
+        s.narration += " · That's the deck!";
+    }
+    return s;
+}
+function view(s, seat) {
+    const over = s.phase === "finished";
+    const mine = !over && s.turn === seat;
+    let choices = null;
+    if (mine && s.phase === "draw")
+        choices = { prompt: "", options: [{ label: "Draw a card", move: { type: "draw" }, primary: true }] };
+    if (mine && s.phase === "pick" && s.last) {
+        const r = rank(s.last);
+        const options = Array.from({ length: s.seats }, (_, i) => i)
+            .filter((i) => !((r === 2 || r === 8) && i === seat))
+            .map((i) => ({ label: i === seat ? "Me" : who(i), move: { type: "pick", to: i } }));
+        choices = { prompt: KINGS_RULES[r].pick, options, layout: "list" };
+    }
+    const roles = (i) => [i === s.thumb ? "👍 Thumb master" : "", i === s.question ? "❓ Question master" : "", i === s.rule ? "📜 Rule maker" : "", s.mates[i] !== null ? "🤝 Has a mate" : ""].filter(Boolean).join(" · ");
+    const rule = s.last ? KINGS_RULES[rank(s.last)] : null;
+    return {
+        game: "kingscup",
+        seats: s.seats,
+        me: seat,
+        teams: false,
+        phase: s.phase,
+        turn: over ? null : s.turn,
+        dealer: s.dealer,
+        hand: [],
+        handHidden: "none",
+        tap: null,
+        pick: null,
+        choices,
+        players: s.tally.drank.map((d, i) => ({ cards: 0, line: [`🍺 ${d}`, roles(i)].filter(Boolean).join(" · "), dealer: i === s.dealer })),
+        center: { kind: "piles", stock: s.deck.length, discard: s.last ? [s.last] : [], discardCount: s.last ? 52 - s.deck.length : 0, drawMove: mine && s.phase === "draw" ? { type: "draw" } : null, takeMove: null, stockLabel: `👑 ${s.kings} of 4 kings`, discardLabel: rule ? rule.name : "Draw to start" },
+        melds: [],
+        info: [...(rule ? [rule.text] : ["Draw a card and do what it says."]), DRINK_NOTE],
+        narration: s.narration,
+        scores: s.tally.drank.map((value, i) => ({ seats: [i], value })),
+        result: null,
+        over: over ? { winners: Array.from({ length: s.seats }, (_, i) => i).filter((i) => i !== s.loser), title: s.loser !== null ? `${who(s.loser)} drinks the King's Cup!` : "That's the deck!" } : null,
+    };
+}
+function bot(s, seat, _style) {
+    if (s.phase === "finished" || s.turn !== seat)
+        return null;
+    if (s.phase === "draw")
+        return { type: "draw" };
+    return { type: "pick", to: botGiveTarget(s.tally, seat, s.seats) };
+}
+export const kingsCup = {
+    id: "kingscup",
+    name: "Kings Cup",
+    emoji: "👑",
+    blurb: "Drinking game: every card has a rule",
+    tagline: "A drinking game. Draw a card and follow its rule. Whoever draws the fourth king drinks the King's Cup!",
+    seats: { min: 2, max: 10, default: 5 },
+    teams: false,
+    presets: [classicKingsCup, gentleKingsCup],
+    fields: [{ key: "sips", label: "Sips for You, Me and the rest", kind: "choice", options: [[1, "1"], [2, "2"], [3, "3"]] }],
+    normalize(rules) {
+        const given = (rules && typeof rules === "object" ? rules : {});
+        const base = [classicKingsCup, gentleKingsCup].find((p) => p.id === given.id) ?? classicKingsCup;
+        const r = { ...base, ...given };
+        return { ...r, sips: Math.min(5, Math.max(1, Number(r.sips) || 2)) };
+    },
+    validate: () => [],
+    describe: () => [
+        `${DRINK_NOTE} Adults only.`,
+        "Take turns drawing a card. Each rank has a rule:",
+        ...[14, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13].map((r) => `${rankLabel(r)} · ${KINGS_RULES[r].name}: ${KINGS_RULES[r].text}`),
+        "For the rules played out at the table, whoever drew picks who drinks.",
+    ],
+    newGame: newKingsCup,
+    apply,
+    view,
+    bot,
+    thinkingTime: (s) => (s.phase === "pick" ? 2200 : 1600),
+    summary(s) {
+        const over = s.phase === "finished";
+        return { game: "kingscup", rules: s.rules.name, phase: s.phase, over, hand: 1, scoreLine: s.tally.drank.join(" · ") + " drinks", order: over ? rankSeats(s.tally.drank.map((score, i) => ({ seats: [i], score })), true) : null, winners: over ? Array.from({ length: s.seats }, (_, i) => i).filter((i) => i !== s.loser) : null, teams: false, seats: s.seats };
+    },
+};
+//# sourceMappingURL=kingscup.js.map

package/dist/kingscup.js.map

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

package/dist/kit.d.ts

@@ -0,0 +1,283 @@
+import type { Card, Suit } from "@journey-to-code/rules";
+import { type BaseRules, type CardGameId, type Choices, type GameOver, type RoundResult, type RuleField, type Scores, type TableGame } from "./table.js";
+export * from "./table.js";
+export type PipCard = Extract<Card, {
+    kind: "pip";
+}>;
+export declare const SUITS: Suit[];
+export declare const SYMBOL: Record<Suit, string>;
+export declare const rankLabel: (rank: number) => string;
+export declare const rankWord: (rank: number) => string;
+/**
+ * A card with its own id. Games with two decks (Pinochle, Canasta) have identical cards, so every
+ * card a kit game deals carries a unique `id` ("A♠", or "A♠·2" for the second copy). Moves name
+ * cards by id.
+ */
+/** A card from a colour-card deck (Fruit Salad): a fruit and a number or an action; wild cards have no fruit. */
+export type FruitCard = {
+    kind: "fruit";
+    fruit: Fruit | null;
+    face: FruitFace;
+};
+export type Fruit = "cherry" | "lemon" | "pear" | "grape";
+export type FruitFace = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | "hop" | "turn" | "plus2" | "salad" | "salad4";
+export type KCard = (Card | FruitCard) & {
+    id: string;
+};
+/** Decks: which ranks, how many copies, how many jokers. Copies after the first get "·2", "·3". */
+export declare function makeDeck({ ranks, copies, jokers }: {
+    ranks: number[];
+    copies?: number;
+    jokers?: number;
+}): KCard[];
+export declare const FULL: number[];
+export declare const isPip: (c: Card | FruitCard) => c is PipCard & {
+    id: string;
+};
+export declare const plainId: (c: Card) => string;
+/** Find cards in a hand by id; throws a GameError when one isn't there. */
+export declare function takeCards(hand: KCard[], ids: string[]): {
+    taken: KCard[];
+    rest: KCard[];
+};
+/** Sort by suit (alternating colours: ♠ ♥ ♣ ♦), then high to low, with an optional rank order. */
+export declare function sortCards(cards: KCard[], power?: (c: KCard) => number, suitOf?: (c: KCard) => Suit | "joker"): KCard[];
+export interface SeatInfo {
+    /** Cards in hand. */
+    cards: number;
+    /** A short line under the name: "Bid 3 · Took 1", "12 points". */
+    line: string;
+    /** Partners: 0 or 1 (seats 0 and 2 are team 0). */
+    team?: 0 | 1;
+    dealer?: boolean;
+    /** Out of this hand, or sitting it out (a partner going alone). */
+    out?: boolean;
+    /** A small badge: "Called it", "Alone", "Knocked". */
+    badge?: string;
+}
+export type Center = {
+    kind: "trick";
+    plays: {
+        seat: number;
+        card: KCard;
+    }[];
+    winner: number | null;
+    lead?: string | null;
+} | {
+    kind: "piles";
+    /** Cards left to draw, or null for no stock. */
+    stock: number | null;
+    /** The discard pile, newest last (the last few). */
+    discard: KCard[];
+    discardCount: number;
+    /** Tapping the stock or the top discard sends these moves (when it's your move). */
+    drawMove: Record<string, unknown> | null;
+    takeMove: Record<string, unknown> | null;
+    /** A note on the pile: "Frozen", "Suit: ♥". */
+    note?: string | null;
+    /** What to call the piles, when it isn't "N to draw" and "N in the pile" (Euchre's kitty). */
+    stockLabel?: string;
+    discardLabel?: string;
+    /** The discard pile is face down (Bluff): drawn as backs, discardCount of them. */
+    faceDown?: boolean;
+    /** Only a stock, no discard pile beside it (Go Fish's pond). */
+    noDiscard?: boolean;
+    /** The discard pile spread out so every card shows; tapping one of `cards` sends { type, card } (Rummy 500). */
+    spread?: {
+        type: string;
+        cards: string[];
+    };
+    /** Face-down cards after the spread (the dealer's hole card in Blackjack). */
+    spreadHidden?: number;
+    /** A card just drawn, shown beside the piles until it's placed (Golf). */
+    held?: KCard | null;
+    heldLabel?: string;
+}
+/**
+ * A solitaire layout (Klondike, FreeCell): the stock and the turned cards, the foundations (their
+ * top cards), free cells, and the columns (how many face down, then the face-up cards). Tapping one
+ * of `tap.cards` sends { type, card }; tapping the stock sends drawMove.
+ */
+ | {
+    kind: "solitaire";
+    stock: number | null;
+    waste: KCard[];
+    foundations: (KCard | null)[];
+    /** What an empty foundation shows (suit marks by default). */
+    foundationLabels?: string[];
+    cells: (KCard | null)[] | null;
+    columns: {
+        down: number;
+        up: KCard[];
+    }[];
+    tap: {
+        type: string;
+        cards: string[];
+    } | null;
+    /**
+     * Dragging one of `tap.cards` to a place of your choosing sends { type, card, to, index }:
+     * `to` is "column" or "cell" with its index, or "foundation" (only when `foundations` is true).
+     */
+    drop?: {
+        type: string;
+        foundations: boolean;
+    } | null;
+    drawMove: Record<string, unknown> | null;
+    stockLabel?: string;
+}
+/**
+ * A cross of piles round the stock (Kings in the Corner): the four sides (top, right, bottom, left)
+ * then the four corners (top-left, top-right, bottom-right, bottom-left). Each pile shows its top
+ * card with its bottom card peeking out; tapping a pile sends its move.
+ */
+ | {
+    kind: "cross";
+    stock: number;
+    piles: {
+        cards: KCard[];
+        empty?: string;
+        move: Record<string, unknown> | null;
+        label: string;
+        note?: string;
+    }[];
+    /** In a row beside the stock instead (Spite and Malice's building piles). */
+    layout?: "row";
+}
+/** Pyramid solitaire: rows of cards (null once cleared), the stock and the turned-up card. */
+ | {
+    kind: "pyramid";
+    /** null: an empty place; "back": a card still face down. */
+    rows: (KCard | null | "back")[][];
+    /** No stock beside it (the drinking-game pyramids). */
+    noStock?: boolean;
+    tap: {
+        type: string;
+        cards: string[];
+    } | null;
+    held: string | null;
+    stock: number;
+    waste: KCard | null;
+    drawMove: Record<string, unknown> | null;
+    stockLabel: string;
+}
+/** Cards in a grid in the middle (Memory); null is face down. Tapping a cell sends { type, index }. */
+ | {
+    kind: "board";
+    cols: number;
+    cards: (KCard | null)[];
+    empty: number[];
+    tap: {
+        type: string;
+        cells: number[];
+    } | null;
+}
+/** Attacks and the cards that beat them (Durak), beside the stock with the trump card under it. */
+ | {
+    kind: "pairs";
+    stock: number;
+    trumpCard: KCard | null;
+    trumpLabel: string;
+    pairs: {
+        attack: KCard;
+        defense: KCard | null;
+    }[];
+    discards: number;
+}
+/** Another player's hand, face down: tap a card to take it (Old Maid). Sends { type: takeType, index }. */
+ | {
+    kind: "fan";
+    from: number;
+    count: number;
+    takeType: string | null;
+    label?: string;
+} | {
+    kind: "none";
+};
+export interface Meld {
+    /** Whose: a seat, or a team (0 or 1) when the game melds by team. */
+    owner: number;
+    byTeam?: boolean;
+    label?: string;
+    cards: KCard[];
+}
+export interface KitView {
+    game: CardGameId;
+    seats: number;
+    me: number;
+    teams: boolean;
+    phase: string;
+    /** Whose move it is, or null when everyone may move (passing cards, say). */
+    turn: number | null;
+    dealer: number;
+    hand: KCard[];
+    /** Your own cards are face down and unseen (War): the table shows your pile, not a hand. "none": no cards of your own at all (Memory). */
+    handHidden?: boolean | "none";
+    /** Tapping one of these cards in your hand sends { type, card: id }. */
+    tap: {
+        type: string;
+        cards: string[];
+    } | null;
+    /** Pick several cards, then press one of the buttons: sends { type, cards: ids }. */
+    pick: {
+        min: number;
+        max: number;
+        prompt: string;
+        cards: string[];
+        actions: {
+            label: string;
+            type: string;
+            primary?: boolean;
+            extra?: Record<string, unknown>;
+        }[];
+    } | null;
+    /** Buttons: a bid, a trump call, "Next hand". */
+    choices: Choices | null;
+    players: SeatInfo[];
+    center: Center;
+    melds: Meld[];
+    /** Cards laid out in front of each player in rows and columns (Golf); null is a face-down card. */
+    grids?: {
+        owner: number;
+        cols: number;
+        cards: (KCard | null)[]; /** Cells drawn as empty spaces. */
+        empty?: number[];
+    }[];
+    /** Cells of your own grid you can tap now: sends { type, index }. */
+    gridTap?: {
+        type: string;
+        cells: number[];
+        prompt?: string;
+    } | null;
+    /** A score track (Cribbage's board): each side's front peg, and the back peg where it was before. */
+    track?: {
+        to: number;
+        pegs: {
+            seats: number[];
+            value: number;
+            back: number;
+        }[];
+    };
+    /** Small facts for the table: "Trump ♥", "Hearts broken", "Hand 3 of 13". */
+    info: string[];
+    /** What just happened, in words. */
+    narration: string | null;
+    /** The scoreboard: one entry per side (team or player): the seats on that side and its score. */
+    scores: Scores;
+    /** After a hand: what it scored, a column per side (the seats on it), until everyone moves on. */
+    result: RoundResult | null;
+    over: GameOver | null;
+}
+/** A card game: an engine whose seats see a `KitView`. */
+export interface CardGame<R extends BaseRules = BaseRules, S = unknown, M = Record<string, unknown>> extends TableGame<R, S, M, KitView> {
+    id: CardGameId;
+}
+/** The house-rule switch, for a game's `fields`. */
+export declare const drinkingField: <R>(hint?: string) => RuleField<R>;
+/** "Lou drinks 2" (one or more seats). */
+export declare function drinkLine(seats: number[], n: number): string;
+/** Add a drinking line to a narration when drinking mode is on. */
+export declare const withDrinks: (on: boolean, narration: string | null, seats: number[], n: number) => string | null;
+/** Give a game a drinking mode: the house-rule switch, and a line in its rules when it's on. */
+export declare function withDrinking<R extends BaseRules & {
+    drinking?: boolean;
+}, S, M>(game: CardGame<R, S, M>, hint: string, line: string): CardGame<R, S, M>;

package/dist/kit.js

@@ -0,0 +1,73 @@
+import { GameError, who } from "./table.js";
+export * from "./table.js";
+export const SUITS = ["spades", "hearts", "diamonds", "clubs"];
+export const SYMBOL = { spades: "♠", hearts: "♥", diamonds: "♦", clubs: "♣" };
+const RANK_LABEL = { 11: "J", 12: "Q", 13: "K", 14: "A" };
+export const rankLabel = (rank) => RANK_LABEL[rank] ?? String(rank);
+const RANK_WORD = { 11: "jack", 12: "queen", 13: "king", 14: "ace" };
+export const rankWord = (rank) => RANK_WORD[rank] ?? String(rank);
+const baseId = (c) => (c.kind === "joker" ? (c.size === "big" ? "BJ" : "LJ") : `${rankLabel(c.rank)}${SYMBOL[c.suit]}`);
+/** Decks: which ranks, how many copies, how many jokers. Copies after the first get "·2", "·3". */
+export function makeDeck({ ranks, copies = 1, jokers = 0 }) {
+    const out = [];
+    for (let copy = 1; copy <= copies; copy++) {
+        const tag = copy === 1 ? "" : `·${copy}`;
+        for (const suit of SUITS)
+            for (const rank of ranks)
+                out.push({ kind: "pip", suit, rank, id: `${rankLabel(rank)}${SYMBOL[suit]}${tag}` });
+        for (let j = 0; j < jokers; j++) {
+            const size = j % 2 === 0 ? "big" : "little";
+            out.push({ kind: "joker", size, id: `${size === "big" ? "BJ" : "LJ"}${copy === 1 && j < 2 ? "" : `·${copy}${j >= 2 ? j : ""}`}` });
+        }
+    }
+    return out;
+}
+export const FULL = [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14];
+export const isPip = (c) => c.kind === "pip";
+export const plainId = baseId;
+/** Find cards in a hand by id; throws a GameError when one isn't there. */
+export function takeCards(hand, ids) {
+    if (new Set(ids).size !== ids.length)
+        throw new GameError("Pick each card once.");
+    const taken = [];
+    for (const id of ids) {
+        const card = hand.find((c) => c.id === id);
+        if (!card)
+            throw new GameError("You don't have that card.");
+        taken.push(card);
+    }
+    return { taken, rest: hand.filter((c) => !ids.includes(c.id)) };
+}
+/** Sort by suit (alternating colours: ♠ ♥ ♣ ♦), then high to low, with an optional rank order. */
+export function sortCards(cards, power = (c) => (isPip(c) ? c.rank : 100), suitOf = (c) => (isPip(c) ? c.suit : "joker")) {
+    const order = { joker: -1, spades: 0, hearts: 1, clubs: 2, diamonds: 3 };
+    return [...cards].sort((a, b) => order[suitOf(a)] - order[suitOf(b)] || power(b) - power(a));
+}
+// ---- Drinking mode -----------------------------------------------------------------------------
+// A house rule some party games offer (off unless a table turns it on): the round's losers drink.
+/** The house-rule switch, for a game's `fields`. */
+export const drinkingField = (hint = "Adults only. Losers drink (or sip water).") => ({ key: "drinking", label: "Drinking mode 🍺", hint, kind: "toggle" });
+/** "Lou drinks 2" (one or more seats). */
+export function drinkLine(seats, n) {
+    if (!seats.length || n <= 0)
+        return "";
+    return `🍺 ${seats.map(who).join(" and ")} drink${seats.length === 1 ? "s" : ""} ${n === 99 ? "the rest of the glass" : n}`;
+}
+/** Add a drinking line to a narration when drinking mode is on. */
+export const withDrinks = (on, narration, seats, n) => on && seats.length && n > 0 ? [narration, drinkLine(seats, n)].filter(Boolean).join(" · ") : narration;
+/** Give a game a drinking mode: the house-rule switch, and a line in its rules when it's on. */
+export function withDrinking(game, hint, line) {
+    return {
+        ...game,
+        // A preset too, so it's one pick in the house-rules list.
+        presets: [...game.presets, { ...game.presets[0], id: `${game.presets[0].id}-drinking`, name: `Drinking ${game.name} 🍺`, drinking: true }],
+        fields: [...game.fields, drinkingField(hint)],
+        normalize: (rules) => {
+            const given = rules;
+            const preset = given?.id === `${game.presets[0].id}-drinking`;
+            return { ...game.normalize(preset ? { ...given, id: game.presets[0].id } : rules), ...(preset ? { id: given.id, name: `Drinking ${game.name} 🍺` } : {}), drinking: given?.drinking !== undefined ? !!given.drinking : preset };
+        },
+        describe: (r) => [...game.describe(r), ...(r.drinking ? [`🍺 Drinking mode: ${line}`] : [])],
+    };
+}
+//# sourceMappingURL=kit.js.map

package/dist/kit.js.map

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

package/dist/klondike.d.ts

@@ -0,0 +1,57 @@
+import { type BaseRules, type CardGame, type KCard } from "./kit.js";
+export interface KlondikeRules extends BaseRules {
+    /** Cards turned from the stock at a time. */
+    draw: 1 | 3;
+}
+export declare const klondikeOne: KlondikeRules;
+export declare const klondikeThree: KlondikeRules;
+type Phase = "playing" | "finished";
+export interface Column {
+    down: KCard[];
+    up: KCard[];
+}
+export interface KlondikeState {
+    game: "klondike";
+    rules: KlondikeRules;
+    seats: 1;
+    rng: number;
+    hand: number;
+    dealer: 0;
+    phase: Phase;
+    stock: KCard[];
+    /** Turned cards, the playable one last. */
+    waste: KCard[];
+    /** One pile per suit, in SUITS order, ace first. */
+    foundations: KCard[][];
+    columns: Column[];
+    moves: number;
+    passes: number;
+    /** Draws since anything else happened: a computer player who has gone all the way round gives up. */
+    idle: number;
+    won: boolean;
+    /** Earlier positions for Undo (the most recent last). */
+    history: string[];
+    narration: string | null;
+}
+export declare function newKlondike(rules: KlondikeRules, _seats: number, seed: number): KlondikeState;
+type Move = {
+    type: "auto";
+    card: string;
+}
+/** The card (and anything on it) to a place you choose: a column by its index, or home. */
+ | {
+    type: "move";
+    card: string;
+    to: "foundation" | "column";
+    index?: number;
+} | {
+    type: "draw";
+} | {
+    type: "undo";
+} | {
+    type: "finish";
+} | {
+    type: "resign";
+};
+export declare const klondike: CardGame<KlondikeRules, KlondikeState, Move>;
+export {};