@maka/maka-cli 5.120.0 → 5.122.0

package/bundle/typescript/src/commands/game/sideQuest/models/player.d.ts

@@ -1,10 +1,11 @@
 import { PlayerEquipment } from '../types/player-equipment.js';
+import type { WeaponSkill } from '../utilities/catalog-data.js';
 import type { Grid } from '../utilities/grids.js';
 import type { Host } from './host.js';
 import { type Aspect } from '../aspects.js';
 import { LifestyleChoices } from '../types/seed/lifestyle-seed.js';
 import { Logger } from '../utilities/logger.js';
-import { AugBonusKind } from '../augmentations.js';
+import { AugBonusKind, IImplantWeapon } from '../augmentations.js';
 import { Room } from './room.js';
 import { Item } from './item.js';
 import { Inventory } from './inventory.js';
@@ -20,6 +21,40 @@ export type FightStance = 'manual' | 'non-lethal' | 'lethal';
 export declare const STANCE_CYCLE: FightStance[];
 /** The old names, still accepted from saves and the stance command. */
 export declare const STANCE_ALIASES: Record<string, FightStance>;
+/**
+ * THE MATRIX HAS ITS OWN STANCE (mjmcee on uMQAhaAysgaKpWFkn,
+ * 2026-09-03): "I have a concept ... which leverages the combat stance
+ * in the meat world (Manual / Non-Lethal / Lethal) which I'd like to
+ * get into the matrix space. Toggling between default BF (Attack) or
+ * HotF (Sleaze) as TAB. Normal 'deck config <asdf>' still sets up the
+ * config."
+ *
+ * So Tab is PLANE-AWARE: in the meat it cycles the fight autopilot, on
+ * the Matrix it flips which of the book's two intrusion actions your
+ * next hack is. Two values, not three -- there is no "manual" here,
+ * because a Matrix intrusion is never automated; the stance picks the
+ * ACTION, it does not decide whether to act.
+ *
+ * BRUTE FORCE IS THE DEFAULT, per that directive. It reverses what the
+ * engine did before (both hack and mark defaulted to Sleaze), and it
+ * is the honest default for a stance you can see: the loud route is
+ * the one you should have to notice you are in.
+ *
+ * This is the DECK'S POSTURE, not its configuration -- "deck config"
+ * still assigns the Attack/Sleaze/DP/Firewall array (p.227), and the
+ * stance decides which of those two attributes your intrusion leans
+ * on. Both matter: a Sleaze stance on a deck configured for Attack is
+ * a quiet approach with a low ceiling.
+ */
+export type MatrixStance = 'attack' | 'sleaze';
+export declare const MATRIX_STANCE_CYCLE: MatrixStance[];
+/** What each stance is CALLED in the book -- printed everywhere the
+ *  engine used to say "loud"/"quiet", so the vocabulary teaches the
+ *  real action names (the whole point of uMQAhaAysgaKpWFkn). */
+export declare const MATRIX_STANCE_ACTION: Record<MatrixStance, string>;
+/** The words a player may type, including the engine's older ones. */
+export declare const MATRIX_STANCE_ALIASES: Record<string, MatrixStance>;
+export declare function normalizeMatrixStance(v: string | undefined): MatrixStance;
 export declare function normalizeStance(v: string | undefined): FightStance;
 export type Plane = 'meat' | 'matrix' | 'astral' | 'drone';
 /** Meat and a jumped-in drone share the physical world. */
@@ -96,7 +131,7 @@ export type SimMode = 'cold' | 'hot';
  * this not-yet-carried list; all three are now real and hooked, one per
  * command file beside them.)
  */
