@maka/maka-cli 5.120.0 → 5.122.0

package/bundle/typescript/src/commands/game/sideQuest/headless-harness.d.ts

@@ -100,3 +100,20 @@ export interface BootOptions {
  * and off telemetry, which is most of what made this expensive before.
  */
 export declare function bootSession(opts?: BootOptions): Promise<HeadlessSession>;
+/**
+ * PUT MARKS ON THE HOST A PERSONA IS STANDING UNDER -- test setup, not a
+ * game move.
+ *
+ * Needed from 2026-09-03 (uMQAhaAysgaKpWFkn), when placing a mark became
+ * the OPPOSED test the book describes. Until then a fixture could pin
+ * Math.random to 0.99 and be certain a setup `hack` landed, because only
+ * one side rolled. Now both sides do, so "every die is a 6" makes the
+ * HOST roll perfectly too and the setup step became a coin toss that
+ * usually lost.
+ *
+ * A test that only needs a persona INSIDE a host should not be spending
+ * a dice roll to get there -- that made the roll's outcome a silent
+ * precondition of assertions about something else entirely. This states
+ * the precondition instead.
+ */
+export declare function markHostOver(session: HeadlessSession, actorName: string, marks?: number): void;

package/bundle/typescript/src/commands/game/sideQuest/headless-harness.js

@@ -1,5 +1,5 @@
 import { createHeadlessSession } from './headless.js';
-import { getArchetype } from './archetypes.js';
+import { getArchetype, archetypeGearDefs } from './archetypes.js';
 import { Size, Category, Rating } from './types/shared/item-enum.js';
 /**
  * STANDING UP A REAL HEADLESS BOOT, cheaply.
@@ -138,7 +138,7 @@ function enumKeyFor(enumObj, value) {
 export function saveForArchetype(name, archetypeName) {
     const a = getArchetype(archetypeName);
     const { skills, ...attrs } = a.combat;
-    const inventory = (a.gear ?? []).map(def => ({
+    const inventory = archetypeGearDefs(a).map(def => ({
         name: def.name,
         description: def.description,
         size: enumKeyFor(Size, def.size),
@@ -259,4 +259,32 @@ export async function bootSession(opts = {}) {
     }
     return session;
 }
+/**
+ * PUT MARKS ON THE HOST A PERSONA IS STANDING UNDER -- test setup, not a
+ * game move.
+ *
+ * Needed from 2026-09-03 (uMQAhaAysgaKpWFkn), when placing a mark became
+ * the OPPOSED test the book describes. Until then a fixture could pin
+ * Math.random to 0.99 and be certain a setup `hack` landed, because only
+ * one side rolled. Now both sides do, so "every die is a 6" makes the
+ * HOST roll perfectly too and the setup step became a coin toss that
+ * usually lost.
+ *
+ * A test that only needs a persona INSIDE a host should not be spending
+ * a dice roll to get there -- that made the roll's outcome a silent
+ * precondition of assertions about something else entirely. This states
+ * the precondition instead.
+ */
+export function markHostOver(session, actorName, marks = 1) {
+    const scene = session.game.scene;
+    const actor = scene.getPlayerByName(actorName);
+    if (!actor)
+        throw new Error(`markHostOver: no actor called ${actorName}`);
+    const rooms = Object.values(scene.getRooms());
+    const here = actor.currentLocation.name;
+    const host = rooms.find(r => r.hasNode && r.name === here) ?? rooms.find(r => r.hasNode);
+    if (!host)
+        throw new Error('markHostOver: this scene has no host');
+    host.hostMarksBy.set(actorName, marks);
+}
 //# sourceMappingURL=headless-harness.js.map

package/bundle/typescript/src/commands/game/sideQuest/headless-harness.js.map

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

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

@@ -21,6 +21,12 @@ export interface IDeviceConfig {
      *  see DEFAULT_DEVICE_RATING. Meaningless on a 'ward', which is not
      *  electronics at all. */
     rating?: number;
+    /** BARRIER RATINGS (p.197-198): Structure (the condition monitor) and
+     *  Armor (what it soaks with). Omitted takes barrierDefaultsFor(). */
+    structure?: number;
+    armor?: number;
+    /** The seed's footprint, only to pick the barrier default tier. */
+    footprint?: 'small' | 'medium' | 'large';
     /** Wireless mode. Defaults on for electronics, and is always off on a
      *  'ward'. A device with its wireless off has no icon to find and
      *  nothing to reach from the grid. */
@@ -38,6 +44,36 @@ export interface IDeviceConfig {
  * be a device", not "everything in the room is".
  */
 export declare const DEFAULT_DEVICE_RATING: Partial<Record<DeviceKind, number>>;
+/**
+ * THE BOOK'S BARRIER TIERS (p.197 Barrier Ratings, RAG-checked 2026-09-03):
+ * Structure / Armor. Fragile is standard glass; Reinforced is a security
+ * door, armored glass, Kevlar wallboard; Heavy is concrete or a metal
+ * beam. A device seed that says neither gets Reinforced -- the ordinary
+ * locked door -- or Heavy when its footprint is large. A ward is the Art
+ * and has no Structure to shoot.
+ */
+export declare const BARRIER_TIERS: {
+    readonly fragile: {
+        readonly structure: 1;
+        readonly armor: 2;
+    };
+    readonly reinforced: {
+        readonly structure: 8;
+        readonly armor: 12;
+    };
+    readonly heavy: {
+        readonly structure: 12;
+        readonly armor: 20;
+    };
+};
+export declare function barrierDefaultsFor(kind: DeviceKind, footprint?: 'small' | 'medium' | 'large'): {
+    structure: number;
+    armor: number;
+};
+/** A seed's rating, kept to the range the book uses (1-12, the same
+ *  clamp as Host.clampRating) so a typo cannot make a lock impossible
+ *  or free. */
+export declare function clampDeviceRating(rating: number): number;
 /**
  * A DEVICE: a thing in a room that is shut and can be opened.
  *
@@ -81,6 +117,20 @@ export declare class Device {
     grantsItem?: Item;
     atSpot?: string;
     opensExit?: string;
+    /**
+     * MARKS ON THIS DEVICE, placer -> count (max 3, p.236).
+     *
+     * A SLAVED DEVICE IS ITS OWN ICON (Data Trails p.87-88, and the
+     * reason uMQAhaAysgaKpWFkn decomposes): a decker already standing
+     * inside a host still rolls Hacking + Logic [Sleaze] versus this
+     * device's OWN DR + Firewall to get a mark on it, and only then can
+     * a Control Device action work it. Owning the host is not owning
+     * the door.
+     *
+     * Session state, like every other mark ledger -- a persona reboot
+     * clears what it placed (utilities/marks.ts).
+     */
+    marksBy: Map<string, number>;
     openMessage: string;
     refuseMessage: string;
     /** The whole of this device's state. */
@@ -98,8 +148,43 @@ export declare class Device {
      */
     rating: number;
     wireless: boolean;
+    /**
+     * WHAT IT IS MADE OF (p.197-198): Structure is the condition monitor
+     * shooting it fills, Armor is what it soaks with. Reaching Structure
+     * makes a hole big enough to be a way through -- the barrier opens,
+     * with the same finality as a bricked deck. utilities/barrier-combat.ts
+     * is the only writer.
+     */
+    readonly structure: number;
+    readonly armor: number;
+    private _barrierDamage;
+    /**
+     * THE LOCKSMITH EXTENDED TEST IN PROGRESS (p.48, p.359-360): picking a
+     * maglock by hand accumulates hits toward Rating x 2 across attempts,
+     * one die fewer each time. Every `pick` is one interval of the same
+     * test, so the running total lives on the lock. One worker at a time:
+     * a different actor starting over resets it. Cleared when the device
+     * opens. Session-only -- a lock half-picked when you quit is a lock.
+     */
+    private _pickProgress?;
     constructor(config: IDeviceConfig);
     isOpen(): boolean;
+    /** The running test for this actor -- fresh when nobody, or somebody else, was working it. */
+    pickProgressFor(actorName: string): {
+        actorName: string;
+        hits: number;
+        attempts: number;
+    };
+    resetPickProgress(): void;
+    /** The hits a hand-pick needs in total: Rating x 2 (p.359-360). */
+    get pickThreshold(): number;
+    get barrierDamage(): number;
+    /** Boxes actually taken; a ward has nothing to fill. */
+    takeBarrierDamage(boxes: number): number;
+    /** Damage has reached Structure: there is a hole where the barrier was. */
+    get isHoled(): boolean;
+    /** "Structure 8 / Armor 12, 3/8" -- the panel's line. */
+    barrierSummary(): string;
     /**
      * IS THERE AN ICON HERE TO FIND? Wireless mode on, and a rating that
      * means it is electronics at all.
@@ -175,5 +260,6 @@ export declare class Device {
     /** Persistence-only: one flag in, nothing out. */
     restoreState(state: {
         open: boolean;
+        damage?: number;
     }): void;
 }

package/bundle/typescript/src/commands/game/sideQuest/models/device.js

@@ -16,6 +16,32 @@ export const DEFAULT_DEVICE_RATING = {
     lock: 2,
     panel: 2,
 };
+/**
+ * THE BOOK'S BARRIER TIERS (p.197 Barrier Ratings, RAG-checked 2026-09-03):
+ * Structure / Armor. Fragile is standard glass; Reinforced is a security
+ * door, armored glass, Kevlar wallboard; Heavy is concrete or a metal
+ * beam. A device seed that says neither gets Reinforced -- the ordinary
+ * locked door -- or Heavy when its footprint is large. A ward is the Art
+ * and has no Structure to shoot.
+ */
+export const BARRIER_TIERS = {
+    fragile: { structure: 1, armor: 2 },
+    reinforced: { structure: 8, armor: 12 },
+    heavy: { structure: 12, armor: 20 },
+};
+export function barrierDefaultsFor(kind, footprint) {
+    if (kind === 'ward')
+        return { structure: 0, armor: 0 };
+    return footprint === 'large' ? BARRIER_TIERS.heavy : BARRIER_TIERS.reinforced;
+}
+/** A seed's rating, kept to the range the book uses (1-12, the same
+ *  clamp as Host.clampRating) so a typo cannot make a lock impossible
+ *  or free. */
+export function clampDeviceRating(rating) {
+    if (!Number.isFinite(rating))
+        return 1;
+    return Math.max(1, Math.min(12, Math.floor(rating)));
+}
 /**
  * A DEVICE: a thing in a room that is shut and can be opened.
  *
@@ -59,6 +85,20 @@ export class Device {
     grantsItem;
     atSpot;
     opensExit;
+    /**
+     * MARKS ON THIS DEVICE, placer -> count (max 3, p.236).
+     *
+     * A SLAVED DEVICE IS ITS OWN ICON (Data Trails p.87-88, and the
+     * reason uMQAhaAysgaKpWFkn decomposes): a decker already standing
+     * inside a host still rolls Hacking + Logic [Sleaze] versus this
+     * device's OWN DR + Firewall to get a mark on it, and only then can
+     * a Control Device action work it. Owning the host is not owning
+     * the door.
+     *
+     * Session state, like every other mark ledger -- a persona reboot
+     * clears what it placed (utilities/marks.ts).
+     */
+    marksBy = new Map();
     openMessage;
     refuseMessage;
     /** The whole of this device's state. */
@@ -76,6 +116,25 @@ export class Device {
      */
     rating;
     wireless;
+    /**
+     * WHAT IT IS MADE OF (p.197-198): Structure is the condition monitor
+     * shooting it fills, Armor is what it soaks with. Reaching Structure
+     * makes a hole big enough to be a way through -- the barrier opens,
+     * with the same finality as a bricked deck. utilities/barrier-combat.ts
+     * is the only writer.
+     */
+    structure;
+    armor;
+    _barrierDamage = 0;
+    /**
+     * THE LOCKSMITH EXTENDED TEST IN PROGRESS (p.48, p.359-360): picking a
+     * maglock by hand accumulates hits toward Rating x 2 across attempts,
+     * one die fewer each time. Every `pick` is one interval of the same
+     * test, so the running total lives on the lock. One worker at a time:
+     * a different actor starting over resets it. Cleared when the device
+     * opens. Session-only -- a lock half-picked when you quit is a lock.
+     */
+    _pickProgress;
     constructor(config) {
         this.kind = config.kind;
         this.name = config.name;
@@ -89,7 +148,10 @@ export class Device {
         this.opensExit = config.opensExit;
         this.openMessage = config.openMessage || 'It opens.';
         this.refuseMessage = config.refuseMessage || `Nothing happens.`;
-        this.rating = config.rating ?? DEFAULT_DEVICE_RATING[config.kind] ?? 0;
+        this.rating = config.rating !== undefined ? clampDeviceRating(config.rating) : DEFAULT_DEVICE_RATING[config.kind] ?? 0;
+        const tier = barrierDefaultsFor(config.kind, config.footprint);
+        this.structure = config.kind === 'ward' ? 0 : Math.max(0, Math.floor(config.structure ?? tier.structure));
+        this.armor = config.kind === 'ward' ? 0 : Math.max(0, Math.floor(config.armor ?? tier.armor));
         // A ward has no wireless mode to be in. Everything else defaults ON,
         // because a seeded keypad nobody thought about is a keypad on the
         // grid -- which is the state the report says the game should model.
@@ -98,6 +160,43 @@ export class Device {
     isOpen() {
         return this.open;
     }
+    // ---- The Extended Test (pick.ts) ----
+    /** The running test for this actor -- fresh when nobody, or somebody else, was working it. */
+    pickProgressFor(actorName) {
+        if (!this._pickProgress || this._pickProgress.actorName !== actorName) {
+            this._pickProgress = { actorName, hits: 0, attempts: 0 };
+        }
+        return this._pickProgress;
+    }
+    resetPickProgress() {
+        this._pickProgress = undefined;
+    }
+    /** The hits a hand-pick needs in total: Rating x 2 (p.359-360). */
+    get pickThreshold() {
+        return this.rating * 2;
+    }
+    // ---- The barrier (utilities/barrier-combat.ts) ----
+    get barrierDamage() {
+        return this._barrierDamage;
+    }
+    /** Boxes actually taken; a ward has nothing to fill. */
+    takeBarrierDamage(boxes) {
+        if (this.structure <= 0)
+            return 0;
+        const taken = Math.max(0, Math.floor(boxes));
+        this._barrierDamage = Math.min(this.structure, this._barrierDamage + taken);
+        return taken;
+    }
+    /** Damage has reached Structure: there is a hole where the barrier was. */
+    get isHoled() {
+        return this.structure > 0 && this._barrierDamage >= this.structure;
+    }
+    /** "Structure 8 / Armor 12, 3/8" -- the panel's line. */
+    barrierSummary() {
+        if (this.structure <= 0)
+            return '';
+        return `Structure ${this.structure} / Armor ${this.armor}${this._barrierDamage > 0 ? `, ${this._barrierDamage}/${this.structure} boxes` : ''}`;
+    }
     /**
      * IS THERE AN ICON HERE TO FIND? Wireless mode on, and a rating that
      * means it is electronics at all.
@@ -207,6 +306,7 @@ export class Device {
     force(succeeded) {
         if (succeeded) {
             this.open = true;
+            this._pickProgress = undefined;
             return { success: true, message: this.openMessage, alarmed: false };
         }
         return { success: false, message: AFFORDANCE_FLAVOR[this.kind].failureMessage, alarmed: true };
@@ -231,6 +331,8 @@ export class Device {
     /** Persistence-only: one flag in, nothing out. */
     restoreState(state) {
         this.open = state.open;
+        if (state.damage !== undefined)
+            this._barrierDamage = Math.max(0, Math.min(this.structure, Math.floor(state.damage)));
     }
 }
 //# sourceMappingURL=device.js.map

package/bundle/typescript/src/commands/game/sideQuest/models/device.js.map

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

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

@@ -1,5 +1,13 @@
 import { Size, Category, Rating } from '../types/shared/item-enum.js';
+import type { ICatalogItem, ICatalogEffect, ICatalogAmmo, ICatalogVehicle, WeaponSkill, WeaponRange, MountPoint, ModKind } from '../utilities/catalog-data.js';
 import { AbstractItem } from '../types/shared/abstracts.js';
+/**
+ * What a running program adds to a Matrix attribute, from its catalog
+ * row's effects (v13). The program's key is the deck's word for it
+ * (utilities/programs.ts); the row is found by the program's name.
+ * PROGRAM_ATTR_MODS stands in when no row is loaded.
+ */
+export declare function programMatrixMod(key: string, attr: 'attack' | 'sleaze' | 'dataProcessing' | 'firewall' | 'damage'): number;
 export interface IItemConstructorConfig {
     name: string;
     description: string;
@@ -113,12 +121,24 @@ export declare class Item extends AbstractItem {
     /**
      * STUN BY NATURE (SR5 p.170-171, p.424, RAG-checked 2026-09-02):
      * electricity damage is Stun, so a taser, a stun baton or shock gloves
-     * never deal Physical.
+     * never deal Physical. THE ROW SAYS SO (catalog v13: weapon.damageType
+     * / weapon.electric); the name regex is the fallback for generated gear.
      */
     isStunWeapon(): boolean;
     /**
-     * STUN BY AMMUNITION (p.434): gel rounds deal Stun at AP +1; stick-n-shock
-     * deal electric Stun at DV -2, AP -5. Anything else is Physical.
+     * WHAT THE LOADED ROUND DOES TO THE LINE (p.433-434): the ammunition
+     * row's block -- gel Stun at AP +1, stick-n-shock electric Stun at DV
+     * -2 / AP -5, APDS AP -4, explosive DV +1 / AP -1, flechette DV +2 /
+     * AP +5. Regular rounds shift nothing. Generated ammunition with no
+     * row keeps the two Stun names the engine always knew.
+     */
+    loadedAmmoMods(): (ICatalogAmmo & {
+        kind: string;
+    }) | undefined;
+    /**
+     * STUN BY AMMUNITION (p.434): the loaded round's block when it deals
+     * Stun. Kept as the pre-v13 shape for its callers (combat-exchange,
+     * the non-lethal tests): gel or stick-n-shock, with the DV/AP shift.
      */
     stunAmmo(): {
         kind: 'gel' | 'stick-n-shock';
@@ -131,6 +151,19 @@ export declare class Item extends AbstractItem {
     set owner(owner: string | undefined);
     get id(): string;
     get transferable(): boolean;
+    /**
+     * SURGERY MAKES IT PART OF YOU (Chrome Flesh p.222, the headware
+     * cyberdeck housing). One-way on purpose: there is no uninstall for
+     * chrome anywhere else in this engine either.
+     */
+    implantIntoBody(): void;
+    /**
+     * "Nothing special happens" is honest for most props, but confusing for
+     * gear whose NAME implies a specific action that lives at a different
+     * verb -- a Lockpick Set at a pickable door (user, 2026-09-03). The
+     * row's `useHint` (catalog v13) names that verb; absent it, the generic
+     * line stands, which is correct for gear that really has nothing to say.
+     */
     use(): string;
     /**
      * How much this item's quality tier is worth in game mechanics: extra
@@ -140,11 +173,33 @@ export declare class Item extends AbstractItem {
      * that gear feeds scales off this one number.
      */
     get qualityBonus(): number;
+    /** The catalog row, by exact slug or name (strict: catalogRowFor). */
+    get row(): ICatalogItem | undefined;
+    /** The SR5 Rating / Force / Capacity this thing carries: the row's, or
+     *  the "(Rating N)" its name prints. Undefined for an unrated thing. */
+    get ratingValue(): number | undefined;
     private get weaponHay();
-    /** Base ranged DV before quality (RAW: holdout 6P ... assault 11P, compressed). */
+    /** The p.185 range class: the row's, else read off the name (utilities/range.ts guessRangeClass). */
+    get rangeClass(): WeaponRange;
+    /** The skill this weapon is used with: the row's, else the class's. */
+    get weaponSkill(): WeaponSkill;
+    /**
+     * THE DV, the book's flat part (p.421-431): 8 for the Predator's "8P",
+     * 2 for a knife's "(STR+2)P" -- the Strength half is the wielder's and
+     * Player.getWeaponProfile adds it (dvAttribute says whether to). The
+     * fallback is the CLASS row of the same tables, un-compressed.
+     */
+    get weaponDv(): number;
+    /** Which attribute the DV rides on: melee is (STR + dv) unless the row says otherwise. */
+    get dvAttribute(): 'strength' | undefined;
+    /** Physical or Stun, before ammunition and stance have their say. */
+    get damageType(): 'P' | 'S';
+    /** @deprecated v13 -- the DV is weaponDv; kept one release for its readers. */
     get rangedBase(): number;
-    /** Base melee DV before STR/quality (RAW: knife STR+2, sword/katana/club STR+3). */
+    /** @deprecated v13 -- the DV is weaponDv; kept one release for its readers. */
     get meleeBase(): number;
+    /** Reach (p.421-423): the row's, else none. */
+    get reach(): number;
     /**
      * ACCURACY -- the LIMIT on an attack made with this weapon (p.46-47,
      * p.168: "Each weapon has an Accuracy rating that serves as its limit
@@ -152,60 +207,100 @@ export declare class Item extends AbstractItem {
      * inherent one, higher or lower (p.46-47), so this is not a floor or a
      * cap on the Physical limit -- it is the limit.
      *
-     * NOT COMPRESSED, unlike the DV values above. Damage was squeezed to
-     * engine scale because it is measured against soak dice this engine
-     * also scales; a limit is measured against HITS, which are the book's
-     * own units, and the Matrix brackets next door already spend the raw
-     * attribute ("whole, never halved"). Compressing here would make a
-     * sniper rifle and a holdout cap at the same place.
-     *
-     * The numbers are the book's tables (p.421-431), read through the same
-     * duck-typing school as rangedBase/armorPen so generated gear works
-     * unmodified. Class-based rather than per-weapon ON PURPOSE: the RAG
-     * could not produce standard-table rows for every gun this game ships
-     * (the shotgun table did not come back, and the one AK-97 figure it
-     * did return was off a Run Faster character sheet -- a MODIFIED
-     * weapon, not the table), so a per-weapon list would have meant
-     * inventing the gaps. Every value below is one the book gave up.
+     * THIS IS THE BARE NUMBER, NOT THE PARENTHETICAL. Tables write "Acc 5
+     * (7)": the 5 is the gun, and the 7 is the gun PLUS a shooter who owns
+     * a smartlink (p.433, +2 Accuracy with a smartgun system) -- see
+     * Player.smartlinkAccuracyBonus, which supplies the +2 in
+     * getAttackLimit. A laser sight's +1 rides the same way (fitted mods,
+     * Player.gearLimit), and never stacks with the smartlink (p.432).
      *
-     * THIS IS THE BARE NUMBER, NOT THE PARENTHETICAL, and that is now a
-     * division of labour rather than a gap. Tables write "Acc 5 (7)": the
-     * 5 is the gun, and the 7 is the gun PLUS a shooter who owns a
-     * smartlink (p.433, +2 Accuracy with a smartgun system). A gun sitting
-     * on a table has no idea who will pick it up, so the pairing is asked
-     * of the shooter -- see Player.smartlinkAccuracyBonus, which supplies
-     * the +2 in getAttackLimit. fxPHSuE4nrH3gAGiy.
+     * 0 means "no Accuracy of its own": the table's own word 'physical'
+     * (shock gloves, throwing knives, grenades) and everything that is not
+     * a weapon. Callers fall back to the Physical limit, which is what an
+     * improvised or bare-handed attack uses (p.168).
      *
-     * The laser-sight parenthetical (p.429 Enfield, "4 (5) with the
-     * built-in laser sight") is a DIFFERENT accessory and is still not
-     * modelled: the engine has no sight-fitting model, and inventing one
-     * to reuse the smartlink pairing would be guessing at a second rule.
-     *
-     * Note the wireless smartgun bonus is a DICE POOL bonus (+1/+2,
-     * p.433), NOT an Accuracy bonus -- getAttackPool already spends it as
-     * dice. Keeping those apart is the same discipline as the Matrix
-     * brackets: a limit is never a die, and a die is never a limit.
+     * The fallback ladder is the book's class values, read through the
+     * same duck-typing school as the DV so generated gear works.
      */
     get accuracy(): number;
     /**
-     * Armor penetration (<= 0): how much of the defender's ARMOR the hit
-     * ignores (RAW AP, compressed ~2:3 -- knife/katana -3 -> -2, heavy
-     * pistol -1 -> -1). Applied against armor dice only, never Body
-     * (combat-exchange.ts).
+     * Armor penetration: how much the hit shifts the defender's ARMOR
+     * (p.169) -- negative eats it, a "+" (gel, flechette) adds to it. The
+     * row's AP, else the class value from the same tables, un-compressed.
      */
     get armorPen(): number;
-    /** Heavier armor classes soak harder (RAW: jacket 12 vs clothing 6). */
+    /** Heavier armor classes soak harder (RAW: jacket 12 vs clothing 6). Fallback only. */
     get isHeavyArmor(): boolean;
+    /**
+     * THE ARMOR RATING of a worn piece (p.436-437): the row's, else the
+     * class value -- jacket-class 12, a vest 9, armor clothing 6, plain
+     * clothing 0. Only the highest worn piece counts (Player.armorBreakdown).
+     */
+    get armorValue(): number;
+    /** A "+" accessory's bonus (helmet +2, shield +6, p.437-438): the row's, else the class value. */
+    get armorBonus(): number;
+    /**
+     * WHAT THIS THING DOES, in the engine's vocabulary: the row's effects
+     * plus everything fitted into it (a smartlink in the goggles, a laser
+     * sight on the gun). A fitted mod's effects apply whenever the host
+     * does, so they are re-tagged with the host's own `when`.
+     */
+    get effects(): ICatalogEffect[];
+    /** When a row's effects apply by default: worn for a wearable, held for a weapon, carried otherwise. */
+    get defaultWhen(): 'worn' | 'held' | 'carried';
+    /** A flag the row (or a fitted mod) grants, by key; its value, or 0. */
+    capability(key: string): number;
+    hasCapability(key: string): boolean;
+    fitted: Item[];
+    /** Capacity this thing offers to mods. */
+    get capacity(): number;
+    /** What kinds of mod it holds. */
+    get holds(): ModKind[];
+    get capacityUsed(): number;
+    /** The accessory seats a gun has: the row's, else the class rule (p.432). */
+    get mounts(): MountPoint[];
+    /** Accessories the factory fitted (identifiers, see ICatalogWeapon.builtIn). */
+    get builtIn(): string[];
+    hasBuiltIn(id: string): boolean;
+    /**
+     * A SMARTGUN (p.433): a smartgun system built in or fitted. Before v13
+     * every firearm in the engine counted as one; canon makes it an
+     * accessory. Generated gear with no row is a smartgun only when it
+     * says so.
+     */
+    get isSmartgun(): boolean;
+    /** Which mount a fitted accessory sits in: the first of its mounts still free when it was fitted. */
+    mountOf(mod: Item): MountPoint | undefined;
+    /**
+     * Why a mod will not fit, or null when it will. The message is the
+     * player's line, so it names the rule that refused.
+     */
+    fitRefusal(mod: Item): string | null;
+    /** Fits a mod; the refusal line, or null when it went in. */
+    fit(mod: Item): string | null;
+    /** Takes a mod back out; false when it was not there. */
+    unfit(mod: Item): boolean;
+    /** The drone's stat block, when it has one. */
+    get vehicle(): ICatalogVehicle | undefined;
+    /** Pilot rating (p.199): the row's, else the price-tier fallback the engine always used. */
+    get pilotRating(): number;
+    /** A drone's hull armor (p.199): the row's, else the tier fallback. */
+    get droneArmor(): number;
+    /** A drone's Body (p.199): the row's, else the tier fallback. */
+    get droneBody(): number;
+    /** Does the drone carry a weapon mount: the row's, else the name says. */
+    get hasWeaponMount(): boolean;
     private _deckDamage;
     isCyberdeck(): boolean;
-    /** Better decks have more board to burn through: 8 + 2 per quality step. */
+    /** The Matrix condition monitor (p.228): 8 + (Device Rating / 2), rounded up. */
     get maxDeckBoxes(): number;
     get deckDamage(): number;
-    /** p.227: Summit 1, Chariot 2, Tsurugi 3, Cyber-5 5 (Excalibur-class 6). */
+    /** Device Rating, NUMERIC (catalog v13): the row's, else the tier ladder
+     *  (p.227: Summit 1, Chariot 2, Tsurugi 3, Cyber-5 5, Excalibur-class 6). */
     get deviceRating(): number;
-    /** The p.227 attribute array (highest first), by Device Rating. */
+    /** The p.227 attribute array (highest first): the row's four numbers, else by Device Rating. */
     get deckArray(): number[];
-    /** How many programs run at once (p.227; storage is unlimited). */
+    /** How many programs run at once (p.227; storage is unlimited): the row's, else the Device Rating. */
     get programSlots(): number;
     private _deckOrder;
     get deckOrder(): number[];