afnm-types 0.6.51 → 0.6.52

package/dist/buff.d.ts

@@ -9,7 +9,7 @@ interface BaseTechniqueCondition {
     /**
      * When true, triggered effects (triggeredBuffEffects) on this buff will still
      * run even when this condition fails. The condition still blocks normal
-     * onTechniqueEffects and onRoundEffects.
+     * beforeTechniqueEffects, afterTechniqueEffects, and onRoundEffects.
      */
     allowTriggers?: boolean;
 }
@@ -84,8 +84,10 @@ export interface Buff {
     noneType?: string;
     secondaryType?: TechniqueElement | 'origin';
     enhancement?: number;
-    onTechniqueEffects: BuffEffect[];
-    onRoundEffects: BuffEffect[];
+    beforeTechniqueEffects?: BuffEffect[];
+    afterTechniqueEffects?: BuffEffect[];
+    onStackGainEffects?: BuffEffect[];
+    onRoundEffects?: BuffEffect[];
     onRoundStartEffects?: BuffEffect[];
     onCombatStartEffects?: BuffEffect[];
     interceptBuffEffects?: {
@@ -131,7 +133,6 @@ export interface Buff {
         effects?: BuffEffect[];
     }[];
     priority?: number;
-    afterTechnique?: boolean;
     combatImage?: BuffCombatImage;
     maxStacks?: number;
     upgradeKey?: string;

package/dist/buildSubmission.d.ts

@@ -1,7 +1,7 @@
 import { BreakthroughState } from './breakthrough';
 import { PhysicalStatistic } from './stat';
 import { KnownTechnique } from './technique';
-import { StoredStance, StoredStyle } from './entity';
+import { StoredStance, StoredStyle, AutoUseLoadout } from './entity';
 import { TechniqueElement } from './element';
 import { ItemDesc } from './item';
 /**
@@ -97,9 +97,11 @@ export interface NormalizedBuildSubmission {
         offensive?: string;
         aggressive?: string;
     };
-    /** Optional combat modifiers chosen by the submitter — applied symmetrically to both sides. */
+    /** Optional combat modifiers chosen by the submitter, applied symmetrically to both sides. */
     combatModifiers?: ChallengeModifiers;
-    /** Manifested figment (lifeform companion) at time of submission — added as a party member during challenge fights. */
+    /** Active auto-use item loadout at time of submission, applied as conditional pills during challenge fights. */
+    currentAutoUseLoadout?: AutoUseLoadout;
+    /** Manifested figment (lifeform companion) at time of submission, added as a party member during challenge fights. */
     lifeform?: {
         primarySpecies: string;
         secondarySpecies: string;

package/dist/cli/extract-translations/extractors.js

@@ -882,6 +882,28 @@ function extractFromFile(filePath) {
                 }
             }
         }
+        // Find shorthand property assignments where the variable name IS the property name
+        // e.g., `const description = 'text'; const item = { description }` (shorthand for description: description)
+        if (typescript_1.default.isShorthandPropertyAssignment(node)) {
+            const propName = node.name.text;
+            if ((0, config_js_1.isTranslatableProperty)(propName)) {
+                // Resolve the variable name to its string value
+                const resolved = (0, resolvers_js_1.resolveImportedString)(filePath, propName) || (0, resolvers_js_1.tryResolveExpression)(filePath, propName);
+                if (resolved && resolved.trim().length > 0 && !(0, config_js_1.isCamelCase)(resolved)) {
+                    const { parentName, objectType, nestedPath } = getParentObjectInfo(node, filePath);
+                    const contextField = nestedPath ? `${nestedPath}/${propName}` : propName;
+                    results.push({
+                        text: resolved,
+                        file: filePath,
+                        line: (0, template_processor_js_1.getLineNumber)(sourceFile, node.getStart()),
+                        context: `data-${contextField}-resolved`,
+                        original: propName,
+                        parentId: parentName,
+                        objectType,
+                    });
+                }
+            }
+        }
         // Find array literals
         // Skip DIRECT exported arrays - they're handled by extractFromToNameMaps with proper context
         // e.g., export const combatSpeeds = ["Manual", ...] - skip

package/dist/components.d.ts

@@ -32,6 +32,7 @@ export type GameButtonFC = React.ForwardRefRenderFunction<HTMLButtonElement, But
 export type GameIconButtonFC = React.ForwardRefRenderFunction<HTMLButtonElement, IconButtonProps & {
     hoverSfx?: SoundEffectName;
     clickSfx?: SoundEffectName;
+    tooltip?: ReactNode;
 }>;
 export type GameCloseButtonFC = React.ForwardRefRenderFunction<HTMLButtonElement, Omit<IconButtonProps & {
     hoverSfx?: SoundEffectName;

package/dist/element.js

@@ -32,7 +32,7 @@ export const elementToColour = {
     celestial: 'radial-gradient(white 30%, black)',
     cloud: 'radial-gradient(teal 50%, black)',
     blossom: 'radial-gradient(#d654b9 50%, black)',
-    none: 'radial-gradient(rgb(14, 14, 14) 50%, black)',
+    none: 'radial-gradient(rgb(53, 53, 53) 50%, black 85%)',
 };
 export const elementToColourRaw = {
     weapon: 'steelblue',

package/dist/entity.d.ts

@@ -62,7 +62,10 @@ export interface PlayerEntity {
     clothing: ItemDesc | undefined;
     talismans: (ItemDesc | undefined)[];
     artefacts: (ItemDesc | undefined)[];
-    autoUseItems?: (string | undefined)[];
+    /** @deprecated legacy only, do not use in new code */
+    autoUseItems?: (AutoUseItem | string | undefined)[];
+    currentAutoUseLoadout?: AutoUseLoadout;
+    storedAutoUseLoadouts?: AutoUseLoadout[];
     quickAccess?: (string | undefined)[];
     cauldron: ItemDesc | undefined;
     flame: ItemDesc | undefined;
@@ -329,7 +332,7 @@ export interface CombatEntity {
     partyId?: string;
     /** When true, critchance is forced to 0 for this entity (used in training ground) */
     noCrit?: boolean;
-    /** Cached hash for getVariablesFromEntity — cleared whenever stats or buffs mutate */
+    /** Cached hash for getVariablesFromEntity. Cleared whenever stats or buffs mutate. */
     _cachedHash?: string;
 }
 export type StanceRule = SingleStance | RandomStance;
@@ -358,13 +361,31 @@ export interface ConditionalCycle {
     }>;
     operator: 'AND' | 'OR';
 }
+export interface AutoUseCondition {
+    condition: string;
+    check: '<' | '==' | '>' | '!=';
+    value: number;
+}
+export interface AutoUseItem {
+    item?: string;
+    conditions?: AutoUseCondition[];
+    maxCount?: number;
+}
+export interface AutoUseLoadout {
+    id: string;
+    name: string;
+    autoName?: boolean;
+    slots: AutoUseItem[];
+}
 export interface StoredStyle {
     name: string;
     id: string;
     autoName?: boolean;
     stances: StoredStance[];
     conditionalCycles?: ConditionalCycle[];
-    autoUseItems?: (string | undefined)[];
+    /** @deprecated legacy only, do not use in new code */
+    autoUseItems?: (AutoUseItem | string | undefined)[];
+    autoUseLoadoutId?: string;
 }
 export type StoredRule = OpenerStoredRule | RotationStoredRule | ConditionalStoredRule | ConditionalRotationStoredRule;
 export interface OpenerStoredRule {

package/dist/gameVersion.d.ts

@@ -15,4 +15,4 @@
  *   };
  * }
  */
-export declare const GAME_VERSION = "0.6.51";
+export declare const GAME_VERSION = "0.6.52";

package/dist/gameVersion.js

@@ -15,4 +15,4 @@
  *   };
  * }
  */
