@maka/maka-cli 5.127.0 → 5.129.0

package/bundle/typescript/src/commands/game/sideQuest/utilities/catalog-data.d.ts

@@ -1,341 +0,0 @@
-/**
- * THE SHAPE OF THE CATALOG -- every kind of thing the game can obtain,
- * as TypeScript. Gear (what the swag network can source; see
- * commands/catalog.ts and commands/source.ts), augmentations, qualities,
- * spells, adept powers, metamagics and metatypes: one collection,
- * several kinds, discriminated by `kind` (absent = gear).
- *
- * THIS FILE HOLDS NO ROWS. The rows live in ONE place, maka-cli.com's
- * GameCatalog collection, seeded from
- * maka-cli.com/app/private/catalog/full-catalog.json and served at
- * /api/v1/game-catalog/list. The CLI reads them through
- * utilities/catalog.ts (live list > local cache; nothing baked in), and
- * every rule the engine applies -- a quality's dice, a spell's drain, a
- * power's cost -- is reconstructed from a row by the accessors there
- * (augFor, qualityFor, spellFor, adeptPowerFor, metamagicFor,
- * metatypeFor). Until 2026-09-05 this file also carried the seed and
- * derived the non-gear rows from the engine's own arrays; the user's
- * ruling is that the database is the single source of truth, so the
- * arrays are gone and there is nothing left here to drift.
- *
- * STATS ARE REFERENCE, NOT ENGINE INPUT: `stats` is the book's own line
- * for a gear row (Acc/DV/AP/mode/ammo, armor rating, deck array...). The
- * engine reads the typed block (models/item.ts); the string is what the
- * player reads, and what an NPC's swag briefing quotes.
- *
- * Co-owned with maka-cli.com's game-catalog-shape.ts: a field added to
- * a row has to be declared on both sides in the same breath.
- */
-import type { IQuality } from '../qualities.js';
-import type { IImplantWeapon } from '../augmentations.js';
-import type { ICatalogChoice, ICatalogRestrictions } from './effects.js';
-import type { ICatalogEffect } from './effects.js';
-export type CatalogKind = 'gear' | 'quality' | 'spell' | 'augmentation' | 'metatype' | 'adept-power' | 'metamagic';
-/** The skill a weapon is fired or swung with. The last four have no engine
- *  skill yet (SkillName); the engine falls back per models/player.ts. */
-export type WeaponSkill = 'pistols' | 'automatics' | 'longarms' | 'archery' | 'blades' | 'clubs' | 'unarmed' | 'heavy-weapons' | 'throwing-weapons' | 'exotic-melee' | 'exotic-ranged';
-/** The p.185 Range Table rows (utilities/range.ts carries the metres). */
-export type WeaponRange = 'taser' | 'holdout' | 'light-pistol' | 'heavy-pistol' | 'machine-pistol' | 'smg' | 'assault-rifle' | 'shotgun' | 'sniper' | 'lmg' | 'mmg' | 'bow' | 'light-crossbow' | 'medium-crossbow' | 'heavy-crossbow' | 'thrown-knife' | 'grenade' | 'melee';
-export type FireMode = 'SS' | 'SA' | 'BF' | 'FA';
-export type AmmoFeed = 'c' | 'm' | 'cy' | 'b' | 'd' | 'ml' | 'belt';
-/** SR5 p.417-418, p.432: hold-outs have no mounts; tasers top only;
- *  pistols, machine pistols and SMGs top + barrel; rifles, shotguns and
- *  heavy weapons all three. One accessory per mount. */
-export type MountPoint = 'top' | 'under' | 'barrel';
-/** A weapon's combat values, the book's table row (p.421-431, p.435). */
-export interface ICatalogWeapon {
-    skill: WeaponSkill;
-    /** The BARE number, never the smartlink/laser parenthetical (the shooter
-     *  supplies those -- Player.getAttackLimit). 'physical' is the table's own
-     *  word for "use the Physical limit" (shock gloves, throwing knives). */
-    accuracy: number | 'physical';
-    /** The flat part of the DV: 8 for "8P", 2 for "(STR+2)P". */
-    dv: number;
-    /** Melee: DV = this attribute + dv. */
-    dvAttribute?: 'strength';
-    damageType: 'P' | 'S';
-    /** "(e)": electricity, Stun by canon (p.170-171). */
-    electric?: true;
-    /** Armor penetration, <= 0 for the usual, > 0 where the book prints "+". 0 for "--". */
-    ap: number;
-    reach?: number;
-    modes?: FireMode[];
-    /** Recoil compensation as the table prints it ("RC (1)" -> 1). Data until
-     *  a recoil model exists. */
-    rc?: number;
-    ammo?: {
-        rounds: number;
-        feed: AmmoFeed;
-    };
-    range?: WeaponRange;
-    /** Grenades: the blast falls off this much per metre. */
-    blast?: number;
-    /** The accessory seats this gun has. Absent = none (hold-outs). */
-    mounts?: MountPoint[];
-    /** Accessories fitted at the factory, by identifier. They occupy no
-     *  mount. Identifiers, not slugs: 'smartgun-internal', 'laser-sight',
-     *  'silencer', 'gas-vent-2', 'folding-stock', 'shock-pad',
-     *  'imaging-scope', 'grenade-launcher'. */
-    builtIn?: string[];
-}
-/** Ammunition (p.433-434): how a loaded round shifts the gun's line. */
-export interface ICatalogAmmo {
-    dvMod: number;
-    apMod: number;
-    /** Stun rounds. Absent = the gun's own damage type. */
-    damageType?: 'S';
-    electric?: true;
-    note?: string;
-}
-export type ModKind = 'vision' | 'audio' | 'armor' | 'trodes' | 'weapon';
-/** Something worn: armor (p.436-438) and/or capacity for mods (p.443-445). */
-export interface ICatalogWearable {
-    /** The piece's own Armor rating. Only the highest worn piece counts (p.169). */
-    armor?: number;
-    /** A "+" accessory (helmet, shield): adds to the worn piece, capped by
-     *  Strength (p.169, p.438). */
-    armorBonus?: number;
-    /** How much it holds (goggles 4, helmet 6). */
-    capacity?: number;
-    /** What may be fitted into it. */
-    holds?: ModKind[];
-    /** Concealability modifier for what is worn under it (lined coat -2).
-     *  Data only: the engine has no concealment test yet. */
-    concealment?: number;
-}
-/** A Matrix device (p.438-439). Device Rating is NUMERIC. */
-export interface ICatalogDevice {
-    deviceRating: number;
-    /** Cyberdecks: the p.227 attribute array, highest first as the book prints it. */
-    attack?: number;
-    sleaze?: number;
-    dataProcessing?: number;
-    firewall?: number;
-    /** Running-program limit (p.227). */
-    programs?: number;
-}
-/** A drone or vehicle (SR5 p.466, Rigger 5.0 p.126-149). A value stays a
- *  string only where the book prints two figures ("4/2" on/off-road,
- *  "1G/1W" two travel modes, "--" for an immobile frame). */
-export interface ICatalogVehicle {
-    handling: number | string;
-    speed: number | string;
-    acceleration: number | string;
-    body: number;
-    armor: number;
-    pilot: number;
-    sensor: number;
-    seats?: number;
-    /** A weapon mount: the drone can be armed (Player.droneArmed). */
-    mount?: 'standard' | 'heavy';
-    /** Rigger 5.0 p.145: an anthroform's monitor is 8 + (Body/2). */
-    anthro?: boolean;
-}
-/** A modification that is FITTED into something else (fit.ts). */
-export interface ICatalogMod {
-    kind: ModKind;
-    /** Wearable capacity it uses (vision/audio/armor/trodes, p.444-445). */
-    capacityCost?: number;
-    /** Weapon accessories: the mounts it may take (p.432). */
-    mount?: MountPoint[];
-    /** An accessory that itself holds mods (imaging scope: Capacity 3). */
-    capacity?: number;
-    /** Weapon classes it refuses: a silencer fits no revolver or shotgun (p.432). */
-    excludes?: ('shotgun' | 'revolver')[];
-}
-export type { EffectPool, EffectLimit, EffectAttribute, EffectMatrixAttribute, EffectCapability, ICatalogEffect, EffectScale, EffectWhen, } from './effects.js';
-/** Every kind shares this. */
-export interface ICatalogBase {
-    /** Absent = 'gear'. */
-    kind?: CatalogKind;
-    /** Unique across the whole collection, every kind. Qualities, spells,
-     *  augmentations and metatypes use their existing `key`. */
-    slug: string;
-    name: string;
-    description: string;
-    page?: string;
-    approx?: boolean;
-    effects?: ICatalogEffect[];
-    /**
-     * THE SPELL A FORMULA TEACHES, by spells.ts key.
-     *
-     * A spell formula is written for ONE spell (p.461, p.299: "the spell
-     * you want"), and its PRICE is set by that spell's category. The
-     * five rows here used to be the categories themselves -- "Combat
-     * Spell Formula" -- and Player.knowsSpell matched them by looking
-     * for the spell's name inside the item's name. No category name
-     * ever contains a spell name, so the match could never fire: every
-     * one of them was 500 to 2,000 nuyen for a scroll that taught
-     * nothing.
-     */
-    teaches?: string;
-    /**
-     * A pick this row cannot work without (ICatalogChoice). ON THE BASE,
-     * so a quality, an augmentation, a spell or an adept power all declare
-     * one the same way -- a Hardwire naming a skill is the same question
-     * Aptitude asks, and asking it twice in two shapes is how the picker
-     * ends up rebuilt per kind.
-     */
-    choice?: ICatalogChoice;
-    /**
-     * What this row refuses to be held with (ICatalogRestrictions), in the
-     * same one shape for every kind. Assembled from each source's own
-     * per-kind fields, so one enforcement pass covers all 69 rather than
-     * one hand-written gate covering one.
-     */
-    restrictions?: ICatalogRestrictions;
-}
-export interface ICatalogItem extends ICatalogBase {
-    kind?: 'gear';
-    category: string;
-    rating: string;
-    size: string;
-    shape: string;
-    color: string;
-    texture: string;
-    weight: number;
-    price: number;
-    availability: number;
-    legality?: 'R' | 'F';
-    stats?: string;
-    /** The SR5 Rating / Force / Capacity the NAME carries ("Medkit (Rating 3)"
-     *  -> 3). What `scaleBy: 'rating'` multiplies by. */
-    ratingValue?: number;
-    weapon?: ICatalogWeapon;
-    ammo?: ICatalogAmmo;
-    wearable?: ICatalogWearable;
-    device?: ICatalogDevice;
-    vehicle?: ICatalogVehicle;
-    mod?: ICatalogMod;
-    /**
-     * WHAT "use" SHOULD SAY when the generic "Nothing special happens." would
-     * read as broken (user, 2026-09-03: a Lockpick Set at a pickable door
-     * giving that line is confusing, not a shrug). Only for gear whose NAME
-     * implies a specific action that lives at a DIFFERENT verb -- a Lockpick
-     * Set means "pick", not "use". Absent = the generic line stays; most
-     * gear needs no hint at all. Read by Item.use() (models/item.ts).
-     */
-    useHint?: string;
-}
-export type Metatype = 'human' | 'elf' | 'dwarf' | 'ork' | 'troll';
-export interface ICatalogQuality extends ICatalogBase {
-    kind: 'quality';
-    quality: {
-        polarity: 'positive' | 'negative';
-        karma: number;
-        maxRating?: number;
-        retired?: string;
-        requires?: 'awakened' | 'mundane' | 'caster-or-technomancer';
-        requiresQuality?: string;
-        requiresMetatype?: Metatype[];
-        /**
-         * THE FOUR FIELDS qualityRows() writes and this interface did not
-         * declare (found by maka-cli-com-c3 reading the commit, 2026-09-04).
-         *
-         * They were invisible to the compiler because the object literal
-         * carrying them contains conditional spreads, and a literal with a
-         * spread is no longer FRESH -- excess-property checking does not
-         * apply to it. So the row shipped four fields the published .d.ts
-         * denied existed, and the web's mirror would have needed a cast to
-         * read `row.quality.choice` -- the sort of cast that later gets
-         * tidied away by someone who trusts the type.
-         *
-         * DERIVED FROM IQuality, not retyped. `family`'s union and the shape
-         * of a choice live in qualities.ts, and indexing them here means the
-         * catalog cannot fall behind the source the way it just did. It also
-         * answers the question c3 asked -- "tell me if the names or the
-         * family union move" -- with "they cannot, if you index them too".
-         */
-        family: IQuality['family'];
-        inert?: string;
-        choice?: ICatalogChoice;
-        excludesQuality?: string;
-    };
-}
-export interface ICatalogSpell extends ICatalogBase {
-    kind: 'spell';
-    spell: {
-        /**
-         * WHICH ROUTINE CASTS IT. The one field a row could not supply,
-         * and so the one thing stopping a spell from being sourced from
-         * the catalog rather than compiled in -- which is where the
-         * rules are headed (mjmcee, 2026-09-04: "the engine rule comes
-         * from the catalog. We shouldn't be hard coding the rules").
-         */
-        cast: 'combat' | 'heal' | 'armor' | 'sustained-utility' | 'barrier';
-        category: 'Combat' | 'Detection' | 'Health' | 'Illusion' | 'Manipulation';
-        type: 'mana' | 'physical';
-        range: 'LOS' | 'LOS(A)' | 'touch';
-        duration: 'I' | 'S' | 'P';
-        drainOffset: number;
-        soak?: 'willpower' | 'body' | 'armor';
-        stun?: boolean;
-        area?: boolean;
-        touch?: boolean;
-    };
-}
-export interface ICatalogAugmentation extends ICatalogBase {
-    kind: 'augmentation';
-    augmentation: {
-        ware: 'cyberware' | 'bioware';
-        essence: number;
-        cost: number;
-        wakeLine: string;
-        excludes?: string[];
-        avail?: number;
-        legality?: 'R' | 'F';
-        canonCost?: number;
-        canonEssence?: number;
-        /** A cyber melee weapon built into the body (IAugmentation.implantWeapon). */
-        implantWeapon?: IImplantWeapon;
-        /** A housing for the carried deck (IAugmentation.implantsCarriedDeck). */
-        implantsCarriedDeck?: boolean;
-    };
-}
-/**
- * AN ADEPT POWER (p.308-310). Bought with Power Points rather than nuyen
- * or karma, which is why it carries no price: `levelCosts` is the PP to
- * HOLD it at each level, and a magic-capped power extends linearly to the
- * character's Magic.
- */
-export interface ICatalogAdeptPower extends ICatalogBase {
-    kind: 'adept-power';
-    adeptPower: {
-        levelCosts: number[];
-        magicCapped: boolean;
-        costPerLevel?: number;
-    };
-}
-/**
- * A METAMAGIC (p.325-326) or a technomancer's echo (p.258). Bought with an
- * initiation or submersion grade, so it has no price either; `path` is who
- * may take it.
- */
-export interface ICatalogMetamagic extends ICatalogBase {
-    kind: 'metamagic';
-    metamagic: {
-        path: 'caster' | 'adept' | 'techno';
-    };
-}
-export interface ICatalogMetatype extends ICatalogBase {
-    kind: 'metatype';
-    metatype: {
-        attributes: Record<string, {
-            min: number;
-            max: number;
-        }>;
-        sprintMetersPerHit: 1 | 2;
-        lifestyleCostMult?: number;
-        /**
-         * THE PRIORITY TABLE'S METATYPE COLUMN (SR5 p.65): the SPECIAL
-         * ATTRIBUTE points (Edge / Magic / Resonance) this metatype comes with
-         * at each priority letter. A letter absent from the map does not offer
-         * the metatype at all; present with 0 offers it with no points (a troll
-         * at B). Optional only because caches written before v16 lack it.
-         */
-        priority?: Partial<Record<'A' | 'B' | 'C' | 'D' | 'E', number>>;
-    };
-}
-export type ICatalogRow = ICatalogItem | ICatalogQuality | ICatalogSpell | ICatalogAugmentation | ICatalogMetatype | ICatalogAdeptPower | ICatalogMetamagic;
-/** Gear or not -- the discriminator every consumer of the gear list uses. */
-export declare function isGearRow(r: ICatalogRow): r is ICatalogItem;

package/bundle/typescript/src/commands/game/sideQuest/utilities/catalog-data.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"catalog-data.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/catalog-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAqXH,6EAA6E;AAC7E,MAAM,UAAU,SAAS,CAAC,CAAc;IACtC,OAAO,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;AACnD,CAAC"}