-export type SkillName = 'blades' | 'clubs' | 'unarmed' | 'gunnery' | 'astral-combat' | 'cybercombat' | 'sneaking' | 'perception' | 'palming' | 'escape-artist' | 'disguise' | 'hacking' | 'locksmith' | 'computer' | 'electronic-warfare' | 'hardware' | 'negotiation' | 'con' | 'intimidation' | 'etiquette' | 'leadership' | 'performance' | 'instruction' | 'first-aid' | 'medicine' | 'assensing' | 'spellcasting' | 'counterspelling' | 'piloting' | 'conjuring' | 'compiling' | 'decompiling' | 'registering' | 'software' | 'impersonation' | 'ritual-spellcasting' | 'gymnastics' | 'running' | 'swimming' | 'automatics' | 'pistols' | 'longarms' | 'banishing' | 'summoning' | 'binding' | 'cybertechnology' | 'alchemy' | 'disenchanting' | 'artificing' | 'aeronautics-mechanic' | 'industrial-mechanic' | 'automotive-mechanic' | 'nautical-mechanic' | 'navigation' | 'tracking' | 'survival' | 'archery' | 'free-fall';
+export type SkillName = 'blades' | 'clubs' | 'unarmed' | 'gunnery' | 'astral-combat' | 'cybercombat' | 'sneaking' | 'perception' | 'palming' | 'escape-artist' | 'disguise' | 'hacking' | 'locksmith' | 'computer' | 'electronic-warfare' | 'hardware' | 'negotiation' | 'con' | 'intimidation' | 'etiquette' | 'leadership' | 'performance' | 'instruction' | 'first-aid' | 'medicine' | 'assensing' | 'spellcasting' | 'counterspelling' | 'piloting' | 'conjuring' | 'compiling' | 'decompiling' | 'registering' | 'software' | 'impersonation' | 'ritual-spellcasting' | 'gymnastics' | 'running' | 'swimming' | 'automatics' | 'pistols' | 'longarms' | 'banishing' | 'summoning' | 'binding' | 'cybertechnology' | 'alchemy' | 'disenchanting' | 'artificing' | 'aeronautics-mechanic' | 'industrial-mechanic' | 'automotive-mechanic' | 'nautical-mechanic' | 'navigation' | 'tracking' | 'survival' | 'archery' | 'free-fall' | 'heavy-weapons' | 'throwing-weapons' | 'exotic-melee' | 'exotic-ranged';
 export declare const SKILL_NAMES: SkillName[];
 /**
  * Skills that fall back to the legacy `combatSkill` attribute when no
@@ -147,6 +182,7 @@ export declare function firearmSkillFor(weapon: {
     name: string;
     shape?: string;
     category?: string;
+    weaponSkill?: WeaponSkill;
 }): SkillName;
 export interface ICombatAttributes {
     body?: number;
@@ -293,6 +329,11 @@ export declare class Player extends AbstractPlayer {
     private _autoStance;
     get autoStance(): FightStance;
     set autoStance(v: FightStance);
+    /** Which of the book's two intrusion actions the next hack uses
+     *  (see MatrixStance). Sheet-visible, like its meat-world twin. */
+    private _matrixStance;
+    get matrixStance(): MatrixStance;
+    set matrixStance(v: MatrixStance);
     grappledBy?: string;
     grappleThreshold?: number;
     grappling?: string;
