@maka/maka-cli 5.121.0 → 5.122.0

package/bundle/typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.121.0",
+  "version": "5.122.0",
   "type": "module",
   "summary": "A command line tool for scaffolding Meteor 2.x applications using either React.",
   "description": "A command line tool for scaffolding Meteor 2.x applications using React.",

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

@@ -27,11 +27,39 @@ export interface IArchetypeGearDef {
     color: string;
     texture: string;
 }
+export type PriorityLetter = 'A' | 'B' | 'C' | 'D' | 'E';
+export interface IArchetypePriorities {
+    metatype: PriorityLetter;
+    attributes: PriorityLetter;
+    magic: PriorityLetter;
+    skills: PriorityLetter;
+    resources: PriorityLetter;
+}
 export interface IArchetype {
     name: string;
     description: string;
     combat: ICombatAttributes;
     gear?: IArchetypeGearDef[];
+    /**
+     * SIGNATURE GEAR BY CATALOG SLUG (2026-09-03, the v13 pass): a row's
+     * name is what Item.row resolves, so a Predator built from its row is
+     * DV 8P at AP -1 with a smartgun inside, a Navigator has its p.227
+     * array, a medkit its Rating. Hand-written `gear` above was invisible
+     * to all of that (a "Trauma Kit" had no row). Custom, flavor-only
+     * pieces stay in `gear`; anything the book sells goes here.
+     */
+    gearSlugs?: string[];
+    /**
+     * THE PRIORITY ROW (SR5 p.65; user 2026-09-03: a pregen bound through
+     * the wizard must arrive as a COMPLETE, legal build on the Review step,
+     * not a spread the validator argues with). Each letter once. The
+     * spread above is built to it: attribute spend EXACTLY the column's
+     * points (human minimum 1 each), skills within the column's, Edge and
+     * any Magic above the offer within the metatype column's special
+     * points, the kit within Resources plus converted karma.
+     * archetype-priorities.test.ts checks every row the validator's way.
+     */
+    priorities: IArchetypePriorities;
     /**
      * Signature chrome, by augmentation key (see augmentations.ts) --
      * installed at character creation with the essence already paid. The
@@ -50,6 +78,41 @@ export interface IArchetype {
     qualities?: string[];
 }
 export declare const ARCHETYPES: IArchetype[];
+/** The p.65 Resources column, lowest to highest. */
+export declare const RESOURCES_PRIORITY: Record<'E' | 'D' | 'C' | 'B' | 'A', number>;
+export interface IArchetypeLedger {
+    gearNuyen: number;
+    augNuyen: number;
+    karmaRemainder: number;
+    karmaCarry: number;
+    karmaConverted: number;
+    /** The archetype's declared Resources column. */
+    resources: 'E' | 'D' | 'C' | 'B' | 'A';
+    nuyenBudget: number;
+    nuyenRemaining: number;
+    /** What the runner actually walks onto the street holding (p.95 cap). */
+    held: number;
+}
+/**
+ * THE CREATION LEDGER, THE WAY THE CHARGEN VALIDATOR RUNS IT (user,
+ * 2026-09-03: "ensure the starting nuyen is appropriate for the archetype
+ * -- use the chargen api to validate"). maka-cli.com's validateWorksheet
+ * prices a build as: budget = the Resources column + converted karma x
+ * 2,000 (at most 10 karma, after 7 carry over, p.98); spent = gear at
+ * catalog price + 'ware at its cost x grade + the first month's
+ * lifestyle; and the factory caps what a runner may HOLD out of the
+ * remainder at 5,000 (p.95) -- the rest is gone into the build. Same
+ * constants, same prices, same rows; mirrored here because a pregen has
+ * no worksheet to POST (its skill spread is a spread, not a priority
+ * column, and the validator would refuse it on that before it priced
+ * it). The column is the archetype's own (IArchetype.priorities): the book's
+ * pregens are priority builds, and now so are these.
+ *
+ * Before this, outfitArchetype handed the converted karma over as CASH
+ * (up to 20,000): a pregen started with four times what a web-built
+ * runner may hold. Street lifestyle (the scenes' tier) costs nothing.
+ */
+export declare function archetypeLedger(archetype: IArchetype): IArchetypeLedger;
 export declare function getArchetype(name?: string): IArchetype;
 /**
  * Instantiates an archetype's requisite gear (see IArchetype.gear).
@@ -57,6 +120,15 @@ export declare function getArchetype(name?: string): IArchetype;
  * ones -- a samurai starts with the Predator IN HAND, not in a duffel.
  */
 export declare function createArchetypeGear(archetype: IArchetype): Item[];
+/**
+ * Every piece an archetype starts with, as constructor configs: the
+ * catalog rows first (by slug, converted once in utilities/catalog.ts),
+ * then any custom pieces. The harness serializes these into a save; the
+ * game instantiates them. A slug with no row throws -- at build time, in
+ * the tests that walk every archetype -- rather than shipping a runner
+ * without her gun.
+ */
+export declare function archetypeGearDefs(archetype: IArchetype): IArchetypeGearDef[];
 /**
  * Stamps an archetype onto a Player: records the archetype's name (scene
  * generation's dossier reads it -- see buildPlayerDossier), grants the