@maka/maka-cli 5.127.0 → 5.129.0

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

@@ -1,1883 +0,0 @@
-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, IImplantWeapon } from '../augmentations.js';
-import { Room } from './room.js';
-import { Item } from './item.js';
-import { Inventory } from './inventory.js';
-import { AbstractPlayer } from '../types/shared/abstracts.js';
-/**
- * Shadowrun-style combat attributes, deliberately trimmed to the four that
- * drive dice pools here: Body (soak + condition monitor size), Agility
- * (attack pool), Reaction (defense pool), and a single flat combat skill
- * (attack pool). Everything else a real character sheet would carry is out
- * of scope until something actually needs it.
- */
-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. */
-export declare function isPhysicalPlane(plane: Plane): boolean;
-/**
- * ARE THESE TWO STANDING ON THE SAME SIDE OF A HOST'S WALL?
- *
- * The companion to fileReach, and it exists for the same reason: the
- * boundary was being asked about in more than one place and the copies
- * disagreed. fileReach settled it for FILES; nothing settled it for
- * ICONS, so `look` honoured insideHost while every verb that picks a
- * target read the room's raw actor list and saw straight through the
- * wall. A technomancer standing inside a host was told "Empty
- * architecture -- turning geometry and nothing in it worth the trip" by
- * one surface and offered those same two IC as spike targets by the
- * next.
- *
- * CANON MAKES THE PANEL BINDING, not the target list. Inside a host you
- * see and interact with the icons inside it and not the ones outside,
- * and from the grid the inside is unreachable (p.246) -- and threading
- * adds its own half of the same rule: "You can only use complex forms
- * on icons you've spotted" (p.251). An icon the room refuses to name is
- * an icon nobody has spotted, so targeting it was never legal.
- *
- * BOTH IN THE SAME ROOM IS THE PRECONDITION, and every caller has it --
- * these are room-scoped target lists. Given that, comparing insideHost
- * directly is the whole rule: both undefined means both are out on the
- * open grid, both equal to the room means both are inside its
- * architecture. There is deliberately no third state.
- *
- * MEAT AND ASTRAL ACTORS PASS TRIVIALLY, which is correct and not an
- * oversight: insideHost is persona state, so a body in the room has
- * none. The plane filters the callers already apply are what keep those
- * actors out of a Matrix target list; this function answers one question
- * and is not a second plane check.
- */
-/**
- * A persona's place in the Matrix (SR5 p.239, p.246): out on a grid, or
- * inside a host it entered from one -- and never on a street. See
- * Player.matrixPosition.
- */
-export type MatrixPosition = {
-    kind: 'grid';
-    grid?: Grid;
-} | {
-    kind: 'host';
-    host: Host;
-    from?: Grid;
-};
-export declare function sameHostSide(actor: Player, other: Player): boolean;
-export type SimMode = 'cold' | 'hot';
-/**
- * The SR5e-condensed active skill list. Every pool that used to lean on
- * the single generic `combatSkill` attribute now draws the SPECIFIC
- * skill (firearms for guns, blades for melee weapons, unarmed for fists
- * and subdual, hacking for cybercombat). Non-combat skills back their own
- * mechanics as they land -- perception drives search rolls today; the
- * rest are rated on the sheet and waiting for their verbs.
- */
-/**
- * The active-skill sheet, rounded out from the SR5e canon list (p.90-91,
- * p.151) at this engine's granularity. CONDENSATIONS (canon -> here):
- * Automatics/Longarms/Pistols/Heavy Weapons/Archery -> firearms;
- * Gymnastics/Running/Swimming -> athletics; the Pilot family ->
- * piloting; Summoning/Binding/Banishing -> conjuring; Impersonation
- * rides disguise (its voice half). Every skill listed HOOKS a live
- * system -- see the site named beside it. Canon skills acknowledged but
- * NOT yet carried (no system to hook): Throwing Weapons, Exotic
- * Weapons, Diving, Free-Fall, Survival, Tracking, Navigation, Animal
- * Handling, Demolitions, Forgery, Chemistry, Armorer, the Mechanic
- * family, Biotechnology, Cybertechnology, Arcana, Alchemy, Artificing,
- * Ritual Spellcasting, Disenchanting, and Knowledge/Language skills.
- * (The Resonance trio -- Compiling, Decompiling, Registering -- WAS on
- * this not-yet-carried list; all three are now real and hooked, one per
- * command file beside them.)
- */
-export { SKILL_NAMES } from '../skills.js';
-export type { SkillName } from '../skills.js';
-import type { SkillName } from '../skills.js';
-/**
- * Skills that fall back to the legacy `combatSkill` attribute when no
- * explicit rating is given -- this is what keeps every existing NPC seed
- * (which only carries combatSkill) rolling exactly the pools it always
- * has, ice included (its Matrix strikes ride `hacking`).
- */
-export declare const COMBAT_SKILL_FALLBACK: ReadonlySet<SkillName>;
-/**
- * WHICH GUN ROLLS WHICH SKILL (SR5 p.130, p.132).
- *
- * Canon splits firearms three ways by the weapon in your hands, and the
- * split is by CLASS, not by calibre:
- *   Pistols    -- handheld pistols: hold-out, light, heavy, tasers,
- *                 revolvers, semi-automatics (p.132)
- *   Automatics -- larger than a handheld pistol, smaller than a rifle:
- *                 machine pistols, SMGs, assault rifles and automatic
- *                 carbines (p.130; machine pistols are Automatics
- *                 specifically, p.427)
- *   Longarms   -- extended barrels braced against the shoulder:
- *                 sporting and sniper rifles, and shotguns (p.132)
- *   Archery    -- bows and crossbows (p.130 specializations, p.424)
- *
- * READ OFF THE SAME HAYSTACK Item.accuracy already classifies by, and
- * deliberately so: two independent weapon classifiers would eventually
- * disagree about what an Ares Alpha is, and the one that disagreed
- * silently would be this one. The patterns are kept in the same order
- * and the same words.
- *
- * ORDER MATTERS. 'machine pistol' must be tested for Automatics BEFORE
- * the Pistols branch, or the word 'pistol' claims it -- and canon puts
- * it in Automatics. Likewise a 'sniper rifle' must reach Longarms
- * before 'rifle' reaches Automatics.
- *
- * UNRECOGNISED IRON FALLS TO PISTOLS, which is the commonest class and
- * the one Item.accuracy also defaults to (heavy pistols). A gun the
- * patterns have never seen rolls something rather than nothing.
- */
-/**
- * The three skills a FIREARM can exercise. Archery is not among them:
- * it is a Combat Active skill for string-loaded weapons (p.130), and
- * the things that key off "is this a gun" -- the smartlink bonus
- * (p.433 firearm accessory), a drone's armed mount -- do not apply to a
- * crossbow.
- */
-export declare const FIREARM_SKILLS: SkillName[];
-export declare function firearmSkillFor(weapon: {
-    name: string;
-    shape?: string;
-    category?: string;
-    weaponSkill?: WeaponSkill;
-}): SkillName;
-export interface ICombatAttributes {
-    body?: number;
-    agility?: number;
-    reaction?: number;
-    combatSkill?: number;
-    /**
-     * Per-skill ratings (1-8; see SkillName). Any skill omitted here
-     * defaults: combat skills to `combatSkill`, everything else to 0
-     * (unskilled -- rolled as the linked attribute MINUS ONE where a
-     * mechanic supports defaulting, e.g. perception on search).
-     */
-    skills?: Partial<Record<SkillName, number>>;
-    /**
-     * Innate magical talent -- 0 (the default) is mundane, like most of the
-     * Sixth World. An Awakened actor (magic > 0) knows every spell innately
-     * and casts from this attribute instead of needing formulas; see the
-     * magic section below.
-     */
-    magic?: number;
-    /** Melee/unarmed damage and carrying capacity. */
-    strength?: number;
-    /** Stun track size and drain resistance. */
-    willpower?: number;
-    /** First aid effectiveness; NPC hacking. */
-    logic?: number;
-    /** Defense pool (half, rounded down) and future perception checks. */
-    intuition?: number;
-    /** Social presence -- listed on the sheet now, mechanics to come. */
-    charisma?: number;
-    /** Luck: per-job pool of edge points, burned to push a strike (see edge.ts). */
-    edge?: number;
-    /**
-     * Technomancer talent -- 0 (the default) for everyone else. A resonance
-     * actor is a LIVING PERSONA: they jack into the Matrix with no deck and
-     * no commlink (their brain is the hardware), resonance boosts every
-     * Matrix pool, and ALL Matrix damage lands on their real stun track --
-     * there's no deck to brick, only a mind to burn.
-     */
-    resonance?: number;
-    /**
-     * Physical adept: magic channeled into the body instead of spells.
-     * Counts as Awakened (auras read them, assensing works) but they cast
-     * NOTHING -- not even from formulas -- and cannot astrally project.
-     * Instead, half their magic (rounded down) is added to their meat-plane
-     * attack and defense pools: improved reflexes, killing hands.
-     */
-    adept?: boolean;
-    /**
-     * ADEPT POWER POINTS BOUGHT WITH CREATION KARMA -- the mystic adept
-     * (SR5 p.69-70), and the field's presence is what makes one.
-     *
-     * A mystic adept is NOT "a Magic rating split between spells and
-     * powers", which is the common description and is wrong: their Magic
-     * comes off the priority column exactly as a magician's does and is
-     * never divided. It sets the spell count AND caps Power Points, which
-     * are then bought SEPARATELY at 5 karma each.
-     *
-     * WHY 5 AND NOT 2, recorded because the book contradicts itself and
-     * the next reader will find it. Core p.69-70 states 5; the worked
-     * example on p.71 spends 10 karma for 2 points; and Run Faster's Point
-     * Buy (p.64-65) independently restates "5 Karma per power point". The
-     * Final Calculations checklist at core p.102 says 2. Three statements
-     * across two separately typeset books against one summary line, and no
-     * errata resolving it in the indexed sources -- so 5, and the outlier
-     * is noted rather than hidden.
-     *
-     * A FULL ADEPT LEAVES THIS UNSET. Their points are free and equal to
-     * their Magic, which is why effectivePowerPoints below reads `magic`
-     * for them -- see the note there for why that is not a special case.
-     */
-    powerPoints?: number;
-    /** Aspected magician (SR5 p.69): the one magical group kept -- 'sorcerer'
-     *  or 'conjurer' (aspects.ts). Absent = full magician, adept, or mundane. */
-    aspect?: string;
-    /**
-     * The spells a magician/mystic adept CHOSE at creation (SR5 p.300, up to
-     * Magic x 2). Keys into the catalog's spell rows. ABSENT means "knows
-     * every spell", the pre-selection behaviour -- so an existing save with
-     * no spellbook keeps casting anything, and only a chargen that sends a
-     * list is narrowed to it. An empty list would mean a magician who chose
-     * nothing; absent is the grandfather case, and the two are kept distinct.
-     */
-    knownSpells?: string[];
-    /**
-     * The adept powers CHOSEN at creation (SR5 p.308-310): key -> level, keys
-     * into the catalog's adept-power rows, total cost within
-     * effectivePowerPoints. ABSENT means the COMPRESSED model -- Power Points
-     * grant floor(pp/2) on every meat-plane pool, the pre-selection behaviour
-     * every existing adept keeps. Present means the powers themselves are the
-     * effects and the compressed bonus does not apply.
-     */
-    adeptPowers?: Record<string, number>;
-}
-export interface IPlayerConstructorConfig {
-    playerName: string;
-    startLocation: Room;
-    lifestyleChoices?: LifestyleChoices;
-    combat?: ICombatAttributes;
-}
-/**
- * ONE PAN DEFENCE, ITEMISED (p.240 / p.238).
- *
- * This exists so the dashboard's LABEL and the dice it labels come out
- * of the same call. They did not, and the cost was a caught defect: the
- * defence was corrected to the book (Intuition/Willpower + whole
- * Firewall) while commands/pan.ts went on calling the result "Logic +
- * quality" -- the right number under the name of the code that had been
- * deleted. Whoever reads a breakdown off this cannot describe a pool
- * this engine does not roll, because there is nowhere left to say it.
- */
-export interface IPanDefence {
-    /** 'Intuition' against a sleaze, 'Willpower' against a smash. */
-    attributeName: 'Intuition' | 'Willpower';
-    attribute: number;
-    firewall: number;
-    /** A hidden PAN must be FOUND first. */
-    silent: number;
-    /** Signal Scrub cleans the noise floor. */
-    scrub: number;
-    /** Sneak deepens a silent PAN's cover. */
-    sneak: number;
-    total: number;
-}
-export declare class Player extends AbstractPlayer {
-    readonly _playerName: string;
-    protected _currentLocation: Room;
-    protected _inventory: Inventory;
-    protected _equipment: PlayerEquipment;
-    protected _maxCarryingWeight: number;
-    protected _lifestyleChoices: LifestyleChoices;
-    protected logger: Logger;
-    private _currency;
-    activeCallPartner?: Player;
-    crewChannel?: {
-        playerName: string;
-        handle: string;
-        party?: boolean;
-    };
-    runningSilent: boolean;
-    combatOpponent?: Player;
-    lastExchangeAt: number;
-    inExchange: boolean;
-    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;
-    rallyInitBonus: number;
-    directedDice: number;
-    inspiredGuardDice: number;
-    surrendered: boolean;
-    /**
-     * WHERE you took cover -- not whether. TAKE COVER is a Simple Action
-     * (SR5e p.166) and the +2/+4 it buys (p.190) belongs to the defender
-     * who spent it, so the game has to remember that it was spent.
-     *
-     * Storing the SPOT rather than a boolean makes the state
-     * self-invalidating: cover is live only while `coverAtSpot` still
-     * equals where you are (see spots.ts isInCover). Step out from behind
-     * the crates and the bonus is gone with no cleanup code anywhere to
-     * forget -- the alternative, a flag plus a clear on every movement
-     * path, is a second source of truth waiting to disagree with the
-     * first.
-     *
-     * Mid-combat state, never saved.
-     */
-    coverAtSpot?: string;
-    /**
-     * This actor is deliberately HOLDING THEIR POSITION against passage --
-     * a doorman, a picket, someone posted to stand there. Distinct from
-     * merely being present: an unguarding NPC in a doorway steps aside and
-     * the move narrates it (utilities/spots.ts yieldDoorway), while a
-     * guarding one holds the way shut (holdsGround).
-     *
-     * Player ruling 2026-08-27: "NPCs can be barriers (can't move through
-     * them)". This is what makes that true, and it is a BOOLEAN rather
-     * than a direction on purpose -- doorwayOccupants already reads the
-     * exit cell and its approach cell, so the geometry knows WHICH doorway
-     * they hold. Storing the direction too would be one fact in two
-     * places, free to disagree.
-     *
-     * Cleared when they stand down -- talked round (commands/bluff.ts),
-     * or beaten, which `surrendered` already covers. Clearing it opens the
-     * way for EVERYONE, deliberately: a doorman who has stepped aside has
-     * stepped aside, and he is not tracking which of four runners
-     * persuaded him while standing in the same doorway.
-     */
-    guarding: boolean;
-    /**
-     * THIS ACTOR IS OPPOSITION (JjQdy4A4tzcQdPHno: "none of the NPCs ever
-     * seem to get hostile").
-     *
-     * WHAT WAS ACTUALLY MISSING, after two wrong diagnoses of mine. It is
-     * not that nothing wakes them: go.ts's arrival calls
-     * performAction('enters'), which fans out to NPC.see, and `enter` is
-     * in RESPOND_WORTHY_VERB -- the AI is asked. It is not that they
-     * cannot fight: the brief lists `attack`, `kill` and `subdue` and
-     * explains combat at length. And the detection canon asks for is
-     * already there -- npc.ts runs an opposed Agility + sneaking vs
-     * Intuition + perception test per witness on a sneaking arrival, and
-     * a winner is never registered at all.
-     *
-     * What was missing is a REASON. OFFERING THE VERB IS NOT THE SAME AS
-     * GIVING THEM A REASON: an NPC briefed with no opposition to the
-     * player answers neutrally, because neutral is in character. So this
-     * flag exists to tell them they have one.
-     *
-     * WHAT IT DOES NOT DO, and these are the load-bearing absences:
-     *   - It does NOT attack on sight. It adds a line to the brief; the
-     *     AI still chooses, and challenging, raising an alarm, or calling
-     *     for backup are all better first moves than shooting.
-     *   - It adds NO tick and NO new wake-up. The occasion already
-     *     existed; this rides it.
-     *   - It is never INFERRED. Only a seed that says so, or a scene that
-     *     sets it deliberately, makes someone opposition.
-     *
-     * The asymmetry that decides every judgement call here: a guard who
-     * should have gone hostile and didn't is a missed beat, and a
-     * bartender who goes hostile is a broken scene. PREFER UNDER-FIRING.
-     *
-     * Cleared the same way `guarding` is -- talked round, or beaten.
-     */
-    hostile: boolean;
-    /**
-     * They have already heard one story from this runner and did not buy
-     * it. A person remembering a failed con is good fiction (and stops
-     * bluff being a free retry loop) -- unlike BURNING a barrier, which is
-     * what the ruling above removed. Other approaches stay open: a mark
-     * who saw through your patter can still be leaned on or fought.
-     */
-    conAttemptedBy: Set<string>;
-    /**
-     * POSTURE (player request 2026-08-27: sit and lie down as movement
-     * commands). Three states, and only two of them are mechanical:
-     *
-     *  'standing' -- the default.
-     *  'sitting'  -- a social posture. SR5e gives kneeling and sitting no
-     *                combat modifier of their own, so neither does this:
-     *                it changes the fiction and nothing else. Inventing a
-     *                penalty to make the verb feel weightier would be
-     *                inventing rules.
-     *  'prone'    -- flat, and it is a real combat state. Dropping is a
-     *                FREE action (p.164); getting up is a SIMPLE one and
-     *                costs a Body + Willpower (2) test while wounded
-     *                (p.166). Prone melee attacker -1 (p.187), prone
-     *                defender -2 except against ranged from beyond 5m
-     *                (p.189), and +1 to anyone attacking you (p.187).
-     *
-     * Deliberately NOT a second notion of "on the ground": a GRAPPLED
-     * actor counts as prone for attacks against them (p.195), and that
-     * is derived where it is used rather than written here, so the two
-     * can never disagree about who is down.
-     */
-    posture: 'standing' | 'sitting' | 'prone';
-    archetypeName?: string;
-    gender?: 'male' | 'female';
-    private _weaponDrawn;
-    get weaponDrawn(): boolean;
-    set weaponDrawn(v: boolean);
-    private _plane;
-    get plane(): Plane;
-    set plane(v: Plane);
-    bodyRoom?: Room;
-    /** WHERE THE BODY STANDS while jumped into a frame (planes.ts
-     *  enterDrone/leaveDrone, 2026-09-06): the frame paces the room on
-     *  atSpot/atCell like anyone on the floor (utilities/spots.ts
-     *  onTheFloor), so the body's own spot has to be kept aside and put
-     *  back on jump-out. Transient -- never saved; a resume is meat. */
-    bodySpot?: string;
-    bodyCell?: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    private _simMode?;
-    get simMode(): SimMode | undefined;
-    set simMode(v: SimMode | undefined);
-    /**
-     * WHO HAS YOUR CONNECTION LINK-LOCKED (p.229), by icon name.
-     *
-     * "Another persona or device sends keep-alive signals to your deck that
-     * force it to cancel any attempt to leave the Matrix." While this is
-     * non-empty you cannot walk out of the Matrix voluntarily -- only a
-     * successful Jack Out action (p.240) frees you, and it still costs
-     * dumpshock.
-     *
-     * A SET, not a flag, because canon allows several at once: "if more
-     * than one persona has you link-locked, you need to beat each of them
-     * individually." Black IC and Blaster IC can both be on you.
-     *
-     * Session state, like the rest of the Matrix layer -- leaveMatrix
-     * clears it, since a persona that is out is not locked into anything.
-     */
-    linkLockedBy: Set<string>;
-    /**
-     * THE HOST THIS PERSONA IS INSIDE, if any (SR5 p.246).
-     *
-     * "The virtual space inside a host is separate from the outside grid.
-     * When you're outside of a host, you can't interact directly with
-     * icons inside it... Once you're inside, you can see and interact with
-     * icons inside the host, but not outside."
-     *
-     * Reported three ways by the same play-tester before this existed
-     * (hhSW, eJAN, rG8L): the engine had NO inside-vs-outside state, so a
-     * persona standing on a room's grid patch WAS in its host as far as
-     * every surface was concerned -- PANs and cameras that live inside the
-     * host were listed on the open grid, and IC hunted people who had
-     * never entered anything.
-     *
-     * Set by `enter` (Complex Action, one mark, no test -- p.239: "a host
-     * allows anyone to enter if they've got a mark, and anyone inside can
-     * exit"), cleared by `exit` and by every route out of the Matrix.
-     * Session state like hostAlert and linkLockedBy: leaving the Matrix
-     * ends it, so nothing here is persisted.
-     */
-    /**
-     * WHERE THE PERSONA IS (increment 2 of the Matrix position model): on a
-     * grid, or inside a host it entered from one. Session-only, like
-     * bodyRoom. The body stays in currentLocation on every plane -- the
-     * persona never writes it. The setter fires the live-sheet beat, which
-     * is the beat the currentLocation setter used to fire on enter/exit.
-     * `grid` may be unknown (fixtures, and increment 2 itself): unknown is
-     * not "another grid", so it costs nothing.
-     */
-    private _matrixPosition?;
-    get matrixPosition(): MatrixPosition | undefined;
-    set matrixPosition(v: MatrixPosition | undefined);
-    /** The grid the persona rides, when it is on one. */
-    get currentGrid(): Grid | undefined;
-    /** The host the persona is inside, when it is inside one. */
-    get hostInside(): Host | undefined;
-    /**
-     * @deprecated compat through increment 4 -- read hostInside / write
-     * matrixPosition. The room a host stands over, when inside one. The
-     * setter still builds the position so every old writer keeps working.
-     */
-    private _compatInsideRoom?;
-    get insideHost(): Room | undefined;
-    set insideHost(room: Room | undefined);
-    /** The grid last stood on, so an exit built through the old setter returns there. */
-    private get lastGrid();
-    /**
-     * MATRIX ATTRIBUTES BURNED OFF BY IC (p.248): Acid eats Firewall,
-     * Binder eats Data Processing, Jammer eats Attack, Marker eats Sleaze.
-     * "The reduction is cumulative and lasts until you reboot the targeted
-     * device", so this is session state that leaveMatrix clears -- a
-     * jack-out reboots the deck (p.240).
-     *
-     * Applied in matrixAttribute() rather than at the call sites, because
-     * that method is the ONE place all four attributes are read: the hack
-     * limits, the PAN defence, the IC defence, and the dumpshock resist
-     * all funnel through it. A reduction that did not bite there would be
-     * a number in a record that changed no roll.
-     */
-    matrixAttrLoss: Record<'attack' | 'sleaze' | 'dataProcessing' | 'firewall', number>;
-    astralTicks: number;
-    activeDeck?: Item;
-    /** The best working cyberdeck carried (bricked ones don't count). */
-    getCyberdeck(): Item | undefined;
-    /** Any deck at all, bricked included -- for status displays and repair. */
-    getAnyCyberdeck(): Item | undefined;
-    arOffline: boolean;
-    private _arMuted;
-    get arMuted(): boolean;
-    set arMuted(v: boolean);
-    panMarksBy: Map<string, number>;
-    overwatchScore: number;
-    overwatchLastTick: number;
-    /**
-     * The PAN's master device: your slaved gear defends behind its
-     * firewall (SR slaving, simplified). Best working deck beats the
-     * equipped commlink; no devices = no PAN (and nothing to hack).
-     */
-    /**
-     * AR EYES (canon p.221/229/235, RAG-checked 2026-08-24): Matrix
-     * icons -- host markers on the map included -- exist only through a
-     * persona device's AR overlay or a technomancer's living persona.
-     * No deck, no commlink, no resonance = the meat map shows no hosts.
-     * A cracked PAN (arOffline) cuts the overlay the same way -- and so
-     * does muting it yourself (arMuted): the map's host markers ARE AR, so
-     * an AR toggle that left them lit would be a lie.
-     */
-    hasMatrixEyes(): boolean;
-    /**
-     * A DIRECT NEURAL INTERFACE -- what VR needs and AR does not (SR5 core
-     * p.222-223, RAG-checked 2026-09-01, user canon check: "if you don't
-     * have a trode or wetware, you can't use a cyberdeck"). The book's
-     * split is exact: a commlink or deck works from its own screen and AR
-     * needs only a display route, but hot- or cold-sim VR needs a DNI --
-     * a datajack, a trode net, or an implanted commlink -- plus a sim
-     * module (decks carry one). The engine let anyone with a deck jack
-     * in; this is the gate it was missing. A technomancer's living
-     * persona IS the interface. The implanted commlink is not modelled
-     * here (no such aug yet), so it is not claimed.
-     */
-    hasDirectNeuralInterface(): boolean;
-    /** True for the one Electronics item that is a trode net (p.439-440). */
-    static isTrodeNet(item: Item): boolean;
-    /**
-     * WHAT CARRIES THE DIRECT NEURAL INTERFACE, for the equipment panel and
-     * the jack-in gate: a living persona, an implanted datajack, a trode net
-     * worn on the head, or one still in the bag (it works from there too --
-     * the engine has never made the player put it on, and a net in the bag
-     * was the only place it could live before the head slot existed).
-     */
-    dniSource(): {
-        kind: 'technomancer' | 'datajack' | 'trodes';
-        worn?: boolean;
-        item?: Item;
-    } | null;
-    /**
-     * THE PRICE OF SILENCE (canon p.235-236 "Running Silent",
-     * RAG-checked 2026-08-27): "-2 dice pool modifier to all of your
-     * Matrix actions" -- the processing your persona burns covering its
-     * own tracks. Add it at every Matrix-action roll site (hack.ts,
-     * mark.ts, overwatch.ts); it is a MATRIX-action modifier, so it
-     * rides whether you are jacked in or reaching from AR, and it never
-     * touches a meat-plane roll.
-     *
-     * This is the counterweight to silence no longer blinding your own
-     * overlay (utilities/ar.ts arSightUp): without it, running silent
-     * would buy a hidden icon and +2 PAN defence (getPanDefensePool) for
-     * nothing but some dropped calls.
-     */
-    get matrixActionPenalty(): number;
-    /**
-     * THIS PERSONA'S MATRIX ATTRIBUTE (p.226 for a deck's array, p.251
-     * for a living persona, p.222/p.234 for an ordinary device; p.46-47
-     * for what a limit is). All RAG-checked 2026-08-28 rather than
-     * recalled.
-     *
-     * ONE NUMBER, TWO ROLES, which is why it is named for the number
-     * rather than for either job:
-     *   - THE BRACKET on a Matrix action. SR5 writes them as `Hacking +
-     *     Logic [Sleaze]` and p.244 files the whole action list by which
-     *     limit it uses; the bracket caps HITS (see utilities/dice.ts).
-     *   - THE ATTRIBUTE in its own right -- Matrix VR initiative is Data
-     *     Processing + Intuition (p.229-230), where nothing is capped.
-     *
-     * It was called `matrixLimit` while the bracket was its only caller.
-     * Renamed once initiative wanted it, because a name that is accurate
-     * for its first use and misleading afterwards is a defect: reading
-     * `matrixLimit('dataProcessing')` in an initiative pool, you would
-     * reasonably assume something was being capped.
-     *
-     * Whole, never halved, in both roles.
-     *
-     * A TECHNOMANCER HAS NO DECK AND IS NOT UNLIMITED. Their living
-     * persona's Matrix attributes come from their Mental attributes
-     * (p.251): Attack = Charisma, Sleaze = Intuition, Data Processing =
-     * Logic, Firewall = Willpower. This engine used to give them
-     * Resonance/2 as dice, which is neither the right attribute nor the
-     * right kind of thing -- Resonance is their Device Rating, not their
-     * array.
-     *
-     * Returns 0 when the actor has no way to take the action at all (no
-     * deck, and a commlink has no Attack or Sleaze). Callers gate on the
-     * gear BEFORE rolling, so a 0 reaching rollPool means a caller
-     * skipped its gate -- which is why rollPool refuses a zero limit
-     * loudly rather than honouring it.
-     */
-    matrixAttribute(kind: 'attack' | 'sleaze' | 'dataProcessing' | 'firewall'): number;
-    /**
-     * REFUSE AN ACTION WHOSE BRACKET HAS BEEN EATEN TO ZERO, or undefined
-     * when it still has one. Returns the line the player reads.
-     *
-     * THIS IS ARITHMETIC, NOT A NEW RULE, and the derivation matters
-     * because it is the one place someone will later mistake for an
-     * invention. A bracket is a LIMIT ON HITS -- the rule this codebase
-     * states more often than any other -- so a limit of 0 permits zero
-     * hits, and a test that cannot score a hit cannot succeed. Refusing
-     * before the roll is the honest rendering of a guaranteed failure, not
-     * a ruling about what "Attack 0" means. Reading [0] as "no limit"
-     * would invert the bracket rule and hand the reducers' own targets
-     * back to the player.
-     *
-     * Canon is silent on acting at 0 -- RAG-checked; the nearest text is
-     * Marker's own at-zero clause and Diffusion's cannot-reduce-below-1,
-     * which the IC entries plainly override -- so nothing here leans on it.
-     *
-     * ONLY FOR A BURNED ATTRIBUTE. An attribute that is 0 because the
-     * actor has no deck at all is the pre-existing no-gear case, and its
-     * callers already gate on the gear with their own better message; this
-     * returns undefined there so those refusals keep saying what they say.
-     */
-    burnedAttributeRefusal(kind: 'attack' | 'sleaze' | 'dataProcessing' | 'firewall'): string | undefined;
-    /** Which IC eats which attribute (p.248), for naming the culprit. */
-    private static readonly ATTR_EATER;
-    private static readonly ATTR_NAME;
-    /** The undamaged array, before any IC reduction. */
-    /** Set on an IC actor (utilities/ic-actors.ts): "IC uses the Matrix attributes of its host" (p.247). */
-    icHost?: Host;
-    /** The IC kind an IC actor was launched as -- the name the host's running list carries. */
-    icKind?: string;
-    baseMatrixAttribute(kind: 'attack' | 'sleaze' | 'dataProcessing' | 'firewall'): number;
-    /**
-     * THE LIVE LINK -- what makes this runner reachable and lit (p.223,
-     * RAG-checked 2026-09-01: "a deck can perform all of the functions of
-     * a commlink"). The worn commlink, or failing that the working deck:
-     * a deck-only decker IS online, receives calls, and drives AR.
-     *
-     * The distinction this deliberately preserves: a POCKETED commlink is
-     * still not live (the 2026-08-24 ruling -- choosing not to wear the
-     * wearable is choosing silence), but a deck cannot be worn at all --
-     * it works from the kit BY the engine's own design, so its kit state
-     * IS its equipped state. ar.ts used to render the honest display of
-     * the old mechanics ("AR ON | Link offline"); this fixes the
-     * MECHANICS, so the display goes back to matching canon.
-     */
-    liveLink(): Item | undefined;
-    getPanMaster(): Item | undefined;
-    /**
-     * Defense against a PAN intrusion, itemised: the book's attribute plus
-     * the master's whole Firewall, +2 while running silent (a hidden PAN
-     * must be FOUND first). Loaded software helps: Signal Scrub cleans the
-     * noise floor (+1), Sneak deepens a silent PAN's cover (+2).
-     *
-     * THE DEFENCE IS THE BOOK'S, and it was wrong three ways at once
-     * (RAG-checked 2026-08-28, re-verified 2026-08-29). p.240: Hack on the
-     * Fly is opposed by INTUITION + Firewall. p.238: Brute Force by
-     * WILLPOWER + Firewall. Neither is Logic, and Firewall is a whole
-     * attribute on this side -- it was being halved by the same
-     * limits-to-pool substitution the attack side used, which is the one
-     * place that convention was costing the DEFENDER dice rather than the
-     * attacker.
-     *
-     * No limit, ever, and that is canon rather than an omission: limits
-     * apply only to a pool built from a skill plus an attribute (p.46-47),
-     * and there is no skill in Intuition + Firewall -- the melee example at
-     * p.174 spells it out, "no limit because there is no skill involved".
-     *
-     * TWO POOLS, NOT ONE, which is the part a player has to be able to
-     * see: since the attribute depends on what the intruder is DOING, a
-     * character's quiet defence and their brute-force defence are
-     * different numbers. commands/pan.ts shows both for that reason.
-     */
-    panDefence(against?: 'sleaze' | 'attack'): IPanDefence;
-    /** The dice for a PAN defence. See panDefence() for what is in them. */
-    getPanDefensePool(against?: 'sleaze' | 'attack'): number;
-    /**
-     * A PAN defence written out the way the dashboard says it -- built
-     * from the breakdown, never from a remembered formula, so a change to
-     * the pool cannot leave this describing the old one.
-     *
-     * Bonuses are named only when they are actually being paid, so the
-     * line doubles as the answer to "what is silence buying me".
-     */
-    panDefenceLine(against?: 'sleaze' | 'attack'): string;
-    /**
-     * The limit on THIS actor's current attack, or undefined when the
-     * engine models none.
-     *
-     * MEAT: the weapon's ACCURACY (p.46-47, p.168 -- "each weapon has an
-     * Accuracy rating that serves as its limit for attacks made with that
-     * weapon"), falling back to the PHYSICAL limit when there is no
-     * weapon behind the swing. That fallback is canon, not a default:
-     * p.168 puts unarmed attacks, and items used as part of an unarmed
-     * attack, on the inherent Physical limit. A gear limit REPLACES the
-     * inherent one whether it is higher or lower (p.46-47), so this is a
-     * substitution rather than a min/max.
-     *
-     * THE CALLER SUPPLIES THE WEAPON, and that is load-bearing. The
-     * exchange has already decided what is really in the attacker's hands
-     * -- drawn or holstered, and a dry or smartlink-locked firearm has
-     * already degraded to bare fists (combat-exchange weaponProfile). If
-     * this method re-derived the weapon it would answer a different
-     * question than the one the dice were rolled for, and the Accuracy
-     * shown would belong to a gun that is not being fired.
-     *
-     * MATRIX: the deck array bracket, unchanged (p.238/p.240).
-     *
-     * ASTRAL: still undefined, and that is a KNOWN gap, not an oversight.
-     * p.315 brackets astral attacks [Astral], and p.278 makes the Astral
-     * limit the greater of the Mental and Social limits -- two inherent
-     * limits this engine does not calculate. Reported rather than
-     * invented; it is its own item.
-     */
-    getAttackLimit(weapon?: Item | null): number | undefined;
-    /**
-     * WHO OWNS THE RECEIVING END (p.433, p.444).
-     *
-     * A smartgun system feeds data to the shooter's SMARTLINK, and canon
-     * names two ways to have one, which are worth different amounts:
-     *
-     *   'augmentation' -- a smartlink you paid ESSENCE for (cybereyes with
-     *                     the Smartlink vision enhancement, or the implant)
-     *   'gear'         -- glasses, goggles or contacts carrying the
-     *                     Smartlink vision enhancement (p.444)
-     *
-     * Undefined means no receiving end, and then a smartgun is just a gun:
-     * the data feed has nowhere to go.
-     *
-     * THE GEAR TIER IS DUCK-TYPED, the same school as Item.accuracy and
-     * rangedBase, so a generated pair of smartlink goggles works without
-     * anyone having added it to a table first. The augmentation tier is
-     * asked of the augmentation system, which already owns that fact.
-     *
-     * The gear tier must be WORN -- see the note in the body. The
-     * augmentation tier is not, and that asymmetry is canon rather than an
-     * oversight: an implanted smartlink is part of you (p.453), so there
-     * is nothing to put on and nothing to leave in a bag.
-     *
-     * ONE RESOLVER, TWO CONSUMERS: the +2 Accuracy (smartlinkAccuracyBonus)
-     * and the wireless +1 DICE for gear (getAttackPool) both ask this
-     * question and must never answer it differently. That is why the worn
-     * check lives here and not at either call site.
-     */
-    smartlinkTier(): 'augmentation' | 'gear' | undefined;
-    /**
-     * +2 Accuracy when a smartgun meets a smartlink (p.433), and 0 in
-     * every other pairing.
-     *
-     * EVERY FIREARM IN THIS ENGINE IS A SMARTGUN -- that is not an
-     * assumption made here, it is the model pan.ts already ships: a
-     * carried firearm is listed as "(smartgun)" on your PAN and can be
-     * cracked, which is only true of a smartgun system. So the weapon side
-     * of the pairing is `isFirearm`, and a bow or a blade never qualifies.
-     *
-     * WIRELESS DOES NOT GATE THIS ONE. p.433 keeps the +2 Accuracy when
-     * wireless is off -- a cable to your glasses still carries the feed --
-     * and spends wireless on a DICE POOL bonus instead. Keeping those two
-     * apart is the same discipline as the Matrix brackets: a limit is
-     * 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. */
-    takeMatrixDamage(boxes: number): number;
-    get matrixCrashed(): boolean;
-    /** The deck track, same rendering as conditionSummary(). */
-    matrixSummary(): string;
-    /**
-     * Cross-plane perception, the single rule everything filters through:
-     * same plane sees same plane; the astral perceives the meat world
-     * (shifted, not gone -- auras and movement, dimly); meat and Matrix see
-     * nothing beyond their own plane. Used by see/hear guards, targeting,
-     * and room listings.
-     */
-    canPerceive(other: Player): boolean;
-    /** Whether these two can trade physical blows (see attack.ts targeting). */
-    sharesCombatPlane(other: Player): boolean;
-    waitingForLull: boolean;
-    deathClaimed: boolean;
-    body: number;
-    agility: number;
-    reaction: number;
-    combatSkill: number;
-    magic: number;
-    strength: number;
-    willpower: number;
-    logic: number;
-    intuition: number;
-    charisma: number;
-    edge: number;
-    resonance: number;
-    adept: boolean;
-    /** Bought adept powers (mystic adept). See ICombatAttributes.powerPoints. */
-    powerPoints: number;
-    /** Chosen spellbook (magician/mystic adept). See ICombatAttributes.knownSpells.
-     *  UNDEFINED = knows every spell (grandfathered); a list = knows only those. */
-    knownSpells?: string[];
-    /** Aspected magician's one group (SR5 p.69) -- see aspects.ts. */
-    aspect?: Aspect;
-    /** Chosen adept powers, key -> level. See ICombatAttributes.adeptPowers.
-     *  UNDEFINED = the compressed floor(pp/2) model (grandfathered). */
-    adeptPowers?: Record<string, number>;
-    edgeRemaining: number;
-    edgeBoostArmed: boolean;
-    private _damageTaken;
-    private _stunTaken;
-    constructor(config: IPlayerConstructorConfig);
-    /** Everyone is born whole. */
-    static readonly ESSENCE_MAX = 6;
-    essence: number;
-    baseMagic: number;
-    baseResonance: number;
-    /** Installed 'ware, by catalog key (kind 'augmentation'). */
-    augmentations: Set<string>;
-    /**
-     * What GRADE each installed piece was cut at (see WARE_GRADES,
-     * p.451). Purely a record: grade changes what the surgery costs in
-     * essence and nuyen, never what the 'ware does, so augBonus never
-     * consults this. Absent = standard, which is what every pre-grade
-     * save and every archetype's starting chrome is.
-     */
-    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;
-    /**
-     * Burns the essence and records the 'ware. No gating here -- the clinic
-     * (commands/install.ts) owns the refusals (essence floor, conflicts,
-     * payment); archetype starting chrome installs through this too.
-     */
-    installAug(aug: {
-        key: string;
-        essence: number;
-        grade?: string;
-    }): void;
-    /**
-     * Which SOURCE an effect came from. The single accessor `bonus()`
-     * sums them all; the older per-source getters each sum their own,
-     * which is what lets the call sites migrate one at a time instead of
-     * in one unreviewable commit.
-     */
-    /** Every effect applying right now, with its source and its scale. */
-    private applyingEffects;
-    /**
-     * Sums one kind of effect. `lanes` narrows to particular sources --
-     * omitted means EVERY source, which is what the unified `bonus()`
-     * wants; the legacy getters each pass their own single lane so that
-     * a call site still adding two of them by hand cannot double.
-     */
-    /**
-     * The spells being sustained, and what each scales by.
-     *
-     * READS THE STATE cast.ts ALREADY KEEPS rather than a second map:
-     * the armor spell stores its hits, and the other two are booleans
-     * whose rows carry a flat value, so 1 is the right multiplier for
-     * them. Adding a parallel store would be two places to forget to
-     * update, which is the shape this whole pass has been removing.
-     */
-    private sustainedMagnitudes;
-    private sumEffects;
-    /**
-     * Dice the GEAR LANE adds, and nothing else.
-     *
-     * A LANE READER, NOT A POOL. Every pool in the game reads `bonus()`
-     * now; this survives as the way to ask what one source contributes,
-     * which is what the behaviour fixture interrogates and what a "where
-     * did that die come from" answer would need. It has no production
-     * caller of its own, and that is the correct state for it rather than
-     * a sign it should go: deleting it would delete the fixture's ability
-     * to see the lanes apart, which is the only thing that can catch one
-     * lane being counted twice.
-     */
-    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;
-    /**
-     * EVERY die the character has for this pool or skill, from every
-     * source -- gear, chrome, qualities, adept powers, metamagics, a
-     * metatype trait, a sustained spell.
-     *
-     * `only` names a narrowing an effect may carry ('haggle', 'silent',
-     * 'matrix-search'). `skill` lets a combat pool pick up dice that were
-     * declared against the SKILL being rolled rather than the pool --
-     * a smartlink says `firearms`, and the attack pool has to see it.
-     *
-     * The sources that have not yet moved onto the shared shape are added
-     * explicitly below, each named, so that migrating one is a matter of
-     * deleting its line here rather than hunting for what it fed.
-     */
-    bonus(kind: string, opts?: {
-        only?: string;
-        skill?: string;
-    }): number;
-    /**
-     * What a source adds to the initiative SCORE -- the number you roll
-     * against -- as opposed to `bonus('initiative')`, which is the DICE.
-     *
-     * The `initiative` effect arm has existed since the gear pass and
-     * was read by nothing at all until the Increase Reflexes spell came
-     * onto the lane (2026-09-04). Two different quantities sharing the
-     * word "initiative" is exactly why the arm is separate.
-     */
-    initiativeBonus(of: 'score' | 'dice'): number;
-    /** Every point on a LIMIT, from every source. */
-    limitBonus(kind: 'physical' | 'mental' | 'social' | 'accuracy', opts?: {
-        only?: string;
-    }): number;
-    /**
-     * How much further this character may raise one skill or attribute
-     * than anyone else -- Aptitude's chosen skill (p.72), Exceptional
-     * Attribute's chosen attribute (p.73-74).
-     *
-     * The book states absolute numbers against ITS ceilings (a skill at 7
-     * rather than 6 at creation, 13 rather than 12 after). This engine
-     * caps lower than the book does, so what carries across is the DELTA
-     * -- one step further than anyone else gets -- applied to whatever
-     * ceiling the engine is enforcing. Writing the book's 13 over a house
-     * cap of 7 would not be more faithful, only a bigger number in the
-     * wrong system.
-     *
-     * A `chosen` ceiling resolves through the holder's own pick, so a
-     * quality bought but never answered lifts nothing at all.
-     */
-    capBonus(of: 'skill' | 'attribute', name: string): number;
-    /**
-  
-  
-    /** A capability the character has, from any source, by key. */
-    can(key: string): boolean;
-    /**
-     * THE CHROME THAT ACTUALLY COUNTS: everything installed, minus the
-     * wired-reflex tiers a higher tier supersedes.
-     *
-     * Wired Reflexes I, II and III do not stack -- the best one wins (a
-     * synaptic booster is bioware and rides on top of whichever that is).
-     * That is a relationship BETWEEN rows, so no row can declare it and it
-     * has to live in code; it lives HERE, in the one place the resolver
-     * reads, rather than inside a getter, where only that getter would
-     * have been right and every other reader would have double-counted.
-     *
-     * The synaptic-vs-wired legality conflict remains the clinic's job.
-     */
-    private chromeThatCounts;
-    /**
-     * The chrome lane, by pool. A LANE READER, like gearBonus above.
-     *
-     * Every pool now reads `bonus()`, with exactly two deliberate
-     * exceptions, both in smartlinkTier and both commented there: that
-     * method asks which TIER of smartlink you have, implant or clip-on,
-     * and only the chrome lane can answer it.
-     */
-    augBonus(kind: AugBonusKind): number;
-    /** Installed qualities, by catalog key (kind 'quality'). */
-    qualities: Set<string>;
-    /**
-     * IS THIS SKILL OR ATTRIBUTE FORBIDDEN OUTRIGHT to this character?
-     *
-     * Reads the same lane every other rule reads, so a second quality
-     * (or a piece of chrome, or a metatype trait) that bars something
-     * needs no new reader. A `chosen` forbid resolves through the
-     * holder's pick, and where the pick names a skill GROUP the bar
-     * falls on every member -- which is what Incompetent actually is
-     * (p.81: "all skills in the skill group").
-     */
-    isForbidden(of: 'skill' | 'attribute', name: string): boolean;
-    /**
-     * Incompetent (p.81) names ONE skill group, and this is the only place
-     * that knows how to ask which. It was three separate reads of
-     * `hasQuality(`incompetent-${skill}`)` -- the slug convention -- and a
-     * fourth that counted slugs by prefix for notoriety. The quality is
-     * now 'incompetent' with a pick, and a legacy slug resolves to the
-     * same thing on load (qualities.ts LEGACY_CHOICE_KEYS), so this
-     * answers the same for an old save and a new one.
-     */
-    isIncompetentAt(skill: string): boolean;
-    hasQuality(key: string): boolean;
-    /**
-     * Records a quality and applies its one-time creation effect. Lucky is
-     * the only quality that edits an attribute (RAW raises the Edge ceiling;
-     * with no attribute point-buy here, the point lands directly).
-     */
-    /**
-     * WHAT THE HOLDER PICKED, per ROW that demands a pick (ICatalogChoice):
-     * slug -> the skill or attribute named.
-     *
-     * KEYED BY SLUG, NOT BY QUALITY (mjmcee, 2026-09-04). A Hardwire is an
-     * augmentation that gives +2 to a chosen skill and asks exactly the
-     * question Aptitude asks; a map that only qualities could reach would
-     * mean a second map for chrome and a third for spells. One map, one
-     * picker, one payload field.
-     */
-    picks: Map<string, string>;
-    /**
-     * The former name for `picks`, back when only qualities could ask.
-     * Kept as the SAME Map -- not a copy -- so a save written or read
-     * through the old name still lands in one place.
-     */
-    get qualityChoices(): Map<string, string>;
-    /** Rating per rated quality (qualities.ts maxRating); absent = 1. */
-    qualityRatings: Map<string, number>;
-    /** The rating held, 0 when the quality is not held; a flat quality reads 1. */
-    qualityRating(key: string): number;
-    addQuality(rawKey: string, rating?: number): void;
-    /**
-     * A quality that MOVES AN ATTRIBUTE does it once, here, at install.
-     *
-     * Unlike a dice effect -- which qualityBonus re-reads on every roll
-     * -- an attribute is a stored number, so it is edited rather than
-     * summed. Lucky (p.76) is the long-standing case: RAW it raises the
-     * Edge CEILING, and with no attribute point-buy here the point lands
-     * directly. It used to be an `if (key === 'lucky')` in addQuality;
-     * it is data now, which is what let Ugly and Doesn't Care (Cutting
-     * Aces p.152-153) arrive as data too instead of as a second `if`.
-     *
-     * The floor is 1: no quality reduces an attribute below the minimum
-     * a metahuman can have, and Ugly and Doesn't Care says so in as many
-     * words ("minimum 1").
-     */
-    private applyQualityAttributes;
-    /**
-     * The single tap every pool reads qualities through (cf. augBonus).
-     *
-     * DATA, NOT A SWITCH (2026-09-04). Every number below used to be a
-     * `case` here; each one now lives on its own quality in qualities.ts
-     * as an `effects` entry, in the same vocabulary gear and chrome
-     * already speak. A quality that adds dice therefore needs no edit to
-     * this method -- which is the property that matters, because the
-     * cost of the old shape was that the catalog could only ever print a
-     * quality's PROSE while its actual numbers lived somewhere a reader
-     * could not reach.
-     *
-     * `perception` and `social` mirror the augBonus kinds of the same
-     * names and are read at the same call sites, so a quality and a piece
-     * of chrome that do the same thing are added the same way.
-     *
-     * `sleaze` and `attack` are the two Matrix ACTIONS this engine names
-     * out loud -- hack.ts logs them as "Hack on the Fly (sleaze)" (p.240)
-     * and "Brute Force (attack)" (p.238), and mark.ts states that placing
-     * a mark IS one of those two. They exist because Codeslinger and
-     * Codeblock (p.72 / p.80) modify ONE chosen Matrix action rather than
-     * Matrix work in general, so a `hacking`-wide bonus would be a
-     * different quality wearing the name. In the DATA they are spelled
-     * `matrix-attack` / `matrix-sleaze`: EffectPool already spends the
-     * bare word `attack` on the COMBAT attack pool, and a quality that
-     * fired in a firefight because it shared a word with a Matrix action
-     * would be a bug nobody would look for.
-     */
-    qualityBonus(kind: 'sneak' | 'athletics' | 'matrix' | 'hacking' | 'piloting' | 'soak' | 'healing' | 'perception' | 'social' | 'sleaze' | 'attack' | 'leadership' | 'escape-artist' | 'biofeedback'): number;
-    /**
-     * Dice the QUALITIES add to one pool or skill. Deliberately its own
-     * summation rather than a source inside applyingEffects(): the pools
-     * are read as `augBonus(k) + qualityBonus(k)` at call sites that do
-     * NOT also add gearBonus(k), and folding qualities into the shared
-     * effect walk would have made every site that DOES add gearBonus
-     * count a quality twice, silently, in a number nobody prints.
-     */
-    /**
-     * How much further this character may raise one skill or attribute
-     * than anyone else -- Aptitude's chosen skill (p.72), Exceptional
-     * Attribute's chosen attribute (p.73-74).
-     *
-     * The book states absolute numbers against ITS ceilings (a skill at
-     * 7 rather than 6 at creation, 13 rather than 12 after). This engine
-     * caps lower than the book does, so what carries across is the DELTA
-     * -- one step further than anyone else gets -- applied to whatever
-     * ceiling the engine is enforcing. Writing the book's 13 over a house
-     * cap of 7 would not be more faithful, it would just be a bigger
-     * number in the wrong system.
-     */
-    qualityCap(of: 'skill' | 'attribute', name: string): number;
-    private sumQualityEffects;
-    private _firstImpressionUsed;
-    /** Spends the first impression: +2 for the social roll happening NOW. */
-    consumeFirstImpression(): number;
-    /** SINner tax (p.84-85): the cut every payout loses to having a file. */
-    get sinTaxRate(): number;
-    paralysisFreeze: boolean;
-    initiationGrade: number;
-    /** Metamagics (casters/adepts) and echoes (technomancers), by key. */
-    metamagics: Set<string>;
-    hasMetamagic(key: string): boolean;
-    /** Total karma EARNED in play -- spending it doesn't touch this. */
-    careerKarma: number;
-    private _notorietyReasons;
-    /** Records an incident once; false means this exact stain already stands. */
-    addNotoriety(reason: string): boolean;
-    get notorietyReasons(): readonly string[];
-    private _publicAwarenessReasons;
-    /**
-     * Records a Public Awareness incident once; false means this exact one
-     * already stands.
-     *
-     * A SEPARATE TRACK FROM NOTORIETY, BECAUSE CANON SEPARATES THEM. p.368
-     * lists what raises Public Awareness -- "leaving significant physical
-     * evidence", "being seen by many eyewitnesses", "fighting with law
-     * enforcement or some other High Threat Response team" -- and none of
-     * those are on the notoriety list, which is about how you treat the
-     * people you work with (betraying a Johnson, failing to honour a debt,
-     * excessive damage and fatalities).
-     *
-     * Routing a noisy run through addNotoriety would have been one line
-     * cheaper and would have stained the wrong record: notoriety is what
-     * the shadows think of your PROFESSIONALISM, and it eats street cred
-     * in socialRep. Being noticed by the public is not unprofessional.
-     *
-     * ADDITIVE TO THE DERIVED FLOOR, not a replacement. The engine already
-     * derived awareness from cred + notoriety, which models "a big name is
-     * a known face"; earned points sit on top rather than replacing it, so
-     * nothing that read publicAwareness before reads lower now.
-     */
-    addPublicAwareness(reason: string): boolean;
-    get publicAwarenessReasons(): readonly string[];
-    get streetCred(): number;
-    /** The p.368 quality list, restricted to the qualities this game ships. */
-    get qualityNotoriety(): number;
-    get notoriety(): number;
-    /**
-     * p.368: how well the media, the authorities and the public at large
-     * know your face. The derived floor (a big name is a known face) plus
-     * the incidents that actually put you on a feed -- see
-     * addPublicAwareness for why those are their own track.
-     */
-    get publicAwareness(): number;
-    /**
-     * The dice a NAME is worth in shadow-side social work (haggle,
-     * persuade): cred minus the stories that undercut it. RAW makes cred a
-     * social LIMIT bonus; with no limit system here, net-rep dice carry
-     * the same idea -- and notoriety eating cred keeps it self-balancing.
-     */
-    get socialRep(): number;
-    /** Explicit per-skill ratings; anything absent resolves via skillRating(). */
-    skills: Partial<Record<SkillName, number>>;
-    karma: number;
-    /**
-     * The effective rating for a skill: explicit rating if set; otherwise
-     * combat skills fall back to the legacy `combatSkill` attribute (which
-     * keeps every skill-less NPC seed rolling its historical pools), and
-     * everything else is 0 (unskilled).
-     */
-    skillRating(name: SkillName): number;
-    /**
-     * Which combat skill the current armament exercises: firearms for a
-     * drawn gun, blades for a drawn melee weapon, unarmed for empty hands
-     * (or anything holstered -- see weaponDrawn).
-     */
-    activeCombatSkill(): SkillName;
-    private initializeEquipment;
-    get name(): string;
-    /**
-     * Fires AFTER a room change has fully landed (spot cleared, rooms
-     * told, condition beat noted). Game hooks it to write the "move" save
-     * beat, so where you stand in the hub is what a resume restores.
-     * Distinct from onConditionChanged, which is the live-sheet lane and
-     * is gated off for anonymous/bench runners -- a save is not.
-     */
-    onRoomChanged?: (room: Room) => void;
-    get currentLocation(): Room;
-    set currentLocation(room: Room);
-    private _atSpot?;
-    get atSpot(): string | undefined;
-    set atSpot(v: string | undefined);
-    /**
-     * WHICH PAPER YOU CARRY (player request 2026-08-25, twice: "I should
-     * be able to see which sin I have active, and be able set it"). The
-     * name of the Fake SIN item you present at counters and checkpoints.
-     *
-     * undefined = let the house pick, which is the old behaviour and
-     * still the sane default: bestFakeSin() takes your highest rating.
-     * Setting it matters because rating is not the only axis -- a burned
-     * fake is gone, but a fake that has been READ at a venue is
-     * remembered there, so a runner may want to spend the cheap paper on
-     * a soft counter and keep the good one clean. See utilities/sin.ts.
-     */
-    activeSin?: string;
-    /**
-     * STEPPING (player request 2026-08-25, "move south 2"): the exact
-     * grid cell this actor stands in, when they have stepped somewhere
-     * that is not a named place. Normally undefined -- utilities/spots.ts
-     * derives a seat from `atSpot` instead, and that remains the rule for
-     * everyone who simply walked to the bar.
-     *
-     * This is the ONE place an actor owns coordinates, and it is a
-     * deliberate, narrow exception to the rule that `atSpot` is the whole
-     * of an actor's position: tactical stepping has destinations no spot
-     * name can express. `atSpot` still rides alongside it and still gates
-     * every interaction (it is set to whatever place the new cell is
-     * adjacent to, else the open floor), so talk/trade/melee/cover are
-     * unchanged. Cleared with `atSpot` on any room change, and by any
-     * "move to <spot>", which re-seats normally.
-     *
-     * NOT persisted: like the grid itself, it is transient geometry -- a
-     * reload puts you back on your spot's own seat.
-     *
-     * Accessor for the live dot map (2026-09-01) -- a cell step reports.
-     * Same-reference writes are the common no-op; a NEW object with equal
-     * coordinates still fires, which is harmless (one coalesced beat).
-     */
-    private _atCell?;
-    get atCell(): {
-        x: number;
-        y: number;
-        z: number;
-    } | undefined;
-    set atCell(v: {
-        x: number;
-        y: number;
-        z: number;
-    } | undefined);
-    /** The spot this actor was SEEDED at -- i.e. the fixture they work
-     *  (a bartender's bar, a shopkeeper's counter). Seating puts them on
-     *  the service side of it while everyone else stands in front (see
-     *  utilities/spots.ts seatingIn). Set once by scene-factory; never
-     *  changes when they move, because a bartender who steps away is
-     *  still the bartender. */
-    homeSpot?: string;
-    /**
-     * HOW FAR UP A CLIMB THIS ACTOR HAS BANKED, and toward what.
-     *
-     * SR5 p.134 climbs a wall over SUCCESSIVE tests -- each one's hits buy
-     * metres and you keep them. This engine used to demand the whole
-     * height in a single roll, which made a one-storey climb need six
-     * hits at once: measured at 4% for the best climber in the game and
-     * 0% for every archetype without the athletics skill.
-     *
-     * So a climb that falls short now HANGS THERE with its metres kept,
-     * and the next attempt continues from them. Cleared on arrival, on a
-     * fall, and whenever the actor ends up somewhere else -- banked
-     * progress belongs to one wall, and carrying it to another would let
-     * a player bank a metre here and cash it in across the room.
-     */
-    climbProgress?: {
-        target: string;
-        meters: number;
-    };
-    get inventory(): Inventory;
-    get equipment(): PlayerEquipment;
-    set equipment(newEquipment: PlayerEquipment);
-    private _carryCapOverrideKg?;
-    get maxCarryingWeight(): number;
-    set maxCarryingWeight(weight: number);
-    get currentWeight(): number;
-    addInventory(item: Item): void;
-    /** Where papers live (p.443): the commlink, else the deck -- the PAN's master. */
-    paperDevice(): Item | undefined;
-    /** Every device that can hold papers, commlinks first. */
-    paperDevices(): Item[];
-    /** Every paper on every device. */
-    papers(): Item[];
-    /** Files a paper on a device; a license links to the presented fake SIN (utilities/sin.ts resolves "presented"). */
-    filePaper(device: Item, paper: Item): void;
-    /** Burns a fake SIN: gone from its device, and every license linked to it goes with it (p.443). Returns the licenses lost. */
-    burnPaper(sin: Item): Item[];
-    /** Every paper in the pack files onto the carried device; returns how many moved. */
-    sweepPapersOntoDevice(): number;
-    /** The commlinks on this runner: worn on the head, or in the pack. */
-    commlinks(): Item[];
-    /** Where a data soft lives (p.441-442): the deck if there is one, else a commlink. */
-    softDevice(): Item | undefined;
-    /** A soft in the storage of any device on you -- a chip in the bag is not installed. */
-    hasSoft(key: string): boolean;
-    /**
-     * THE SOCIAL LIMIT (SR5 p.100-101): [(Charisma x 2) + Willpower + Essence]
-     * / 3, rounded up, with Essence rounded up first (p.95, p.100 -- the
-     * rounding rule is cited; the table row itself the RAG did not return,
-     * see rag-table-rows-missing). A Shopsoft adds one when buying or
-     * selling what it covers (p.442) -- see commands/haggle.ts.
-     */
-    get socialLimit(): number;
-    /** Every program chip in the pack installs into the carried deck; returns how many chips were consumed. */
-    sweepProgramChipsIntoDeck(): number;
-    removeInventory(item: Item): boolean;
-    equip(item: Item): string;
-    /** The word a player would use for a slot -- never the key ("body armor", not "torso.armorVest"). */
-    private static readonly SLOT_WORDS;
-    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)
-     * except where the name has to -- a trode net is Electronics like a
-     * flashlight, and the flashlight has no slot. Kit devices (a deck, a
-     * drone, uninstalled 'ware) answer null: they are carried, not worn.
-     */
-    slotForItem(item: Item): {
-        group: keyof PlayerEquipment;
-        slot: string;
-    } | null;
-    /** Everything in the bag that has a slot and is not in it -- armor left in the pack (a real save: Armor Clothing carried, nothing worn). */
-    wearablesInBag(): Item[];
-    determineEquipmentSlot(input: string): {
-        group: keyof PlayerEquipment;
-        slot: string;
-    } | null;
-    canEquip(item: Item): boolean;
-    private unequipBySlot;
-    hear(actor: Player, message: string, opts?: {
-        viaLink?: boolean;
-        broadcast?: boolean;
-    }): void | Promise<void>;
-    see(actor: Player, verb: string, details?: string): void | Promise<void>;
-    performAction(verb: string, details?: string): void;
-    readonly _onSeenAction: ({ actor, verb, details }: {
-        actor: Player;
-        verb: string;
-        details?: string;
-    }) => void;
-    readonly visitedRooms: Set<string>;
-    enterRoom(room: Room): void;
-    leaveRoom(): void;
-    private static readonly ARMOR_CATEGORIES;
-    get maxConditionBoxes(): number;
-    get damageTaken(): number;
-    get maxStunBoxes(): number;
-    get stunTaken(): number;
-    /**
-     * SR5 wound modifier: -1 die on every pool per 3 full boxes of damage,
-     * and the two tracks STACK -- being shot and drained both make you worse
-     * at everything, including not getting shot.
-     */
-    get woundModifier(): number;
-    /** Dead: the physical track is full. */
-    isDown(): boolean;
-    /** Out cold: the stun track is full (but not necessarily dead). */
-    isUnconscious(): boolean;
-    /** Out of the fight either way -- the gate every action should check. */
-    isIncapacitated(): boolean;
-    /**
-     * FIRST AID, once per set of wounds (SR5 p.205). Set by
-     * utilities/first-aid.ts; cleared below the moment fresh damage lands,
-     * because new damage IS a new set of wounds -- that clearing is the
-     * whole definition of "set of wounds" in an engine with no clock to
-     * measure p.205's one-hour window with.
-     */
-    firstAidGiven: boolean;
-    /**
-     * "First Aid may not be applied if the character has been magically
-     * healed" (p.205). Set by cast.ts's heal, cleared with the above.
-     */
-    magicallyHealed: boolean;
-    /** Applies damage boxes; returns the number actually taken. */
-    /**
-     * THE LIVE-SHEET HOOK (2026-09-01): Game sets this on the PRIMARY
-     * player only -- never NPCs, never crew shells -- and every condition
-     * mutator below fires it. The handler is fire-and-forget (the web
-     * sheet's realtime overlay); a throw in it must never sour a damage
-     * roll, so it is guarded where it is invoked.
-     */
-    onConditionChanged?: () => void;
-    /** PUBLIC so state that lives on ITEMS (a deck's program list) can
-     *  report through the owning player -- deck.ts load/unload calls it.
-     *  Guarded here once: reporting never wounds. */
-    noteConditionChanged(): void;
-    takeDamage(boxes: number): number;
-    /** A fresh injury opens a fresh set of wounds: first aid is available
-     *  again, and whatever the mana did is now last wound's business. */
-    private clearWoundSet;
-    /**
-     * Clears damage boxes; returns how many were actually healed (can be
-     * less than asked when the track is nearly clean). Healing also restores
-     * wound-modifier dice, since that's derived from damageTaken.
-     */
-    healDamage(boxes: number): number;
-    /**
-     * Applies stun boxes; anything past a full stun track OVERFLOWS into the
-     * physical track (SR's rule -- enough drain doesn't just knock you out,
-     * it starts killing you). Returns what landed where.
-     */
-    takeStun(boxes: number): {
-        stun: number;
-        overflow: number;
-    };
-    /** e.g. "■■■□□□□□□□ (3/10)" */
-    conditionSummary(): string;
-    /**
-     * Clears stun boxes; returns how many were actually recovered. FATIGUE
-     * boxes (see lockedFatigue) are untouchable until their need is met --
-     * SR5e p.172: fatigue damage cannot be healed while the condition
-     * causing it still exists. Eating/sleeping unlocks them (markFed /
-     * markSlept), after which they heal like any stun.
-     */
-    healStun(boxes: number): number;
-    /** The stun track, same rendering as conditionSummary(). */
-    stunSummary(): string;
-    /**
-     * The weapon actually in hand (right hand first, then left), or bare
-     * fists. Damage value and the attack-pool bonus both come off the item's
-     * quality rating -- gear is the whole progression system in this game,
-     * so it has to be what combat power flows from.
-     */
-    getWeaponProfile(): {
-        name: string;
-        damage: number;
-        poolBonus: number;
-        armorPen?: number;
-    };
-    /** The weapon riding in a hand slot, drawn or holstered. */
-    getCarriedWeapon(): Item | null;
-    /** Draws the carried weapon; returns it, or null if nothing changed
-     * (unarmed, or already in hand). */
-    drawWeapon(): Item | null;
-    /** Stows the drawn weapon; returns it, or null if nothing changed. */
-    stowWeapon(): Item | null;
-    /** Total soak dice from every equipped armor-category item. */
-    getArmorValue(): number;
-    /**
-     * ARMOR DOES NOT STACK (SR5 p.169, RAG-checked 2026-09-02): "only the
-     * highest Armor rating applies; all other pieces only add bulk". A helmet
-     * or shield is a "+" accessory and adds to that one piece (p.438). The
-     * old sum let a vest under a coat out-armor either -- the same deviation
-     * the trim rule below already closed for boots and gloves. `ignored` is
-     * what the player is wearing for nothing, so the panel can say so.
-     */
-    armorBreakdown(): {
-        total: number;
-        piece: Item | null;
-        extras: {
-            item: Item;
-            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
-     * fist -- Agility + unarmed (never the drawn weapon's skill or bonus).
-     * See subdue.ts.
-     */
-    getUnarmedAttackPool(): number;
-    getDefensePool(): number;
-    getSoakPool(): number;
-    /**
-     * THE INITIATIVE ATTRIBUTE -- what the dice are added TO (p.159,
-     * p.474). Per plane: Reaction + Intuition on the meat side (and in
-     * AR, which is the same line), Data Processing + Intuition in VR
-     * (p.229-230), Intuition x 2 astral (p.314).
-     *
-     * Plus the AR edge from an equipped, ONLINE commlink -- the tactical
-     * overlay feeding you angles. Running silent kills the overlay along
-     * with the broadcast, so going dark costs you speed on the draw: the
-     * silent tradeoff grows teeth. Wounds slow you like everything else.
-     *
-     * SPLIT FROM THE DICE COUNT (getInitiativeDice) because SR5 keeps
-     * them apart and the engine used to not: everything was piled into
-     * one number and rolled as a hit-counting pool. The old name
-     * `getInitiativePool` is gone rather than kept as an alias, so the
-     * compiler names every caller that still thinks initiative is a pool.
-     */
-    /** Meters already crossed this Combat Turn. Reset by beginExchange. */
-    movedMetersThisTurn: number;
-    /** Extra meters bought by a Sprint this turn (see sprintMeters). */
-    sprintMetersThisTurn: number;
-    /** p.161: Agility x 2. Past this you are RUNNING for the rest of the turn. */
-    get walkRateMeters(): number;
-    /** p.161: Agility x 4, before any Sprint. */
-    get runRateMeters(): number;
-    /** Everything you may still cross this Combat Turn. */
-    get movementLeftMeters(): number;
-    /**
-     * RUNNING IS A STATE, NOT A CHOICE (p.161-162): "as soon as a
-     * character exceeds their Walk Rate they are considered Running until
-     * the end of the Combat Turn", and running costs -2 dice on everything
-     * except the Sprint test itself.
-     *
-     * This is what gives the walk/run split teeth. Without it the two
-     * rates would be a distinction with no consequence -- a number the
-     * engine tracked and nothing ever read.
-     */
-    get isRunningThisTurn(): boolean;
-    /** -2 while running, else 0 (p.162 Running Modifiers). */
-    get runningPenalty(): number;
-    /** A fresh Combat Turn: the whole rate comes back, sprint included. */
-    resetMovementTurn(): void;
-    /**
-     * METERS PER SPRINT HIT.
-     *
-     * Canon splits this by metatype: +2m per hit for humans, elves and
-     * orks, +1m for dwarfs and trolls (p.162).
-     *
-     * THIS ENGINE HAS NO METATYPES -- checked, not assumed: there is no
-     * metatype field on Player, none in the player seed, none in chargen,
-     * and no dwarf/troll/elf/ork anywhere outside item prose. Every
-     * character it can currently represent is a human-baseline one, so the
-     * human value is not a shortcut here, it is the only row of that table
-     * this engine has a character for.
-     *
-     * Inventing a metatype to carry one modifier would be the tail wagging
-     * the dog: metatype in SR5 sets attribute maxima, racial bonuses and
-     * chargen priorities, and adding a half-real one so Sprint could
-     * consult it would put a lie in the character model to decorate a
-     * movement rule. When metatypes land, this constant is the one line
-     * that has to become a lookup.
-     */
-    static readonly SPRINT_METERS_PER_HIT = 2;
-    getInitiativeAttribute(): number;
-    /**
-     * HOW MANY D6 THE INITIATIVE TEST ROLLS (p.159 chart, p.474).
-     *
-     * Everyone starts at 1D6. Augmentations add dice -- wired reflexes I
-     * and II are literally "+1 / +2 initiative dice" in their own text,
-     * which the engine already said and then spent as pool dice instead.
-     * The other planes REPLACE the base rather than adding to it:
-     *
-     *   AR / meat   1D6 + augs      (p.474)
-     *   cold-sim    3D6             (p.229-230, p.231 user modes)
-     *   hot-sim     4D6, +1 echo    (p.230; Overclocking p.258)
-     *   rigging VR  3D6 cold / 4D6 hot (p.266)
-     *   astral      3D6             (p.159 chart 2D6 base + 1; p.314)
-     *
-     * Chrome does not follow you out of your body: wired reflexes are
-     * body speed, and VR/astral initiative is not the body's. That is why
-     * augBonus('initiative') rides only the meat line -- the same place
-     * the old code had it.
-     *
-     * The 5D6 ceiling is enforced in rollInitiativeScore, not here, so
-     * every source obeys it without each one remembering to.
-     */
-    getInitiativeDice(): number;
-    /**
-     * If an edge boost is armed (see commands/edge.ts), consume it: returns
-     * the bonus dice for the strike being rolled right now and disarms.
-     * Called by the strike-profile builders, so the boost lands on the next
-     * attack/subdue/manabolt this actor initiates.
-     */
-    consumeEdgeBoost(): number;
-    lifestyleEdgeBonus: number;
-    ateThisCycle: boolean;
-    sleptThisCycle: boolean;
-    hungerStreak: number;
-    sleepStreak: number;
-    private _hungerFatigue;
-    private _sleepFatigue;
-    /** Stun boxes no recovery can touch until their need is met. */
-    get lockedFatigue(): number;
-    get hungerFatigue(): number;
-    get sleepFatigue(): number;
-    /** A real meal: hunger resets and hunger-fatigue unlocks (heals normally now). */
-    markFed(): void;
-    /** A real sleep (a bed, not a jobsite corner): sleep debt resets and unlocks. */
-    markSlept(): void;
-    /** Records freshly-taken stun as need-locked fatigue. */
-    addLockedFatigue(kind: 'hunger' | 'sleep', boxes: number): void;
-    /**
-     * New job bookkeeping -- the boost and the once-per-job haggle always
-     * reset, but the edge POOL only refills when the runner left fed and
-     * slept (SR5e p.56: a fulfilling meal and a good night's sleep).
-     */
-    refreshEdge(wellRested?: boolean): void;
-    /** Base casting dice for a mundane casting from a formula/grimoire. */
-    private static readonly BASE_MAGIC_POOL;
-    /** Awakened: innate talent, no gear required. Adepts count -- their
-     * aura burns like any mage's, and assensing works -- but they channel
-     * magic into the body, not spells (see knowsSpell/isCaster). */
-    /**
-     * HOW MANY POWER POINTS THIS CHARACTER ACTUALLY HAS.
-     *
-     * A full adept gets points equal to their Magic, free (SR5 p.69), so
-     * for them this IS `magic` -- which is why the engine's long-standing
-     * `floor(magic / 2)` adept bonus was already, unknowingly, a Power
-     * Point formula. A mystic adept BUYS theirs, so for them it is what
-     * they bought.
-     *
-     * Reading the bonus off this one number rather than off the boolean is
-     * what let the mystic adept exist without moving a single existing
-     * character: for every adept in play, `magic` and `effectivePowerPoints`
-     * are the same value, so `floor(pp / 2)` returns exactly what
-     * `floor(magic / 2)` returned.
-     */
-    get effectivePowerPoints(): number;
-    /**
-     * A MYSTIC ADEPT: full magic, bought powers, and no astral projection.
-     *
-     * Not a flag of its own, because it does not need one -- buying power
-     * points while not being a full adept IS the condition, and a mystic
-     * adept who bought none is mechanically a magician, which is also what
-     * canon says they would be.
-     */
-    get isMysticAdept(): boolean;
-    /**
-     * Magic-as-muscle: half the character's Power Points ride every
-     * meat-plane pool (SR5's adept powers, compressed to one number the
-     * way this engine compresses every other gear/aug bonus).
-     *
-     * `withMetamagic` is false for the defence-sense site, which never
-     * counted the Power Point metamagic and still should not -- that
-     * initiation buys a point of magic-as-muscle for striking, and
-     * widening it here would be a silent buff riding in on a refactor.
-     */
-    adeptPoolBonus(withMetamagic?: boolean): number;
-    /**
-     * UN-COMPRESSING THE ADEPT (SR5 p.308-310). A character who CHOSE powers
-     * (`adeptPowers` present) gets each power's own effect and NOT the
-     * compressed floor(pp/2); one who never chose (undefined -- every save
-     * from before selection) keeps the compressed bonus exactly. The two
-     * models never stack, which is the double-count this split had to avoid.
-     *
-     * Attack dice come from Improved Ability (Combat); defence dice from
-     * Combat Sense. The Power Point metamagic stays what it always was --
-     * a point of magic-as-muscle on the STRIKING side only.
-     */
-    /**
-     * The COMPRESSED adept's flat bonus, or zero for anyone who chose
-     * powers. Split out of adeptAttackBonus so the combat pools can read
-     * `bonus()` for every other source without counting the chosen powers
-     * twice -- they arrive through the adept lane, and this is the only
-     * part of the adept that never became data.
-     */
-    private adeptCompressedBonus;
-    adeptAttackBonus(): number;
-    adeptDefenseBonus(): number;
-    /** Mystic Armor (p.309): +1 Armor per level. Zero under the compressed
-     *  model -- the flat pool bonus never granted armor, so none is owed. */
-    adeptArmorBonus(): number;
-    /** Improved Reflexes (p.309): the initiative dice it adds. Zero under
-     *  the compressed model. */
-    adeptReactionBonus(): number;
-    /** Killing Hands (p.309): unarmed strikes deal PHYSICAL damage. */
-    hasKillingHands(): boolean;
-    isAwakened(): boolean;
-    /** Technomancer: living persona -- the Matrix without a deck (see ICombatAttributes.resonance). */
-    /**
-     * THE ASPECTED MAGICIAN (SR5 p.69): one magical group, astral
-     * perception but no projection. Adepts and mystic adepts cannot be
-     * aspected (the factory refuses the combination); a burned-out aspect
-     * is simply not Awakened.
-     */
-    get isAspected(): boolean;
-    /** Sorcery -- spellcasting, counterspelling, sustaining: full magicians and Sorcerers. */
-    canWorkSorcery(): boolean;
-    /** Conjuring -- summoning, binding, banishing: full magicians and Conjurers. */
-    canConjure(): boolean;
-    /** Astral projection: full magicians only (p.69: aspected "cannot astrally project"). */
-    canProject(): boolean;
-    isTechnomancer(): boolean;
-    private _sustainedArmor;
-    get sustainedArmor(): number;
-    setSustainedArmor(bonus: number): void;
-    /**
-     * REST BREAKS CONCENTRATION (yZSAdPAvwMpzjnTaM; SR5 p.251: "You
-     * can't sustain Complex Forms when you're unconscious", and a
-     * sustained spell asks the same of its caster). Closing your eyes to
-     * sleep drops EVERY working this character is personally holding --
-     * forms, spells, barriers, all six sustains in one sweep, because
-     * fixing rest for the one kind the report named would leave a mage's
-     * armor humming through the night the way the thread used to.
-     *
-     * A form a SPRITE sustains is untouched by design: the sprite took
-     * the task precisely so it holds while the technomancer does not
-     * (p.256, commands/sustain.ts) -- the sprite doesn't sleep.
-     *
-     * Returns how many workings dropped, so rest can say so once.
-     */
-    /**
-     * Everything currently HELD, by name -- the live sheet's `sustained`
-     * field (contract 2026-09-01). Composed at read time from the named
-     * sustain fields, so no sustain site needs a hook: the list rides the
-     * next report, which in a fight is seconds away. Empty = actively
-     * holding nothing.
-     */
-    sustainedNames(): string[];
-    releaseSustainedWorkings(): number;
-    private _sustainedInvisibility;
-    get sustainedInvisibility(): boolean;
-    set sustainedInvisibility(v: boolean);
-    private _sustainedReflexes;
-    get sustainedReflexes(): boolean;
-    set sustainedReflexes(v: boolean);
-    /** The sustained PHYSICAL BARRIER spell (ruling 2026-08-24): seals
-     *  one exit of one room while held -- go.ts and move refuse passage
-     *  for everyone (the caster included; walls don't play favorites).
-     *  Session-only, like every sustain. */
-    private _sustainedBarrier?;
-    get sustainedBarrier(): {
-        roomName: string;
-        direction: string;
-        force: number;
-    } | undefined;
-    set sustainedBarrier(v: {
-        roomName: string;
-        direction: string;
-        force: number;
-    } | undefined);
-    /** The MANA BARRIER twin (canon p.294, RAG-checked): blocks SPIRITS
-     *  and astral forms at the sealed exit; living mundanes and physical
-     *  objects pass freely. Same lifecycle as sustainedBarrier. */
-    private _sustainedManaBarrier?;
-    get sustainedManaBarrier(): {
-        roomName: string;
-        direction: string;
-        force: number;
-    } | undefined;
-    set sustainedManaBarrier(v: {
-        roomName: string;
-        direction: string;
-        force: number;
-    } | undefined);
-    /** `hits` is the original threading test's hits -- the number Kill
-     *  Complex Form (p.250) eats away at. Optional so a form woven by
-     *  anything that predates that bookkeeping still reads sanely;
-     *  unravel.ts falls back to the Level. */
-    private _sustainedForms;
-    /** Sustained complex forms. Writers push/splice it directly (sustain.ts,
-     *  thread.ts, game.ts), so the array itself is observed: every element
-     *  write fires the beat, and assigning a fresh array re-wraps it. */
-    get sustainedForms(): {
-        key: string;
-        level: number;
-        hits?: number;
-    }[];
-    set sustainedForms(v: {
-        key: string;
-        level: number;
-        hits?: number;
-    }[]);
-    private observedForms;
-    /** Diagnostics: +2 to matrix action pools while sustained. */
-    get formMatrixBonus(): number;
-    /** Static Veil: +2 to matrix defense while sustained. */
-    get formDefenseBonus(): number;
-    /** The Force each sustained spell was cast at (cast.ts records it) -- Focused Concentration reads it. */
-    sustainedForces: Map<"armor" | "invisibility" | "reflexes", number>;
-    noteSustainedForce(kind: 'armor' | 'invisibility' | 'reflexes', force: number): void;
-    /** GREMLINS (p.81): the 1s a glitch needs, one fewer per rating, on external equipment -- the deck. */
-    get deckGremlins(): number;
-    get sustainingPenalty(): number;
-    private _astralPerceiving;
-    /** Assensing (SR5 p.312): the live sheet shows it, so a change is a
-     *  condition beat. Accessor pair -- every writer compiles unchanged. */
-    get astralPerceiving(): boolean;
-    set astralPerceiving(v: boolean);
-    sneaking: boolean;
-    riggedDrone?: Item;
-    /** 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;
-    haggledThisJob: boolean;
-    liquidCourage: boolean;
-    /** Spends the drink: returns its bonus die for the roll happening NOW. */
-    consumeLiquidCourage(): number;
-    cameFrom?: {
-        room: string;
-        back: string;
-    };
-    socialMarks: Set<string>;
-    /** The best Focus item on this actor, if any -- by Force (catalog v13: ratingValue). */
-    getBestFocus(): Item | undefined;
-    getMagicPool(): number;
-    /**
-     * A magician/mystic adept knows the spells in their CHOSEN spellbook
-     * (SR5 p.300, up to Magic x 2, picked at creation). A carried grimoire or
-     * the spell's formula teaches beyond it, as it does a mundane.
-     *
-     * GRANDFATHERED: `knownSpells === undefined` means "knows every spell" --
-     * the pre-selection behaviour, so any save from before spell selection,
-     * and any character the web never sent a spellbook for, keeps casting
-     * anything. Only a chosen list narrows them to it.
-     */
-    knowsSpell(spellName: string): boolean;
-    /**
-     * The gate for attempting magic at all (ward bypass included): innate
-     * talent, or any magic gear.
-     */
-    isCaster(): boolean;
-    get lifestyleChoices(): LifestyleChoices;
-    set lifestyleChoices(choices: LifestyleChoices);
-    get currency(): number;
-    set currency(amount: number);
-    adjustCurrency(delta: number): void;
-}