@taipeistudio/gamekit-career 0.1.0

package/LICENSE

@@ -0,0 +1,36 @@
+MIT License (with Attribution)
+
+Copyright (c) 2026 Rosdyana Kusuma
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+1. Copyright notice. The above copyright notice and this permission notice
+   shall be included in all copies or substantial portions of the Software,
+   including modified versions. The copyright notice must not be removed or
+   altered; you may add your own notice for your modifications alongside it.
+
+2. Attribution. Any product, game, application, website or service that
+   includes the Software or a work derived from it, in source, compiled,
+   bundled or minified form, must give visible credit to the author where end
+   users can reasonably find it (for example a credits screen, an "About"
+   page, or the product's documentation or store listing). The credit must be
+   substantially similar to:
+
+       gamekit by Rosdyana Kusuma - https://github.com/rosdyana/gamekit
+
+3. No endorsement. The name of the copyright holder may not be used to endorse
+   or promote products derived from the Software without prior written
+   permission.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# @taipeistudio/gamekit-career
+
+[![npm](https://img.shields.io/npm/v/@taipeistudio/gamekit-career.svg)](https://www.npmjs.com/package/@taipeistudio/gamekit-career) [![license](https://img.shields.io/badge/license-MIT%20with%20attribution-blue.svg)](LICENSE)
+
+The money and public-life side of an athlete career game, as plain data and pure functions.
+Anything random takes a `rand: () => number` (pass a seeded one, e.g. from
+`@taipeistudio/gamekit-rng`); it uses the same noise as gamekit-rng, draw for draw.
+Actions return an error message (string) when refused and never draw random numbers then.
+
+## Installation
+
+```bash
+npm install @taipeistudio/gamekit-career
+```
+
+## API
+
+- **Money**: `roundMoney` (price-like rounding), `shortMoney` ($12.5K, $3.2M), `spend(wallet,
+  amount)`, `convert(amount, from, to, perDollar)`, `progressiveTax(income, brackets)`,
+  `splitTax(income, places)` (per-state "jock tax").
+- **Portfolio**: `blankPortfolio`, `deposit`/`withdraw` (savings, index, crypto),
+  `buyProperty`/`sellProperty`, `openBusiness(wallet, p, kind, cost, make)`/`sellBusiness`,
+  `netWorth(cash, p, extra)`, `recordWorth`, and `marketWeek(p, rand, { businesses, fame,
+  scale, priceOf, rates })`, which returns the week's income and events (crypto crash or moon,
+  business slump, bust or boom). `DEFAULT_RATES` holds the yearly rates.
+- **Sponsors**: `sponsorKind(rand, fame, image)` (local → clean or edgy by image),
+  `sponsorPay`, `imageWindow`, `acceptSponsor` (per-kind cap), `declineSponsor`,
+  `sponsorExitFee`/`cancelSponsor` (buy-outs), `sponsorUpkeep` (expiry and image clauses),
+  `sponsorIncome`, `sponsorBonus`.
+- **Social**: `followersFor(fame)`, `socialWeek(p)` (followers drift to target, fame fades,
+  notoriety bonus), `viral(p, rand, size)`, `followerLabel`.
+- **Lifestyle and tiers**: `lifestyleBlocked` (weeks of cost in the bank), `buyTier` (houses,
+  cars), `tierOf`/`tierProgress` (bronze/silver/gold style thresholds).
+
+```ts
+import { asFn } from "@taipeistudio/gamekit-rng";
+import { blankPortfolio, deposit, marketWeek, socialWeek } from "@taipeistudio/gamekit-career";
+
+const s = { rngState: 42, money: 50_000, fame: 30, image: 10, followers: 2_000, invest: blankPortfolio() };
+deposit(s, s.invest, "index", 20_000);
+const { income, events } = marketWeek(s.invest, asFn(s), { businesses: {}, fame: s.fame });
+s.money += income;
+socialWeek(s);
+```
+
+## License
+
+MIT with attribution. Part of [gamekit](https://github.com/rosdyana/gamekit).
+Copyright © 2026 Rosdyana Kusuma. See [LICENSE](LICENSE); products using this package must
+credit the author (e.g. "gamekit by Rosdyana Kusuma - https://github.com/rosdyana/gamekit").

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./money.js";
+export * from "./portfolio.js";
+export * from "./sponsors.js";
+export * from "./social.js";
+export * from "./lifestyle.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./money.js";
+export * from "./portfolio.js";
+export * from "./sponsors.js";
+export * from "./social.js";
+export * from "./lifestyle.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/lifestyle.d.ts

@@ -0,0 +1,24 @@
+import type { Wallet } from "./money.js";
+export interface Lifestyle {
+    label: string;
+    weekly: number;
+    /** Weekly morale and fame effects, if the game uses them. */
+    morale?: number;
+    fame?: number;
+}
+export interface Tier {
+    label: string;
+    price: number;
+}
+/** Moving up a lifestyle tier needs `weeks` of its cost in the bank. */
+export declare function lifestyleBlocked(money: number, tiers: readonly Lifestyle[], current: number, next: number, weeks?: number): string | null;
+/**
+ * Buy rung `tier` of an owned ladder (index 0 is usually "nothing yet"). Only upgrades.
+ * Returns an error message, or null after paying.
+ */
+export declare function buyTier(w: Wallet, owned: number, tiers: readonly Tier[], tier: number): string | null;
+/** Which rung of `thresholds` (ascending) a value has reached: 0 = none, 1 = first... */
+export declare function tierOf(value: number, thresholds: readonly number[]): number;
+/** Progress 0..1 from the current rung towards the next (1 once the top is reached). */
+export declare function tierProgress(value: number, thresholds: readonly number[]): number;
+//# sourceMappingURL=lifestyle.d.ts.map

package/dist/lifestyle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifestyle.d.ts","sourceRoot":"","sources":["../src/lifestyle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,GAAG,IAAI,CAIpI;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMrG;AAED,yFAAyF;AACzF,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAI3E;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAKjF"}

package/dist/lifestyle.js

@@ -0,0 +1,38 @@
+/** Moving up a lifestyle tier needs `weeks` of its cost in the bank. */
+export function lifestyleBlocked(money, tiers, current, next, weeks = 8) {
+    if (next < 0 || next >= tiers.length)
+        return "Unknown lifestyle";
+    if (next > current && money < tiers[next].weekly * weeks)
+        return `You can't afford ${weeks} weeks of that.`;
+    return null;
+}
+/**
+ * Buy rung `tier` of an owned ladder (index 0 is usually "nothing yet"). Only upgrades.
+ * Returns an error message, or null after paying.
+ */
+export function buyTier(w, owned, tiers, tier) {
+    const t = tiers[tier];
+    if (!t || tier <= owned)
+        return "Already have something better";
+    if (w.money < t.price)
+        return "Not enough money";
+    w.money -= t.price;
+    return null;
+}
+/** Which rung of `thresholds` (ascending) a value has reached: 0 = none, 1 = first... */
+export function tierOf(value, thresholds) {
+    let t = 0;
+    for (const x of thresholds)
+        if (value >= x)
+            t++;
+    return t;
+}
+/** Progress 0..1 from the current rung towards the next (1 once the top is reached). */
+export function tierProgress(value, thresholds) {
+    const t = tierOf(value, thresholds);
+    if (t >= thresholds.length)
+        return 1;
+    const lo = t ? thresholds[t - 1] : 0;
+    return Math.max(0, Math.min(1, (value - lo) / (thresholds[t] - lo)));
+}
+//# sourceMappingURL=lifestyle.js.map

package/dist/lifestyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifestyle.js","sourceRoot":"","sources":["../src/lifestyle.ts"],"names":[],"mappings":"AAgBA,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,KAA2B,EAAE,OAAe,EAAE,IAAY,EAAE,KAAK,GAAG,CAAC;IACnH,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,mBAAmB,CAAC;IACjE,IAAI,IAAI,GAAG,OAAO,IAAI,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,KAAK;QAAE,OAAO,oBAAoB,KAAK,iBAAiB,CAAC;IAC5G,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS,EAAE,KAAa,EAAE,KAAsB,EAAE,IAAY;IACpF,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,KAAK;QAAE,OAAO,+BAA+B,CAAC;IAChE,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK;QAAE,OAAO,kBAAkB,CAAC;IACjD,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,UAA6B;IACjE,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,IAAI,KAAK,IAAI,CAAC;YAAE,CAAC,EAAE,CAAC;IAChD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,UAA6B;IACvE,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/money.d.ts

@@ -0,0 +1,25 @@
+/** Any () => number in [0, 1); pass a seeded one for reproducible careers. */
+export type Rand = () => number;
+/** Cash on hand. Career states usually embed this field. */
+export interface Wallet {
+    money: number;
+}
+/** Round to a "price-like" value: tens under 1k, hundreds under 100k, thousands above. */
+export declare function roundMoney(v: number): number;
+/** Compact label: $950, $12.5K, $3.2M, $1.05B. */
+export declare function shortMoney(v: number, symbol?: string): string;
+/** Spend if affordable. Returns an error message, or null on success. */
+export declare function spend(w: Wallet, amount: number, why?: string): string | null;
+/** Convert between currencies given units-per-dollar rates (e.g. { USD: 1, IDR: 16000 }). */
+export declare function convert(amount: number, from: string, to: string, perDollar: Readonly<Record<string, number>>): number;
+/** Tiered progressive tax: brackets are [threshold, rate] sorted by threshold. */
+export declare function progressiveTax(income: number, brackets: readonly (readonly [number, number])[]): number;
+/**
+ * Split a salary across the places it was earned (athletes' "jock tax"): each entry is
+ * a share of working days and that place's flat rate. Shares are normalised.
+ */
+export declare function splitTax(income: number, places: readonly {
+    share: number;
+    rate: number;
+}[]): number;
+//# sourceMappingURL=money.d.ts.map

package/dist/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC;AAEhC,4DAA4D;AAC5D,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAQ1D;AAED,yEAAyE;AACzE,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,SAAqB,GAAG,MAAM,GAAG,IAAI,CAIxF;AAED,6FAA6F;AAC7F,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAKrH;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAAG,MAAM,CASvG;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAInG"}

package/dist/money.js

@@ -0,0 +1,59 @@
+/** Round to a "price-like" value: tens under 1k, hundreds under 100k, thousands above. */
+export function roundMoney(v) {
+    if (v < 1000)
+        return Math.round(v / 10) * 10;
+    if (v < 100_000)
+        return Math.round(v / 100) * 100;
+    return Math.round(v / 1000) * 1000;
+}
+/** Compact label: $950, $12.5K, $3.2M, $1.05B. */
+export function shortMoney(v, symbol = "$") {
+    const sign = v < 0 ? "-" : "";
+    const a = Math.abs(v);
+    const fmt = (x, unit) => `${sign}${symbol}${Number(x.toPrecision(3))}${unit}`;
+    if (a >= 1e9)
+        return fmt(a / 1e9, "B");
+    if (a >= 1e6)
+        return fmt(a / 1e6, "M");
+    if (a >= 1e4)
+        return fmt(a / 1e3, "K");
+    return `${sign}${symbol}${Math.round(a).toLocaleString("en-US")}`;
+}
+/** Spend if affordable. Returns an error message, or null on success. */
+export function spend(w, amount, why = "Not enough money") {
+    if (w.money < amount)
+        return why;
+    w.money -= amount;
+    return null;
+}
+/** Convert between currencies given units-per-dollar rates (e.g. { USD: 1, IDR: 16000 }). */
+export function convert(amount, from, to, perDollar) {
+    const a = perDollar[from];
+    const b = perDollar[to];
+    if (!a || !b)
+        throw new Error(`Unknown currency ${!a ? from : to}`);
+    return (amount / a) * b;
+}
+/** Tiered progressive tax: brackets are [threshold, rate] sorted by threshold. */
+export function progressiveTax(income, brackets) {
+    let tax = 0;
+    for (let i = 0; i < brackets.length; i++) {
+        const [lo, rate] = brackets[i];
+        const hi = i + 1 < brackets.length ? brackets[i + 1][0] : Infinity;
+        if (income <= lo)
+            break;
+        tax += (Math.min(income, hi) - lo) * rate;
+    }
+    return tax;
+}
+/**
+ * Split a salary across the places it was earned (athletes' "jock tax"): each entry is
+ * a share of working days and that place's flat rate. Shares are normalised.
+ */
+export function splitTax(income, places) {
+    const total = places.reduce((a, p) => a + Math.max(0, p.share), 0);
+    if (!total)
+        return 0;
+    return places.reduce((a, p) => a + (income * Math.max(0, p.share) * p.rate) / total, 0);
+}
+//# sourceMappingURL=money.js.map

package/dist/money.js.map

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

package/dist/portfolio.d.ts

@@ -0,0 +1,105 @@
+import { type Rand, type Wallet } from "./money.js";
+export interface BusinessDef {
+    label: string;
+    /** Default cost to start one. */
+    cost: number;
+    /** Yearly yield on the business value. */
+    yield: number;
+    /** Yearly chance of trouble (half a slump, half going bust); booms at half this rate. */
+    risk: number;
+    text?: string;
+    /** Income scales with the owner's fame (fashion labels, restaurants). */
+    fameLinked?: boolean;
+}
+export interface Business<K extends string = string> {
+    id: string;
+    kind: K;
+    name: string;
+    /** What the business is worth now. */
+    value: number;
+    /** Total money put in. */
+    invested: number;
+    open: boolean;
+}
+export interface Portfolio<K extends string = string> {
+    savings: number;
+    index: number;
+    crypto: number;
+    /** Rental property units and the current price of one. */
+    property: number;
+    propertyPrice: number;
+    businesses: Business<K>[];
+    /** Net worth snapshots, newest first. */
+    history: {
+        week: number;
+        worth: number;
+    }[];
+    /** Investment income since the game last reset it (e.g. per season). */
+    income: number;
+}
+export declare const blankPortfolio: <K extends string = string>(propertyPrice?: number) => Portfolio<K>;
+export declare const LIQUID_ASSETS: readonly ["savings", "index", "crypto"];
+export type Liquid = (typeof LIQUID_ASSETS)[number];
+export declare const ASSET_LABEL: Record<Liquid, string>;
+/** Yearly rates. Volatilities are yearly standard deviations. */
+export interface MarketRates {
+    savings: number;
+    indexDrift: number;
+    indexVol: number;
+    cryptoDrift: number;
+    cryptoVol: number;
+    /** Weekly chances of a crypto crash (x0.45) or moon (x1.9). */
+    crash: number;
+    moon: number;
+    propertyGrowth: number;
+    /** Weekly standard deviation of the property price. */
+    propertyVol: number;
+    propertyFloor: number;
+    rentYield: number;
+}
+export declare const DEFAULT_RATES: MarketRates;
+export declare function deposit(w: Wallet, p: Portfolio, asset: Liquid, amount: number): string | null;
+export declare function withdraw(w: Wallet, p: Portfolio, asset: Liquid, amount: number): string | null;
+/** `price` is the price of one unit as the game shows it (it may scale propertyPrice). */
+export declare function buyProperty(w: Wallet, p: Portfolio, price: number, units?: number): string | null;
+/** Sells at `keep` of the price (agent fees and taxes). */
+export declare function sellProperty(w: Wallet, p: Portfolio, price: number, units?: number, keep?: number): string | null;
+/**
+ * Start a business for `cost`. `make` is only called once the checks pass (so a refused
+ * purchase draws no random numbers) and names the new business.
+ */
+export declare function openBusiness<K extends string>(w: Wallet, p: Portfolio<K>, kind: K, cost: number, make: () => {
+    id: string;
+    name: string;
+}, max?: number): Business<K> | string;
+/** Sell at `keep` of its value. Returns the business sold, or an error message. */
+export declare function sellBusiness<K extends string>(w: Wallet, p: Portfolio<K>, id: string, keep?: number): Business<K> | string;
+/** Cash plus everything the portfolio holds; `extra` adds game-specific assets. */
+export declare function netWorth(cash: number, p: Portfolio, extra?: number): number;
+/** Keep a net worth snapshot every `every` weeks (newest first, at most `keep`). */
+export declare function recordWorth(p: Portfolio, week: number, worth: number, every?: number, keep?: number): void;
+export type MarketEvent<K extends string = string> = {
+    type: "cryptoCrash" | "cryptoMoon";
+} | {
+    type: "slump" | "bust" | "boom";
+    business: Business<K>;
+};
+export interface MarketWeekOptions<K extends string> {
+    businesses: Readonly<Record<K, BusinessDef>>;
+    /** Owner fame 0..100 for fame-linked businesses (default 50). */
+    fame?: number;
+    /** Scales rent (e.g. a poorer economy). */
+    scale?: number;
+    /** Rounds the rented unit's price before rent is paid (defaults to none). */
+    priceOf?: (propertyPrice: number) => number;
+    rates?: Partial<MarketRates>;
+}
+/**
+ * One week of returns, rent, business income and the occasional disaster. Mutates the
+ * portfolio and returns the income earned (not yet paid into any wallet) plus what happened.
+ */
+export declare function marketWeek<K extends string>(p: Portfolio<K>, r: Rand, o: MarketWeekOptions<K>): {
+    income: number;
+    events: MarketEvent<K>[];
+};
+//# sourceMappingURL=portfolio.d.ts.map

package/dist/portfolio.d.ts.map

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

package/dist/portfolio.js

@@ -0,0 +1,167 @@
+export const blankPortfolio = (propertyPrice = 250_000) => ({
+    savings: 0,
+    index: 0,
+    crypto: 0,
+    property: 0,
+    propertyPrice,
+    businesses: [],
+    history: [],
+    income: 0,
+});
+export const LIQUID_ASSETS = ["savings", "index", "crypto"];
+export const ASSET_LABEL = {
+    savings: "Savings account",
+    index: "Index fund",
+    crypto: "Crypto",
+};
+export const DEFAULT_RATES = {
+    savings: 0.025,
+    indexDrift: 0.07,
+    indexVol: 0.16,
+    cryptoDrift: 0.15,
+    cryptoVol: 0.85,
+    crash: 0.006,
+    moon: 0.004,
+    propertyGrowth: 0.03,
+    propertyVol: 0.01,
+    propertyFloor: 80_000,
+    rentYield: 0.05,
+};
+// Same noise as gamekit-rng's gauss (sum of three uniforms), so results match it draw for draw.
+const gauss = (r, sd) => (r() + r() + r() - 1.5) * 2 * sd;
+const chance = (r, p) => r() < p;
+// ---------------------------------------------------------------- actions
+export function deposit(w, p, asset, amount) {
+    amount = Math.floor(amount);
+    if (amount <= 0)
+        return "Nothing to invest.";
+    if (w.money < amount)
+        return "Not enough cash.";
+    w.money -= amount;
+    p[asset] += amount;
+    return null;
+}
+export function withdraw(w, p, asset, amount) {
+    const have = p[asset];
+    if (have < 1)
+        return "Nothing to withdraw.";
+    // "All" takes every last cent, not just whole dollars.
+    const take = amount >= have - 1 ? have : Math.floor(amount);
+    if (take <= 0)
+        return "Nothing to withdraw.";
+    p[asset] -= take;
+    w.money += take;
+    return null;
+}
+/** `price` is the price of one unit as the game shows it (it may scale propertyPrice). */
+export function buyProperty(w, p, price, units = 1) {
+    const cost = price * units;
+    if (w.money < cost)
+        return "Not enough cash.";
+    w.money -= cost;
+    p.property += units;
+    return null;
+}
+/** Sells at `keep` of the price (agent fees and taxes). */
+export function sellProperty(w, p, price, units = 1, keep = 0.95) {
+    if (p.property < units)
+        return "No property to sell.";
+    p.property -= units;
+    w.money += Math.round(price * units * keep);
+    return null;
+}
+/**
+ * Start a business for `cost`. `make` is only called once the checks pass (so a refused
+ * purchase draws no random numbers) and names the new business.
+ */
+export function openBusiness(w, p, kind, cost, make, max = 6) {
+    if (w.money < cost)
+        return "Not enough cash.";
+    if (p.businesses.filter((b) => b.open).length >= max)
+        return `Your advisers say ${max} businesses is plenty.`;
+    w.money -= cost;
+    const { id, name } = make();
+    const b = { id, kind, name, value: cost, invested: cost, open: true };
+    p.businesses.push(b);
+    return b;
+}
+/** Sell at `keep` of its value. Returns the business sold, or an error message. */
+export function sellBusiness(w, p, id, keep = 0.9) {
+    const b = p.businesses.find((x) => x.id === id && x.open);
+    if (!b)
+        return "No such business.";
+    b.open = false;
+    w.money += Math.round(b.value * keep);
+    return b;
+}
+/** Cash plus everything the portfolio holds; `extra` adds game-specific assets. */
+export function netWorth(cash, p, extra = 0) {
+    return (cash +
+        p.savings +
+        p.index +
+        p.crypto +
+        p.property * p.propertyPrice +
+        p.businesses.filter((b) => b.open).reduce((a, b) => a + b.value, 0) +
+        extra);
+}
+/** Keep a net worth snapshot every `every` weeks (newest first, at most `keep`). */
+export function recordWorth(p, week, worth, every = 4, keep = 150) {
+    if (week % every !== 0)
+        return;
+    p.history.unshift({ week, worth: Math.round(worth) });
+    if (p.history.length > keep)
+        p.history.length = keep;
+}
+/**
+ * One week of returns, rent, business income and the occasional disaster. Mutates the
+ * portfolio and returns the income earned (not yet paid into any wallet) plus what happened.
+ */
+export function marketWeek(p, r, o) {
+    const k = { ...DEFAULT_RATES, ...o.rates };
+    const events = [];
+    const fame = o.fame ?? 50;
+    const wk = Math.sqrt(52);
+    let income = 0;
+    p.savings *= 1 + k.savings / 52;
+    p.index = Math.max(0, p.index * Math.exp(k.indexDrift / 52 + gauss(r, k.indexVol / wk)));
+    if (p.crypto > 0) {
+        p.crypto = Math.max(0, p.crypto * Math.exp(k.cryptoDrift / 52 + gauss(r, k.cryptoVol / wk)));
+        if (chance(r, k.crash)) {
+            p.crypto *= 0.45;
+            events.push({ type: "cryptoCrash" });
+        }
+        else if (chance(r, k.moon)) {
+            p.crypto *= 1.9;
+            events.push({ type: "cryptoMoon" });
+        }
+    }
+    p.propertyPrice = Math.max(k.propertyFloor, p.propertyPrice * (1 + k.propertyGrowth / 52 + gauss(r, k.propertyVol)));
+    if (p.property) {
+        const unit = o.priceOf ? o.priceOf(p.propertyPrice) : p.propertyPrice * (o.scale ?? 1);
+        income += p.property * unit * (k.rentYield / 52);
+    }
+    for (const b of p.businesses) {
+        if (!b.open)
+            continue;
+        const def = o.businesses[b.kind];
+        const fameK = def.fameLinked ? 0.6 + fame / 125 : 1;
+        income += Math.max(0, b.value * (def.yield / 52) * fameK * (0.6 + r() * 0.8));
+        b.value = Math.max(0, b.value * (1 + gauss(r, 0.02)));
+        if (chance(r, def.risk / 52)) {
+            if (chance(r, 0.5)) {
+                b.value *= 0.55;
+                events.push({ type: "slump", business: b });
+            }
+            else {
+                b.open = false;
+                events.push({ type: "bust", business: b });
+            }
+        }
+        else if (chance(r, def.risk / 104)) {
+            b.value *= 1.5;
+            events.push({ type: "boom", business: b });
+        }
+    }
+    return { income, events };
+}
+//# sourceMappingURL=portfolio.js.map

package/dist/portfolio.js.map

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

package/dist/social.d.ts

@@ -0,0 +1,28 @@
+import type { Rand } from "./money.js";
+export interface Public {
+    /** 0..100 */
+    fame: number;
+    /** -100 (villain) .. 100 (role model) */
+    image: number;
+    followers: number;
+}
+/** Followers a player of this fame settles towards. */
+export declare const followersFor: (fame: number) => number;
+export interface SocialOptions {
+    /** Share of the gap to the target closed per week. */
+    pull?: number;
+    /** Controversy sells: followers multiplier when image is below -30. */
+    notoriety?: number;
+    /** Weekly fame fade: a flat amount plus a share of fame. */
+    fade?: [number, number];
+}
+/** One week: followers drift towards their target, fame fades unless it is fed. */
+export declare function socialWeek(p: Public, o?: SocialOptions): void;
+/**
+ * A moment going viral (poster dunk, buzzer-beater, a mixtape). `size` 0..1 is how
+ * spectacular it was; small accounts grow fastest in relative terms. Returns the gain.
+ */
+export declare function viral(p: Public, r: Rand, size: number): number;
+/** Label for follower counts: 950, 12.4K, 3.1M. */
+export declare function followerLabel(n: number): string;
+//# sourceMappingURL=social.d.ts.map

package/dist/social.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.d.ts","sourceRoot":"","sources":["../src/social.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,MAAM;IACrB,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uDAAuD;AACvD,eAAO,MAAM,YAAY,SAAU,MAAM,WAA4D,CAAC;AAEtG,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzB;AAED,mFAAmF;AACnF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAE,aAAkB,QAK1D;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/C"}

package/dist/social.js

@@ -0,0 +1,29 @@
+/** Followers a player of this fame settles towards. */
+export const followersFor = (fame) => Math.round(Math.pow(fame, 2.6) * 60 + fame * 500 + 120);
+/** One week: followers drift towards their target, fame fades unless it is fed. */
+export function socialWeek(p, o = {}) {
+    const target = followersFor(p.fame) * (p.image < -30 ? (o.notoriety ?? 1.25) : 1);
+    p.followers = Math.round(p.followers + (target - p.followers) * (o.pull ?? 0.08));
+    const [flat, share] = o.fade ?? [0.03, 0.004];
+    p.fame = Math.max(0, Math.min(100, p.fame - flat - p.fame * share));
+}
+/**
+ * A moment going viral (poster dunk, buzzer-beater, a mixtape). `size` 0..1 is how
+ * spectacular it was; small accounts grow fastest in relative terms. Returns the gain.
+ */
+export function viral(p, r, size) {
+    const base = 400 + Math.sqrt(p.followers) * 120;
+    const gain = Math.round(base * size * (0.5 + r()) * (1 + size * 3));
+    p.followers += gain;
+    p.fame = Math.min(100, p.fame + size * 2);
+    return gain;
+}
+/** Label for follower counts: 950, 12.4K, 3.1M. */
+export function followerLabel(n) {
+    if (n >= 1e6)
+        return `${Number((n / 1e6).toPrecision(3))}M`;
+    if (n >= 1e4)
+        return `${Number((n / 1e3).toPrecision(3))}K`;
+    return Math.round(n).toLocaleString("en-US");
+}
+//# sourceMappingURL=social.js.map

package/dist/social.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.js","sourceRoot":"","sources":["../src/social.ts"],"names":[],"mappings":"AAWA,uDAAuD;AACvD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;AAWtG,mFAAmF;AACnF,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,IAAmB,EAAE;IACzD,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC;IAClF,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,CAAS,EAAE,CAAO,EAAE,IAAY;IACpD,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC;IACpB,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,IAAI,CAAC,IAAI,GAAG;QAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5D,IAAI,CAAC,IAAI,GAAG;QAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/sponsors.d.ts

@@ -0,0 +1,51 @@
+import { type Rand, type Wallet } from "./money.js";
+/** local: hometown businesses; clean: mainstream brands; edgy: brands that like a bad boy. */
+export type SponsorKind = "local" | "clean" | "edgy";
+export interface Sponsor<K extends string = SponsorKind> {
+    id: string;
+    brand: string;
+    kind: K;
+    /** Market (e.g. nation code) the brand comes from. */
+    country?: string;
+    weekly: number;
+    /** Paid per match feat (goal, clean sheet, double-double...). */
+    bonus: number;
+    /** Absolute week the deal ends. */
+    until: number;
+    /** The sponsor walks if image drops below minImage (clean) or rises above maxImage (edgy). */
+    minImage: number;
+    maxImage: number;
+    /** Offers only: the week the offer lapses. */
+    expires?: number;
+}
+export interface SponsorBook<K extends string = SponsorKind> {
+    sponsors: Sponsor<K>[];
+    sponsorOffers: Sponsor<K>[];
+}
+/**
+ * The kind of brand that approaches: local until `localBelow` fame, then clean or edgy by
+ * image (image -100..100). Draws one number only once past the local stage.
+ */
+export declare function sponsorKind(r: Rand, fame: number, image: number, localBelow?: number): SponsorKind;
+/** Weekly fee by fame (0..100); `scale` shrinks it for smaller markets. Rounded to tens. */
+export declare function sponsorPay(kind: SponsorKind, fame: number, scale?: number): number;
+/** Image window for a kind: clean brands leave below -10, edgy ones above 60. */
+export declare const imageWindow: (kind: SponsorKind) => [number, number];
+export declare const sponsorIncome: (list: readonly Sponsor<string>[]) => number;
+/** Bonus money for `units` feats in one match. */
+export declare const sponsorBonus: (list: readonly Sponsor<string>[], units: number) => number;
+/**
+ * Accept an offer. At most `maxPerKind` deals of a kind at once, except the `unlimited` kinds.
+ * Returns the signed deal, or an error message.
+ */
+export declare function acceptSponsor<K extends string>(book: SponsorBook<K>, id: string, maxPerKind?: number, unlimited?: readonly string[]): Sponsor<K> | string;
+export declare function declineSponsor<K extends string>(book: SponsorBook<K>, id: string): void;
+/** Buying out a deal: up to `weeks` of the remaining fees plus a `penalty` of weeks on top. */
+export declare function sponsorExitFee(sp: Sponsor<string>, week: number, weeks?: number, penalty?: number): number;
+export declare function cancelSponsor<K extends string>(w: Wallet, book: SponsorBook<K>, id: string, week: number): Sponsor<K> | string;
+/** Weekly upkeep: drop lapsed offers, end finished deals, enforce image clauses (in list order). */
+export declare function sponsorUpkeep<K extends string>(book: SponsorBook<K>, week: number, image: number): {
+    sponsor: Sponsor<K>;
+    why: "ended" | "image";
+}[];
+//# sourceMappingURL=sponsors.d.ts.map

package/dist/sponsors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sponsors.d.ts","sourceRoot":"","sources":["../src/sponsors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAEhE,8FAA8F;AAC9F,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW;IACzD,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,SAAK,GAAG,WAAW,CAI9F;AAED,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,CAG7E;AAED,iFAAiF;AACjF,eAAO,MAAM,WAAW,SAAU,WAAW,KAAG,CAAC,MAAM,EAAE,MAAM,CAAgE,CAAC;AAEhI,eAAO,MAAM,aAAa,SAAU,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,WAA6C,CAAC;AAE5G,kDAAkD;AAClD,eAAO,MAAM,YAAY,SAAU,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,WACX,CAAC;AAElE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,EAAE,EAAE,MAAM,EACV,UAAU,SAAI,EACd,SAAS,GAAE,SAAS,MAAM,EAAc,GACvC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CASrB;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,QAEhF;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,OAAO,SAAI,GAAG,MAAM,CAGjG;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAQ9H;AAED,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ;IAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAA;CAAE,EAAE,CAanD"}

package/dist/sponsors.js

@@ -0,0 +1,74 @@
+// Endorsements: who approaches you (by fame and image), what they pay, image clauses,
+// buy-outs and expiry. Brand names and markets stay in the game.
+import { roundMoney } from "./money.js";
+/**
+ * The kind of brand that approaches: local until `localBelow` fame, then clean or edgy by
+ * image (image -100..100). Draws one number only once past the local stage.
+ */
+export function sponsorKind(r, fame, image, localBelow = 15) {
+    if (fame < localBelow)
+        return "local";
+    const edgy = image < -20 ? 0.7 : image < 10 ? 0.25 : 0.05;
+    return r() < edgy ? "edgy" : "clean";
+}
+/** Weekly fee by fame (0..100); `scale` shrinks it for smaller markets. Rounded to tens. */
+export function sponsorPay(kind, fame, scale = 1) {
+    const big = 30 + Math.pow(fame, 2.1) * 3 * scale;
+    return Math.round((kind === "local" ? 20 + fame * 4 : big * (kind === "edgy" ? 1.3 : 1)) / 10) * 10;
+}
+/** Image window for a kind: clean brands leave below -10, edgy ones above 60. */
+export const imageWindow = (kind) => [kind === "clean" ? -10 : -100, kind === "edgy" ? 60 : 100];
+export const sponsorIncome = (list) => list.reduce((a, sp) => a + sp.weekly, 0);
+/** Bonus money for `units` feats in one match. */
+export const sponsorBonus = (list, units) => units > 0 ? list.reduce((a, sp) => a + sp.bonus * units, 0) : 0;
+/**
+ * Accept an offer. At most `maxPerKind` deals of a kind at once, except the `unlimited` kinds.
+ * Returns the signed deal, or an error message.
+ */
+export function acceptSponsor(book, id, maxPerKind = 3, unlimited = ["local"]) {
+    const o = book.sponsorOffers.find((x) => x.id === id);
+    if (!o)
+        return "Offer expired";
+    if (!unlimited.includes(o.kind) && book.sponsors.filter((x) => x.kind === o.kind).length >= maxPerKind)
+        return `Your agent says ${maxPerKind} big brands at once is the limit.`;
+    book.sponsorOffers = book.sponsorOffers.filter((x) => x.id !== id);
+    delete o.expires;
+    book.sponsors.push(o);
+    return o;
+}
+export function declineSponsor(book, id) {
+    book.sponsorOffers = book.sponsorOffers.filter((x) => x.id !== id);
+}
+/** Buying out a deal: up to `weeks` of the remaining fees plus a `penalty` of weeks on top. */
+export function sponsorExitFee(sp, week, weeks = 26, penalty = 2) {
+    const left = Math.max(0, sp.until - week);
+    return roundMoney(sp.weekly * Math.min(weeks, left) + sp.weekly * penalty);
+}
+export function cancelSponsor(w, book, id, week) {
+    const sp = book.sponsors.find((x) => x.id === id);
+    if (!sp)
+        return "No such deal.";
+    const fee = sponsorExitFee(sp, week);
+    if (w.money < fee)
+        return `You need $${fee.toLocaleString("en-US")} to buy out the contract.`;
+    w.money -= fee;
+    book.sponsors = book.sponsors.filter((x) => x !== sp);
+    return sp;
+}
+/** Weekly upkeep: drop lapsed offers, end finished deals, enforce image clauses (in list order). */
+export function sponsorUpkeep(book, week, image) {
+    const out = [];
+    book.sponsorOffers = book.sponsorOffers.filter((o) => (o.expires ?? 0) > week);
+    for (const sp of [...book.sponsors]) {
+        if (sp.until <= week) {
+            book.sponsors = book.sponsors.filter((x) => x !== sp);
+            out.push({ sponsor: sp, why: "ended" });
+        }
+        else if (image < sp.minImage || image > sp.maxImage) {
+            book.sponsors = book.sponsors.filter((x) => x !== sp);
+            out.push({ sponsor: sp, why: "image" });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=sponsors.js.map

package/dist/sponsors.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@taipeistudio/gamekit-career",
+  "version": "0.1.0",
+  "description": "Athlete-career economy: money, investments, businesses, sponsors, fame and followers, lifestyle ladders, taxes.",
+  "keywords": [
+    "gamekit",
+    "gamedev",
+    "typescript",
+    "career",
+    "sports",
+    "life-sim",
+    "economy",
+    "sponsors",
+    "investments"
+  ],
+  "author": {
+    "name": "Rosdyana Kusuma",
+    "email": "rosdyana.kusuma@gmail.com",
+    "url": "https://github.com/rosdyana"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://github.com/rosdyana/gamekit/tree/main/packages/career#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rosdyana/gamekit.git",
+    "directory": "packages/career"
+  },
+  "bugs": {
+    "url": "https://github.com/rosdyana/gamekit/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}