-export const GAME_VERSION = "0.6.51";
+export const GAME_VERSION = "0.6.52";

package/dist/mod.d.ts

@@ -44,6 +44,7 @@ import type { Sex } from './entity';
 import type { DamageType } from './DamageType';
 import { AvatarEffectShader } from './avatarEffects';
 import type { Translatable, TranslatableString } from '../types/translatable';
+import type { SaveFileInfo } from './electron';
 /**
  * Sprite images for a custom player character.
  * All images should be strings (either mod:// URLs for mod assets, or data: URLs).
@@ -302,6 +303,35 @@ export interface ModReduxAPI {
          * console.log('Completion after:', preview.progressState?.completion);
          */
         previewCraftingTechnique: (technique: CraftingTechnique, state: CraftingState) => CraftingState;
+        /**
+         * Save the current game state to a character-scoped backup file. The save is
+         * written to the character's backup folder with the given filename. Throws an
+         * error if no save is currently loaded or if the save operation fails.
+         * @param filename - Name of the save file (e.g. 'quicksave-001.json')
+         * @example
+         * makeSave('quicksave-001.json'); // Save to character-backup/quicksave-001.json
+         * makeSave('backup-myprogress.json');
+         */
+        makeSave: (filename: string) => Promise<void>;
+        /**
+         * Load game state from a character-scoped backup file. The current game state
+         * will be replaced by the loaded save. Throws an error if the file cannot be
+         * read or parsed.
+         * @param filename - Name of the save file to load (must exist in character backup folder)
+         * @example
+         * loadSave('quicksave-001.json'); // Load from character-backup/quicksave-001.json
+         * loadSave('backup-myprogress.json');
+         */
+        loadSave: (filename: string) => Promise<void>;
+        /**
+         * List all backup save files available for the current character. Throws if
+         * no save is currently loaded or if the operation fails.
+         * @returns Array of save file metadata
+         * @example
+         * const saves = listSaves();
+         * saves.forEach(s => console.log(s.name, new Date(s.lastModified)));
+         */
+        listSaves: () => Promise<SaveFileInfo[]>;
     };
     components: {
         GameDialog: GameDialogFC;
@@ -480,6 +510,17 @@ export interface ModAPI {
          * @param reputation - (Optional) Required reputation tier
          */
         addItemToGuild: (item: Item, stacks: number, guild: string, rank: number, valueModifier?: number, reputation?: ReputationTier) => void;
+        /**
+         * Add an item to the sect favour exchange shop.
+         * @param item - Item to add
+         * @param stacks - Number of stacks available
+         * @param realm - Required realm tier to purchase
+         * @param valueModifier - (Optional) Price multiplier (default 1.0)
+         * @param reputation - (Optional) Required reputation tier
+         * @example
+         * addToSectShop(myItem, 3, 'qiCondensation');
+         */
+        addToSectShop: (item: Item, stacks: number, realm: Realm, valueModifier?: number, reputation?: ReputationTier) => void;
         /**
          * Add a crafting recipe to the sect recipe library.
          * @param item - Recipe item configuration
@@ -1638,7 +1679,7 @@ export interface ModAPI {
          * @param defenderProtection - Defender's protection stat
          * @returns Final damage value
          */
-        calculateDamage: (attackPower: number, defenderDefense: number, defenderDr: number, defenderDefenseFactor: number, maxReduction: number, defenderVulnerability: number, realm: Realm, realmProgress: RealmProgress, defenderProtection: number) => number;
+        calculateDamage: (attackPower: number, defenderDefense: number, defenderDr: number, defenderDefenseFactor: number, maxReduction: number, defenderVulnerability: number, realm: Realm, realmProgress: RealmProgress, defenderProtection: number, cultivatorResistance: number) => number;
         /**
          * Format a number for display (e.g. 1000 -> "1,000").
          * @param number - Number to format
@@ -2098,15 +2139,15 @@ export interface ModAPI {
         }) => void;
         /**
          * Hook fired after every Redux state update. Receives the action type, the
-         * state before the action was applied, and the state after. Return a modified
-         * copy of `stateAfter` to override what is stored, or return `stateAfter`
-         * unchanged to leave the update as-is.
+         * state before the action was applied, the state after, and a readonly copy of
+         * the action payload. Return a modified copy of `stateAfter` to override what
+         * is stored, or return `stateAfter` unchanged to leave the update as-is.
          *
          * This is called inside the reducer — keep the implementation fast and avoid
          * side-effects. Thrown exceptions are caught and logged.
          *
          * @example
-         * modAPI.hooks.onReduxAction((actionType, before, after) => {
+         * modAPI.hooks.onReduxAction((actionType, before, after, payload) => {
          *   if (actionType === 'inventory/addItem') {
          *     // double every item added in hard mode
          *     if (after.gameData.flags?.hard_mode) {
@@ -2116,7 +2157,34 @@ export interface ModAPI {
          *   return after;
          * });
          */
-        onReduxAction: (interceptor: (actionType: string, stateBefore: RootState, stateAfter: RootState) => RootState) => void;
+        onReduxAction: (interceptor: (actionType: string, stateBefore: RootState, stateAfter: RootState, payload: Readonly<unknown>) => RootState) => void;
+        /**
+         * Hook fired before a Redux action is passed to the reducer. Allows
+         * intercepting and modifying the action payload, or dropping the action
+         * entirely.
+         *
+         * Return a modified payload to replace the original (any non-null value,
+         * including `undefined`, replaces the current payload), or return `null` to
+         * drop the action (the reducer will not be called and the state will remain
+         * unchanged). When multiple interceptors are chained, each one receives the
+         * payload returned by the previous one.
+         *
+         * This is called before the reducer — keep the implementation fast and avoid
+         * side-effects. Thrown exceptions are caught and logged.
+         *
+         * @example
+         * modAPI.hooks.onReduxActionPayload((actionType, payload) => {
+         *   if (actionType === 'inventory/removeItem') {
+         *     const p = payload as { name: string; stacks: number };
+         *     // prevent blueprint removal by zeroing the stack count
+         *     if (modAPI.gameData.items[p.name]?.kind === 'blueprint') {
+         *       return { ...p, stacks: 0 };
+         *     }
+         *   }
+         *   return payload;
+         * });
+         */
+        onReduxActionPayload: (interceptor: (actionType: string, payload: unknown) => unknown | null) => void;
     };
     /**
      * Inject UI into a named slot (dialog title or screen name).

package/dist/stat.d.ts

@@ -3,7 +3,7 @@ import type { TechniqueElement } from './element';
 export declare const physicalStatistics: readonly ["eyes", "meridians", "dantian", "muscles", "digestion", "flesh"];
 export declare const socialStatistics: readonly ["age", "lifespan", "charisma", "battlesense", "craftskill", "artefactslots", "talismanslots", "condenseEfficiency", "pillsPerRound"];
 export declare const craftingStatistics: readonly ["maxpool", "pool", "maxtoxicity", "toxicity", "resistance", "itemEffectiveness", "control", "intensity", "critchance", "critmultiplier", "pillsPerRound", "poolCostPercentage", "stabilityCostPercentage", "successChanceBonus", "poolCostFlat"];
-export declare const combatStatistics: readonly ["maxhp", "hp", "maxbarrier", "barrier", "maxtoxicity", "toxicity", "resistance", "pillsPerRound", "itemEffectiveness", "power", "artefactpower", "critchance", "defense", "protection", "dr", "barrierMitigation", "lifesteal", "critmultiplier", "vulnerability", "weakness", "fistBoost", "blossomBoost", "weaponBoost", "cloudBoost", "bloodBoost", "celestialBoost", "fistAffinity", "blossomAffinity", "weaponAffinity", "cloudAffinity", "bloodAffinity", "celestialAffinity", "noneAffinity", "qiDroplets", "fistDisabled", "bloodDisabled", "blossomDisabled", "cloudDisabled", "celestialDisabled", "weaponDisabled", "noneDisabled", "pillsDisabled", "dropletsDisabled", "fistResistance", "blossomResistance", "weaponResistance", "cloudResistance", "bloodResistance", "celestialResistance", "damageBoost", "healingBoost", "barrierBoost", "overheal", "barrierBleed", "formationPartRecovery", "overcrit"];
+export declare const combatStatistics: readonly ["maxhp", "hp", "maxbarrier", "barrier", "maxtoxicity", "toxicity", "resistance", "pillsPerRound", "itemEffectiveness", "power", "artefactpower", "critchance", "defense", "protection", "dr", "barrierMitigation", "lifesteal", "critmultiplier", "vulnerability", "weakness", "fistBoost", "blossomBoost", "weaponBoost", "cloudBoost", "bloodBoost", "celestialBoost", "fistAffinity", "blossomAffinity", "weaponAffinity", "cloudAffinity", "bloodAffinity", "celestialAffinity", "noneAffinity", "qiDroplets", "fistDisabled", "bloodDisabled", "blossomDisabled", "cloudDisabled", "celestialDisabled", "weaponDisabled", "noneDisabled", "pillsDisabled", "dropletsDisabled", "fistResistance", "blossomResistance", "weaponResistance", "cloudResistance", "bloodResistance", "celestialResistance", "damageBoost", "healingBoost", "barrierBoost", "overheal", "barrierBleed", "formationPartRecovery", "overcrit", "cultivatorResistance"];
 export type PhysicalStatistic = (typeof physicalStatistics)[number];
 export type SocialStatistic = (typeof socialStatistics)[number];
 export type CraftingStatistic = (typeof craftingStatistics)[number];

package/dist/stat.js

@@ -91,6 +91,7 @@ export const combatStatistics = [
     'barrierBleed',
     'formationPartRecovery',
     'overcrit',
+    'cultivatorResistance',
 ];
 export const baseStatNumber = 10;
 export const expectedHpPerFlesh = 1000;
@@ -115,7 +116,7 @@ export const combatStatToName = {
     power: 'Power',
     artefactpower: 'Artefact Power',
     critchance: 'Crit Chance',
-    defense: 'Defense',
+    defense: 'Armour',
     protection: 'Protection',
     dr: 'Damage Resistance',
     barrierMitigation: 'Barrier Effectiveness',
@@ -161,6 +162,7 @@ export const combatStatToName = {
     barrierBleed: 'Barrier Bleed',
     formationPartRecovery: 'Formation Part Recovery',
     overcrit: 'Overcrit',
+    cultivatorResistance: 'Cultivator Resistance',
 };
 export const combatStatToDescription = {
     maxhp: 'The amount of damage you can take before you are unable to continue.',
@@ -219,6 +221,7 @@ export const combatStatToDescription = {
     barrierBleed: '',
     formationPartRecovery: '',
     overcrit: '',
+    cultivatorResistance: '',
 };
 // Uncommon stats that need auxiliary tooltips when they appear on buffs
 // These descriptions only show as aux tooltips in buff tooltips, not in the stats dialog

package/dist/technique.d.ts

@@ -69,6 +69,7 @@ interface BaseTechniqueEffect {
     condition?: TechniqueCondition;
     triggerKey?: string;
     isAdditionalTooltip?: boolean;
+    cantUpgrade?: boolean;
 }
 interface BuffSelfTechniqueEffect extends BaseTechniqueEffect {
     kind: 'buffSelf';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "afnm-types",
-  "version": "0.6.51",
+  "version": "0.6.52",
   "description": "Type definitions for Ascend From Nine Mountains",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",