@maka/maka-cli 5.123.0 → 5.124.0

package/bundle/typescript/src/commands/game/sideQuest/metamagics.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A METAMAGIC (SR5e p.325-326) or a technomancer's ECHO (p.257-258), as
+ * the engine holds one. Types only: the rows themselves are catalog rows
+ * of kind 'metamagic' on maka-cli.com, and utilities/catalog.ts's
+ * metamagicFor()/catalogMetamagics() rebuild this shape from them.
+ *
+ * Lived inside commands/initiate.ts until 2026-09-05, beside the array
+ * that is now gone; moved out so models/player.ts and the catalog client
+ * can name the type without importing a command.
+ */
+import type { ICatalogEffect } from './utilities/effects.js';
+export interface IMetamagic {
+    key: string;
+    name: string;
+    /** Who can take it: casters (magic, not adept), adepts, or technomancers. */
+    path: 'caster' | 'adept' | 'techno';
+    effect: string;
+    page: string;
+    /**
+     * WHAT IT DOES, in the shared effects vocabulary (2026-09-04). A
+     * metamagic applies once 'initiated', and `scaleBy: 'grade'` multiplies
+     * by the initiation or submersion grade -- which is what Centering's
+     * "+grade dice" means.
+     *
+     * ONLY THE FLAT ONES CARRY EFFECTS, and the rest are rules of their own
+     * shape in models/player.ts: Quickening changes whether a sustained
+     * spell BILLS you, Overclocking adds a die only in hot-sim, and the two
+     * Matrix upgrades move a persona attribute that is computed rather than
+     * summed. Writing those as dice would be a stat block that lies.
+     */
+    effects?: ICatalogEffect[];
+}

package/bundle/typescript/src/commands/game/sideQuest/metamagics.js

@@ -0,0 +1,12 @@
+/**
+ * A METAMAGIC (SR5e p.325-326) or a technomancer's ECHO (p.257-258), as
+ * the engine holds one. Types only: the rows themselves are catalog rows
+ * of kind 'metamagic' on maka-cli.com, and utilities/catalog.ts's
+ * metamagicFor()/catalogMetamagics() rebuild this shape from them.
+ *
+ * Lived inside commands/initiate.ts until 2026-09-05, beside the array
+ * that is now gone; moved out so models/player.ts and the catalog client
+ * can name the type without importing a command.
+ */
+export {};
+//# sourceMappingURL=metamagics.js.map

package/bundle/typescript/src/commands/game/sideQuest/metamagics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metamagics.js","sourceRoot":"","sources":["../../../../../../src/commands/game/sideQuest/metamagics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/bundle/typescript/src/commands/game/sideQuest/metatypes.d.ts

@@ -43,11 +43,13 @@ export interface IMetatype {
     lifestyleCostMult?: number;
     /** Racial abilities, in the shared effects vocabulary. */
     effects?: ICatalogEffect[];
+    /**
+     * The Priority Table's metatype column (p.65): special attribute
+     * points per priority letter; a letter absent = not offered at that
+     * priority. The web chargen prices its metatype pick from this.
+     */
+    priority?: Partial<Record<'A' | 'B' | 'C' | 'D' | 'E', number>>;
     page: string;
 }
 /** Every metatype's Essence starts at 6 (p.66); none of them varies. */
 export declare const STARTING_ESSENCE = 6;
-export declare const METATYPES: IMetatype[];
-/** Keyed lookup, the shape every other source file here exposes. */
-export declare const METATYPES_BY_KEY: Record<string, IMetatype>;
-export declare function getMetatype(key: string): IMetatype | undefined;

package/bundle/typescript/src/commands/game/sideQuest/metatypes.js

@@ -1,86 +1,6 @@
 /** Every metatype's Essence starts at 6 (p.66); none of them varies. */
 export const STARTING_ESSENCE = 6;