@@ -763,6 +804,11 @@ export declare class Player extends AbstractPlayer {
      * never a die, and a die is never a limit.
      */
     smartlinkAccuracyBonus(weapon?: Item | null): number;
+    /**
+     * A LASER SIGHT's +1 Accuracy (p.432), built in or fitted -- and never
+     * cumulative with a smartlink: getAttackLimit takes the larger of the two.
+     */
+    laserSightBonus(weapon?: Item | null): number;
     get matrixTaken(): number;
     get maxMatrixBoxes(): number;
     /** Routes Matrix combat damage into the jacked-in deck's hardware track. */
@@ -826,6 +872,30 @@ export declare class Player extends AbstractPlayer {
      */
     augGrades: Map<string, string>;
     hasAug(key: string): boolean;
+    /**
+     * THE WEAPON BUILT INTO YOUR HANDS (core p.458, xHarA3TNgxZXtZwgp).
+     * Canon routes these through Unarmed Combat and the Physical limit,
+     * so they REPLACE the bare-fists profile rather than sitting in a
+     * hand slot -- see getWeaponProfile and utilities/combat-exchange.ts,
+     * the two places that compute a punch.
+     *
+     * A drawn weapon always wins: chrome in the palm does not stop you
+     * shooting. Mutually exclusive by row (excludes), so at most one is
+     * ever installed and the find is the answer rather than a contest.
+     */
+    implantWeapon(): IImplantWeapon | undefined;
+    /**
+     * Jolts left in a shock hand. Ten per hand in the book, recharging
+     * one per ten seconds while plugged in -- there is no wall clock here
+     * for a hand to be plugged into, so the trickle is compressed to a
+     * refill on rest (commands/rest.ts). Session state: a fresh install
+     * arrives charged.
+     */
+    implantCharges: number;
+    /** Spends one jolt. Returns what is left. */
+    spendImplantCharge(): number;
+    /** Back to full -- a rest, or the moment the chrome goes in. */
+    refillImplantCharges(): void;
     /** Full essence points lost, rounded up -- the toll Magic/Resonance pay. */
     get essenceBurn(): number;
     /**
@@ -838,6 +908,23 @@ export declare class Player extends AbstractPlayer {
         essence: number;
         grade?: string;
     }): void;
+    /** Every effect that applies right now, with the rating it scales by. */
+    private applyingEffects;
+    private sumEffects;
+    /**
+     * Dice the gear adds to a pool or a skill's tests (cf. augBonus,
+     * qualityBonus): `kind` is a pool kind or a SkillName; `only` names a
+     * narrowing an effect may carry ('haggle', 'silent', 'matrix-search').
+     */
+    gearBonus(kind: string, opts?: {
+        only?: string;
+    }): number;
+    /** What the gear adds to a LIMIT (a Shopsoft's +1 Social on a haggle). */
+    gearLimit(kind: 'physical' | 'mental' | 'social' | 'accuracy', opts?: {
+        only?: string;
+    }): number;
+    /** A capability the gear grants (dni, smartlink, no-fog, low-light...), by key. */
+    hasCapability(key: string): boolean;
     /**
      * The single tap every pool reads chrome through. Wired Reflexes tiers
      * don't stack -- the higher tier wins (II supersedes I) -- but the
@@ -1079,6 +1166,24 @@ export declare class Player extends AbstractPlayer {
     static slotWord(group: keyof PlayerEquipment, slot: string): string;
     /** True for the hand slots that hold a wielded weapon. */
     static isWeaponSlot(group: keyof PlayerEquipment, slot: string): boolean;
+    /**
+     * WHERE A THING ACTUALLY IS RIGHT NOW, which for a weapon is not a
+     * property of the slot (user report, 2026-09-03: "when looking at
+     * equipment, and I have a Katana Holstered, I should not see Right
+     * hand Katana (weapon hand) -- it's not in hand, it's in holster").
+     *
+     * SLOT_WORDS is static, so it can only ever say where a weapon lives
+     * when drawn. The weapon slot is really two places -- the hand and the
+     * holster -- and `weaponDrawn` is which one. Everything else in the
+     * game already knew: the HUD prints "Holstered:", equip prints "You
+     * slide it into your holster", and the equipment screen's own top line
+     * prints HOLSTERED. Only the worn listing underneath still read the
+     * static word, so one screen contradicted itself.
+     *
+     * Instance method, not static, precisely because the answer depends on
+     * the actor rather than the slot.
+     */
+    wornSlotWord(group: keyof PlayerEquipment, slot: string): string;
     unequip(input: string): string;
     /**
      * The slot an ITEM wears in: the category decides (determineEquipmentSlot)
@@ -1223,7 +1328,11 @@ export declare class Player extends AbstractPlayer {
             bonus: number;
         }[];
         ignored: Item[];
+        bonusCapped: number;
+        encumbrance: number;
     };
+    /** The p.169 encumbrance penalty on Agility and Reaction, as dice off those pools. */
+    get encumbrancePenalty(): number;
     getAttackPool(): number;
     /**
      * The subdual pool: bare-hands work regardless of what's in the other
@@ -1526,7 +1635,7 @@ export declare class Player extends AbstractPlayer {
     set astralPerceiving(v: boolean);
     sneaking: boolean;
     riggedDrone?: Item;
-    /** Whether the ridden drone carries a weapon mount (name/description duck-typing). */
+    /** Whether the ridden drone carries a weapon mount (its vehicle block, catalog v13; the name for generated frames). */
     get droneArmed(): boolean;
     dumpshockedUntil: number;
     get dumpshocked(): boolean;
@@ -1539,7 +1648,7 @@ export declare class Player extends AbstractPlayer {
         back: string;
     };
     socialMarks: Set<string>;
-    /** The best Focus item on this actor, if any -- scales casting power. */
+    /** The best Focus item on this actor, if any -- by Force (catalog v13: ratingValue). */
     getBestFocus(): Item | undefined;
     getMagicPool(): number;
     /**