Skip to content

feat(main-street): branching & multi-level upgrade chains for Business cards #412

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
SorraTheOrc merged 4 commits into from
Mar 10, 2026
Merged

feat(main-street): branching & multi-level upgrade chains for Business cards #412

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
5fa4513
Initial plan
Copilot Mar 9, 2026
954cad8
Initial plan: branching & multi-level upgrades
Copilot Mar 10, 2026
7958317
feat: branching & multi-level upgrade system for Business cards
Copilot Mar 10, 2026
62c1861
refactor: extract findTargetBusinessSlot helper and eliminate duplica…
Copilot Mar 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
152 changes: 146 additions & 6 deletions example-games/main-street/MainStreetCards.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,14 @@ export interface BusinessCard {
incomeBonus: number;
/** Cumulative synergy range extension from applied upgrades. */
synergyRangeBonus: number;
/**
* IDs of upgrade cards that have been applied to this business instance,
* in application order. Used to enforce multi-level chain requirements and
* to prevent the same branch being applied twice.
*
* Omitting this field is treated as an empty array.
*/
appliedUpgrades?: string[];
}

/**
Expand All @@ -68,6 +76,13 @@ export interface EventCard {

/**
* An Upgrade card that enhances a specific Business card.
*
* Branching upgrades: multiple `UpgradeCard` entries may share the same
* `targetBusiness` and `requiredLevel`, giving the player a choice of which
* upgrade branch to take.
*
* Multi-level chains: set `requiredLevel > 0` so the card can only be applied
* after the business has already been upgraded that many times.
*/
export interface UpgradeCard {
readonly family: 'upgrade';
Expand All @@ -78,6 +93,14 @@ export interface UpgradeCard {
readonly incomeBonus: number;
readonly synergyRangeBonus: number;
readonly description: string;
/**
* Minimum business level required before this upgrade may be applied.
* 0 (default) = can be applied to the base (un-upgraded) business.
* 1 = can only be applied after the business has been upgraded once, etc.
*
* Omitting this field is equivalent to setting it to 0.
*/
readonly requiredLevel?: number;
}

/** Union of all card types in Main Street. */
Expand Down Expand Up @@ -140,14 +163,15 @@ export const CHALLENGE_BONUS_POINTS = 10;

/**
* Creates a fresh copy of a BusinessCard from template data.
* Mutable fields (level, incomeBonus, synergyRangeBonus) are reset.
* Mutable fields (level, incomeBonus, synergyRangeBonus, appliedUpgrades) are reset.
*/
function makeBusiness(template: Omit<BusinessCard, 'family' | 'level' | 'incomeBonus' | 'synergyRangeBonus'>): BusinessCard {
function makeBusiness(template: Omit<BusinessCard, 'family' | 'level' | 'incomeBonus' | 'synergyRangeBonus' | 'appliedUpgrades'>): BusinessCard {
return {
family: 'business',
level: 0,
incomeBonus: 0,
synergyRangeBonus: 0,
appliedUpgrades: [],
...template,
};
}
Expand All @@ -161,7 +185,7 @@ const BUSINESS_TEMPLATES: Omit<BusinessCard, 'family' | 'level' | 'incomeBonus'
baseIncome: 2,
synergyTypes: ['Food'],
upgradePath: 'Bakery',
maxLevel: 1,
maxLevel: 2,
description: 'Provides warm pastries. Gains +1 coin for each adjacent Food business.',
},
{
Expand All @@ -171,7 +195,7 @@ const BUSINESS_TEMPLATES: Omit<BusinessCard, 'family' | 'level' | 'incomeBonus'
baseIncome: 3,
synergyTypes: ['Food'],
upgradePath: 'Diner',
maxLevel: 1,
maxLevel: 2,
description: 'Serves quick meals. Gains +1 coin per adjacent Food business.',
},
{
Expand Down Expand Up @@ -265,7 +289,7 @@ const BUSINESS_TEMPLATES: Omit<BusinessCard, 'family' | 'level' | 'incomeBonus'
baseIncome: 3,
synergyTypes: ['Entertainment'],
upgradePath: 'Cinema',
maxLevel: 1,
maxLevel: 2,
description: 'Shows the latest films. Gains +1 coin per adjacent Entertainment business.',
},
// Multi-synergy bridge cards (belong to two synergy types)
Expand Down Expand Up @@ -306,7 +330,7 @@ const BUSINESS_TEMPLATES: Omit<BusinessCard, 'family' | 'level' | 'incomeBonus'
baseIncome: 3,
synergyTypes: ['Service', 'Entertainment'],
upgradePath: 'Day Spa',
maxLevel: 1,
maxLevel: 2,
description: 'Relaxation and pampering. Bridges Service and Entertainment synergies.',
},
// Additional variety
Expand Down Expand Up @@ -538,6 +562,7 @@ const EVENT_TEMPLATES: EventCard[] = [

/** Template data for all Upgrade cards (M1 + M2 pool). */
const UPGRADE_TEMPLATES: UpgradeCard[] = [
// ── M1 Base Upgrades (requiredLevel: 0) ─────────────────────
{
family: 'upgrade',
id: 'upg-patisserie',
Expand All @@ -546,6 +571,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 4,
incomeBonus: 1,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Turns a Bakery into a Patisserie, increasing income and synergy range.',
},
{
Expand All @@ -556,6 +582,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 4,
incomeBonus: 1,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Turns a Diner into a Bistro with higher foot-traffic.',
},
{
Expand All @@ -566,6 +593,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 3,
incomeBonus: 1,
synergyRangeBonus: 0,
requiredLevel: 0,
description: 'Adds a cultural boost to the Bookshop.',
},
// ── M2 Expanded Upgrade Templates ───────────────────────────
Expand All @@ -577,6 +605,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 3,
incomeBonus: 1,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Expands the Park into a Garden with extended cultural reach.',
},
{
Expand All @@ -587,6 +616,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 4,
incomeBonus: 1,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Transforms the Hardware Store into a Home Improvement center.',
},
{
Expand All @@ -597,6 +627,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 3,
incomeBonus: 1,
synergyRangeBonus: 0,
requiredLevel: 0,
description: 'Rebrands the Pawn Shop as a trendy Vintage Shop.',
},
{
Expand All @@ -607,6 +638,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 4,
incomeBonus: 1,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Elevates the Boutique to a Designer Store with premium clientele.',
},
{
Expand All @@ -617,6 +649,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 3,
incomeBonus: 1,
synergyRangeBonus: 0,
requiredLevel: 0,
description: 'Upgrades the Laundromat to a full-service Dry Cleaners.',
},
{
Expand All @@ -627,6 +660,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 3,
incomeBonus: 1,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Expands the Barbershop into a modern Salon.',
},
{
Expand All @@ -637,6 +671,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 4,
incomeBonus: 1,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Transforms the Arcade into a state-of-the-art Gaming Lounge.',
},
{
Expand All @@ -647,6 +682,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 5,
incomeBonus: 2,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Upgrades the Cinema to an IMAX Theater with premium experience.',
},
{
Expand All @@ -657,6 +693,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 3,
incomeBonus: 1,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Turns the Cafe into a specialty Roastery with artisan appeal.',
},
{
Expand All @@ -667,6 +704,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 2,
incomeBonus: 1,
synergyRangeBonus: 0,
requiredLevel: 0,
description: 'Elevates the Food Truck with gourmet offerings.',
},
{
Expand All @@ -677,6 +715,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 4,
incomeBonus: 1,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Expands the Art Gallery into a full Museum.',
},
{
Expand All @@ -687,6 +726,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 5,
incomeBonus: 2,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Transforms the Day Spa into a luxurious Resort Spa.',
},
{
Expand All @@ -697,6 +737,7 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 3,
incomeBonus: 1,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Expands the Florist into a full Garden Center.',
},
{
Expand All @@ -707,8 +748,107 @@ const UPGRADE_TEMPLATES: UpgradeCard[] = [
cost: 5,
incomeBonus: 2,
synergyRangeBonus: 1,
requiredLevel: 0,
description: 'Upgrades the Clinic to a comprehensive Medical Center.',
},
// ── Branching Upgrades (alternative level-0 paths) ──────────
// Bakery branches: Patisserie (above, food-artisan) vs Bread Factory (volume)
{
family: 'upgrade',
id: 'upg-bread-factory',
name: 'Upgrade to Bread Factory',
targetBusiness: 'Bakery',
cost: 3,
incomeBonus: 2,
synergyRangeBonus: 0,
requiredLevel: 0,
description: 'Scales the Bakery into a high-volume Bread Factory. More income, no range boost.',
},
// Diner branches: Bistro (above, quality) vs Fast Food (volume)
{
family: 'upgrade',
id: 'upg-fast-food',
name: 'Upgrade to Fast Food',
targetBusiness: 'Diner',
cost: 3,
incomeBonus: 2,
synergyRangeBonus: 0,
requiredLevel: 0,
description: 'Converts the Diner to a Fast Food outlet. Higher income, smaller synergy radius.',
},
// Cinema branches: IMAX (above, premium) vs Drive-In (community)
{
family: 'upgrade',
id: 'upg-drive-in',
name: 'Upgrade to Drive-In Theater',
targetBusiness: 'Cinema',
cost: 4,
incomeBonus: 1,
synergyRangeBonus: 2,
requiredLevel: 0,
description: 'Turns the Cinema into a Drive-In Theater with a much wider community reach.',
},
// Day Spa branches: Resort Spa (above, premium) vs Wellness Center (service-range)
{
family: 'upgrade',
id: 'upg-wellness-center',
name: 'Upgrade to Wellness Center',
targetBusiness: 'Day Spa',
cost: 4,
incomeBonus: 1,
synergyRangeBonus: 2,
requiredLevel: 0,
description: 'Expands the Day Spa into a Wellness Center with a broader service footprint.',
},
// ── Multi-Level Upgrades (requiredLevel: 1) ──────────────────
// Level-2 upgrade for Bakery (after Patisserie or Bread Factory)
{
family: 'upgrade',
id: 'upg-grand-bakehouse',
name: 'Upgrade to Grand Bakehouse',
targetBusiness: 'Bakery',
cost: 5,
incomeBonus: 2,
synergyRangeBonus: 1,
requiredLevel: 1,
description: 'The pinnacle of baking craft — a Grand Bakehouse drawing visitors from afar.',
},
// Level-2 upgrade for Diner (after Bistro or Fast Food)
{
family: 'upgrade',
id: 'upg-restaurant',
name: 'Upgrade to Restaurant',
targetBusiness: 'Diner',
cost: 5,
incomeBonus: 2,
synergyRangeBonus: 1,
requiredLevel: 1,
description: 'Elevates the Diner all the way to a full-service Restaurant.',
},
// Level-2 upgrade for Cinema (after IMAX or Drive-In)
{
family: 'upgrade',
id: 'upg-multiplex',
name: 'Upgrade to Multiplex',
targetBusiness: 'Cinema',
cost: 6,
incomeBonus: 3,
synergyRangeBonus: 1,
requiredLevel: 1,
description: 'A massive Multiplex complex — the entertainment heart of Main Street.',
},
// Level-2 upgrade for Day Spa (after Resort Spa or Wellness Center)
{
family: 'upgrade',
id: 'upg-luxury-retreat',
name: 'Upgrade to Luxury Retreat',
targetBusiness: 'Day Spa',
cost: 6,
incomeBonus: 3,
synergyRangeBonus: 1,
requiredLevel: 1,
description: 'A destination Luxury Retreat — the most prestigious business on the street.',
},
];

// ── Deck Building ───────────────────────────────────────────
Expand Down
Loading