-export const METATYPES = [
-    {
-        key: 'human', name: 'Human',
-        description: 'The baseline the rest of the table is measured against -- and the one with luck to spare.',
-        attributes: {
-            body: { min: 1, max: 6 }, agility: { min: 1, max: 6 }, reaction: { min: 1, max: 6 },
-            strength: { min: 1, max: 6 }, willpower: { min: 1, max: 6 }, logic: { min: 1, max: 6 },
-            intuition: { min: 1, max: 6 }, charisma: { min: 1, max: 6 },
-            // The one place humans are ahead of everyone: Edge 2/7, where every
-            // other metatype starts at 1 and stops at 6.
-            edge: { min: 2, max: 7 },
-        },
-        sprintMetersPerHit: 2,
-        page: 'p.66',
-    },
-    {
-        key: 'elf', name: 'Elf',
-        description: 'Quick and easy to like, and never quite allowed to forget either.',
-        attributes: {
-            body: { min: 1, max: 6 }, agility: { min: 2, max: 7 }, reaction: { min: 1, max: 6 },
-            strength: { min: 1, max: 6 }, willpower: { min: 1, max: 6 }, logic: { min: 1, max: 6 },
-            intuition: { min: 1, max: 6 }, charisma: { min: 3, max: 8 }, edge: { min: 1, max: 6 },
-        },
-        sprintMetersPerHit: 2,
-        effects: [{ type: 'flag', category: 'capability', property: 'low-light', value: 1 }],
-        page: 'p.66',
-    },
-    {
-        key: 'dwarf', name: 'Dwarf',
-        description: 'Built low and built to last: harder to poison, harder to move, and paying more for a door that fits.',
-        attributes: {
-            body: { min: 3, max: 8 }, agility: { min: 1, max: 6 }, reaction: { min: 1, max: 5 },
-            strength: { min: 3, max: 8 }, willpower: { min: 2, max: 7 }, logic: { min: 1, max: 6 },
-            intuition: { min: 1, max: 6 }, charisma: { min: 1, max: 6 }, edge: { min: 1, max: 6 },
-        },
-        sprintMetersPerHit: 1,
-        lifestyleCostMult: 1.2,
-        effects: [
-            { type: 'flag', category: 'capability', property: 'thermographic', value: 1 },
-            // Canon reads "+2 dice for pathogen and toxin resistance". The
-            // engine has a toxin pool and no pathogen track at all, so the
-            // toxin half is declared and the pathogen half is simply absent --
-            // named here rather than folded in, because a die granted against
-            // something nothing rolls would be a stat block that lies.
-            { type: 'dice', category: 'pools', property: 'toxin', value: 2 },
-        ],
-        page: 'p.66',
-    },
-    {
-        key: 'ork', name: 'Ork',
-        description: 'Strong, fast to mature, and written off by everyone who has never needed one.',
-        attributes: {
-            body: { min: 4, max: 9 }, agility: { min: 1, max: 6 }, reaction: { min: 1, max: 6 },
-            strength: { min: 3, max: 8 }, willpower: { min: 1, max: 6 }, logic: { min: 1, max: 5 },
-            intuition: { min: 1, max: 6 }, charisma: { min: 1, max: 5 }, edge: { min: 1, max: 6 },
-        },
-        sprintMetersPerHit: 2,
-        effects: [{ type: 'flag', category: 'capability', property: 'low-light', value: 1 }],
-        page: 'p.66',
-    },
-    {
-        key: 'troll', name: 'Troll',
-        description: 'Armoured at birth, longer in the arm than anything else on the street, and charged double for everything.',
-        attributes: {
-            body: { min: 5, max: 10 }, agility: { min: 1, max: 5 }, reaction: { min: 1, max: 6 },
-            strength: { min: 5, max: 10 }, willpower: { min: 1, max: 6 }, logic: { min: 1, max: 5 },
-            intuition: { min: 1, max: 5 }, charisma: { min: 1, max: 4 }, edge: { min: 1, max: 6 },
-        },
-        sprintMetersPerHit: 1,
-        lifestyleCostMult: 2,
-        effects: [
-            { type: 'flag', category: 'capability', property: 'thermographic', value: 1 },
-            { type: 'attribute', category: 'attributes', property: 'reach', value: 1 },
-            { type: 'attribute', category: 'attributes', property: 'armor-bonus', value: 1 },
-        ],
-        page: 'p.66',
-    },
-];
-/** Keyed lookup, the shape every other source file here exposes. */
-export const METATYPES_BY_KEY = Object.fromEntries(METATYPES.map(m => [m.key, m]));
-export function getMetatype(key) {
-    return METATYPES_BY_KEY[key];
-}
+// THE ROWS ARE NOT HERE. The five metatypes are catalog rows of kind
+// 'metatype' on maka-cli.com; utilities/catalog.ts's metatypeFor() and
+// catalogMetatypes() rebuild IMetatype from a row.
 //# sourceMappingURL=metatypes.js.map

