Compose market, early cache and phase bid promises
Verify and publish checkpoint container / container (push) Successful in 12m4s
Verify and publish checkpoint container / container (push) Successful in 12m4s
This commit is contained in:
1 parent
225b2174ad
commit
6a30fdf376
16 files changed
+1183
-21
No files matched your search
@@ -0,0 +1,104 @@
|
||||
import { quoteJointEarlyRicheseBids } from './joint-early-richese-bids';
|
||||
import { jointRicheseBidCompletionRange } from './joint-richese-bids';
|
||||
import {
|
||||
richeseBidRequired,
|
||||
RicheseBidPromiseError,
|
||||
type RicheseBidContext,
|
||||
type RicheseBidOpportunity,
|
||||
type RicheseBidPromise,
|
||||
} from './richese-bid-promises';
|
||||
import { livePhaseBidPromises, phaseBidCompletionRange, type PhaseBidPromise, type PhaseBidRange } from './turn-bid-promises';
|
||||
import type { EarlyRicheseBidPromise } from './early-richese-bid';
|
||||
|
||||
/** Every number is supplied from the engine's current native quote, not a
|
||||
* prediction of rival bids, refunds or income. The cache is after the market. */
|
||||
export type JointMarketEarlyBidInput = {
|
||||
context: RicheseBidContext;
|
||||
native: readonly RicheseBidPromise[];
|
||||
early: readonly EarlyRicheseBidPromise[];
|
||||
phase: readonly PhaseBidPromise[];
|
||||
opportunity: RicheseBidOpportunity | null;
|
||||
/** Own cash and unlocked pledged aid available for the market bid. */
|
||||
cashAvailable: number;
|
||||
aidAvailable: number;
|
||||
/** Own cash available for the later cache if the market is declined. */
|
||||
cacheMaximum: number;
|
||||
/** Free slots after any pre-existing purchase, before this market bid. */
|
||||
freeSlots: number;
|
||||
/** Current sale needs one slot for a buyer and none for paid self-retention. */
|
||||
marketEntrySlots: number;
|
||||
/** Slots reserved after a possible market win, including a Harkonnen bonus. */
|
||||
marketWinSlots: number;
|
||||
};
|
||||
|
||||
/** Inclusive market interval and the ally contribution needed for its
|
||||
* minimum while preserving the stated cache reservation. */
|
||||
export type JointMarketBidRange = PhaseBidRange & { allyPayment: number };
|
||||
export type JointMarketEarlyBidQuote = {
|
||||
nativeRequired: boolean;
|
||||
earlyRequired: boolean;
|
||||
phaseRequired: boolean;
|
||||
/** A pass/zero satisfies the native answer and retains the early cache. */
|
||||
canPass: boolean;
|
||||
/** Legal current bid preserving the independent early-cache Yes. */
|
||||
market: JointMarketBidRange | null;
|
||||
/** Current bid also fulfilling every live phase Yes. */
|
||||
marketForPhase: JointMarketBidRange | null;
|
||||
/** Current bid leaving the cache able to fulfill every phase Yes. */
|
||||
marketForCache: JointMarketBidRange | null;
|
||||
/** A cache bid if this market is declined; phase Yes may remain open. */
|
||||
cacheAfterPass: PhaseBidRange | null;
|
||||
/** A cache bid fulfilling every phase Yes if this market is declined. */
|
||||
phaseCacheAfterPass: PhaseBidRange | null;
|
||||
};
|
||||
|
||||
const whole = (value: unknown): value is number =>
|
||||
typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
|
||||
|
||||
/** Intersect three ledgers around the actual one-declaration market lot. The
|
||||
* caller supplies event eligibility and later ordinary-lot witnesses. When a
|
||||
* later cache bid must be funded, reserve personal cash and the potential
|
||||
* first market purchase before exposing a market bid. No cache refund,
|
||||
* non-owner sale, hidden offer, or pledged future aid is assumed. */
|
||||
export function quoteJointMarketEarlyBids(input: JointMarketEarlyBidInput): JointMarketEarlyBidQuote {
|
||||
if (!input || !input.context || !Array.isArray(input.native) || !Array.isArray(input.early) ||
|
||||
!Array.isArray(input.phase) || !whole(input.cashAvailable) || !whole(input.aidAvailable) ||
|
||||
!whole(input.cacheMaximum) || !whole(input.freeSlots) || !whole(input.marketEntrySlots) ||
|
||||
!whole(input.marketWinSlots) || input.marketWinSlots < input.marketEntrySlots)
|
||||
throw new RicheseBidPromiseError('Retain the original market, funded cache and hand capacity.');
|
||||
const {context, native, early, phase, opportunity} = input;
|
||||
const nativeRequired = richeseBidRequired(native,context);
|
||||
if (opportunity && (opportunity.turn !== context.turn || opportunity.event !== context.event ||
|
||||
opportunity.player !== context.player))
|
||||
throw new RicheseBidPromiseError('The bid opportunity belongs to a different market event.');
|
||||
const cache = quoteJointEarlyRicheseBids({player:context.player,turn:context.turn,
|
||||
early,phase,cacheMaximum:input.cacheMaximum});
|
||||
const phaseRequired = livePhaseBidPromises(phase,context.player,context.turn).some(row => row.answer);
|
||||
const local = opportunity && jointRicheseBidCompletionRange(native,phase,opportunity,{includePhaseYes:false});
|
||||
|
||||
const marketRange = (reserve: number | null): JointMarketBidRange | null => {
|
||||
if (!local || reserve === null || input.cashAvailable < reserve) return null;
|
||||
const slots = reserve > 0 ? input.marketWinSlots + 1 : input.marketEntrySlots;
|
||||
if (input.freeSlots < slots) return null;
|
||||
const maximum = Math.min(local.maximum,Number.MAX_SAFE_INTEGER,
|
||||
input.cashAvailable - reserve + input.aidAvailable);
|
||||
if (local.minimum > maximum) return null;
|
||||
return {minimum:local.minimum,maximum,
|
||||
allyPayment:Math.max(0,local.minimum - (input.cashAvailable - reserve))};
|
||||
};
|
||||
const earlyReserve = cache.earlyRequired ? cache.cache?.minimum ?? null : 0;
|
||||
const market = marketRange(earlyReserve);
|
||||
let marketForPhase: JointMarketBidRange | null = null;
|
||||
if (market && phaseRequired) {
|
||||
const range = phaseBidCompletionRange(phase,{turn:context.turn,player:context.player,
|
||||
kind:'current',minimum:market.minimum,maximum:market.maximum});
|
||||
if (range) marketForPhase = {...range,
|
||||
allyPayment:Math.max(0,range.minimum - (input.cashAvailable - (earlyReserve ?? 0)))};
|
||||
}
|
||||
const marketForCache = phaseRequired && cache.shared ? marketRange(cache.shared.minimum) : null;
|
||||
const canPass = !nativeRequired && (!cache.earlyRequired || !!cache.cache);
|
||||
return {nativeRequired,earlyRequired:cache.earlyRequired,phaseRequired,canPass,
|
||||
market,marketForPhase,marketForCache,
|
||||
cacheAfterPass:canPass ? cache.cache : null,
|
||||
phaseCacheAfterPass:canPass && phaseRequired ? cache.shared : null};
|
||||
}
|
||||
Reference in new issue
Block a user