package/bundle/typescript/src/commands/game/sideQuest/metatypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"metatypes.js","sourceRoot":"","sources":["../../../../../../src/commands/game/sideQuest/metatypes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"metatypes.js","sourceRoot":"","sources":["../../../../../../src/commands/game/sideQuest/metatypes.ts"],"names":[],"mappings":"AAoDA,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,qEAAqE;AACrE,uEAAuE;AACvE,mDAAmD"}

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

@@ -261,7 +261,7 @@ export interface ICombatAttributes {
     aspect?: string;
     /**
      * The spells a magician/mystic adept CHOSE at creation (SR5 p.300, up to
-     * Magic x 2). Keys into spells.ts's SPELL_CATALOG. ABSENT means "knows
+     * 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
@@ -270,7 +270,7 @@ export interface ICombatAttributes {
     knownSpells?: string[];
     /**
      * The adept powers CHOSEN at creation (SR5 p.308-310): key -> level, keys
-     * into adept-powers.ts's ADEPT_POWER_CATALOG, total cost within
+     * 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
@@ -862,7 +862,7 @@ export declare class Player extends AbstractPlayer {
     essence: number;
     baseMagic: number;
     baseResonance: number;
-    /** Installed 'ware, by catalog key (see AUGMENTATIONS). */
+    /** Installed 'ware, by catalog key (kind 'augmentation'). */
     augmentations: Set<string>;
     /**
      * What GRADE each installed piece was cut at (see WARE_GRADES,
@@ -1030,7 +1030,7 @@ export declare class Player extends AbstractPlayer {
      * and only the chrome lane can answer it.
      */
     augBonus(kind: AugBonusKind): number;
-    /** Installed qualities, by catalog key (see QUALITIES). */
+    /** Installed qualities, by catalog key (kind 'quality'). */
     qualities: Set<string>;
     /**
      * IS THIS SKILL OR ATTRIBUTE FORBIDDEN OUTRIGHT to this character?
@@ -1820,7 +1820,7 @@ export declare class Player extends AbstractPlayer {
     /** 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" | "reflexes" | "invisibility", number>;
+    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;

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

@@ -1,17 +1,13 @@
 import { getSoft, getProgram } from '../utilities/programs.js';
 import { GEAR_LANES, CHROME_LANES, QUALITY_LANES, ART_LANES, ADEPT_LANES, scaleOf } from '../utilities/effects.js';
-import { catalogRowFor } from '../utilities/catalog.js';
+import { catalogRowFor, spellFor, augFor, adeptPowerFor, metamagicFor } from '../utilities/catalog.js';
 import { getQuality, resolveQualityKey } from '../qualities.js';
-import { ADEPT_POWERS } from '../adept-powers.js';
 import { skillsInGroup } from '../skill-groups.js';
-import { spellFor } from '../utilities/catalog.js';
-import { METAMAGICS_BY_KEY } from '../commands/initiate.js';
 import { isAspectKey } from '../aspects.js';
 import { hint } from '../utilities/hints.js';
 import { Category } from '../types/shared/item-enum.js';
 import { Logger } from '../utilities/logger.js';
 import { CALL_ICON, CALL_COLOR } from '../utilities/comm-style.js';
-import { getAug } from '../augmentations.js';
 // The Physical limit already lives here (subduing, p.195) -- imported
 // rather than re-derived so meat combat and the grapple cannot drift
 // into two different formulas for the same canon number.
@@ -1224,7 +1220,7 @@ export class Player extends AbstractPlayer {
     // `magic`/`resonance` above stay the EFFECTIVE values every pool reads.
     baseMagic = 0;
     baseResonance = 0;
-    /** Installed 'ware, by catalog key (see AUGMENTATIONS). */
+    /** Installed 'ware, by catalog key (kind 'augmentation'). */
     augmentations = new Set();
     /**
      * What GRADE each installed piece was cut at (see WARE_GRADES,
@@ -1250,7 +1246,7 @@ export class Player extends AbstractPlayer {
      */
     implantWeapon() {
         for (const key of this.augmentations) {
-            const w = getAug(key)?.implantWeapon;
+            const w = augFor(key)?.implantWeapon;
             if (!w)
                 continue;
             // A shock hand out of charges is a hand (p.458).
@@ -1277,7 +1273,7 @@ export class Player extends AbstractPlayer {
     /** Back to full -- a rest, or the moment the chrome goes in. */
     refillImplantCharges() {
         for (const key of this.augmentations) {
-            const w = getAug(key)?.implantWeapon;
+            const w = augFor(key)?.implantWeapon;
             if (w?.charges !== undefined) {
                 this.implantCharges = w.charges;
                 return;
@@ -1310,7 +1306,7 @@ export class Player extends AbstractPlayer {
         // A HOUSING TAKES THE DECK YOU BROUGHT (Chrome Flesh p.222). Nothing
         // is granted -- the book charges 5,000 PLUS the deck, so this moves
         // the one you own inside your skull and it stops being liftable.
-        if (getAug(aug.key)?.implantsCarriedDeck)
+        if (augFor(aug.key)?.implantsCarriedDeck)
             this.getAnyCyberdeck()?.implantIntoBody();
     }
     // ================= THE EFFECTS LANE (one resolver) =================
@@ -1393,7 +1389,7 @@ export class Player extends AbstractPlayer {
         // here, once, so every reader sees the same surviving set -- rather
         // than in a getter, where only that getter would have been right.
         for (const key of this.chromeThatCounts()) {
-            const a = getAug(key);
+            const a = augFor(key);
             if (a?.effects)
                 take(a.effects, 'installed', 'installed', undefined, 'chrome', key);
         }
@@ -1406,14 +1402,14 @@ export class Player extends AbstractPlayer {
         for (const [key, level] of Object.entries(this.adeptPowers ?? {})) {
             if (level <= 0)
                 continue;
-            const power = ADEPT_POWERS[key];
+            const power = adeptPowerFor(key);
             if (power?.effects)
                 take(power.effects, 'innate', 'innate', level, 'adept', key);
         }
         // ---- The INITIATE lane. A metamagic applies from the moment it is
         // learned, and 'grade' is what Centering multiplies by.
         for (const key of this.metamagics) {
-            const m = METAMAGICS_BY_KEY[key];
+            const m = metamagicFor(key);
             if (m?.effects)
                 take(m.effects, 'initiated', 'initiated', this.initiationGrade, 'initiate', key);
         }
@@ -1648,7 +1644,7 @@ export class Player extends AbstractPlayer {
     // (outfitArchetype). Every entry in the catalog has a real mechanical
     // hook; the ones that read as flat pool nudges all tap through
     // qualityBonus below, the same single-switch pattern as augBonus.
-    /** Installed qualities, by catalog key (see QUALITIES). */
+    /** Installed qualities, by catalog key (kind 'quality'). */
     qualities = new Set();
     /**
      * IS THIS SKILL OR ATTRIBUTE FORBIDDEN OUTRIGHT to this character?
@@ -2938,7 +2934,7 @@ export class Player extends AbstractPlayer {
             // this same punch independently, and both read implantWeapon.
             const implant = this.implantWeapon();
             if (implant) {
-                const aug = [...this.augmentations].map(k => getAug(k)).find(a => a?.implantWeapon);
+                const aug = [...this.augmentations].map(k => augFor(k)).find(a => a?.implantWeapon);
                 return {
                     name: aug?.name?.toLowerCase() ?? 'implanted blades',
                     damage: implant.dv + (implant.dvAttribute === 'strength' ? this.strength : 0),