afnm-types 0.6.51 → 0.6.52-v2

package/dist/avatarEffects.d.ts

@@ -10,9 +10,10 @@
 export type AvatarEffectId = 'glitch';
 export interface AvatarEffectShader {
     /**
-     * Fragment shader source. Must accept the same base uniforms as the default
-     * fragment shader (u_texA, u_texB, u_mix, u_aspectA, u_aspectB,
-     * u_canvasAspect) plus u_time (float, seconds since the effect started).
+     * Fragment shader source (GLSL ES 3.00, must begin with `#version 300 es`).
+     * Must accept the same uniforms as the base shader: u_texA, u_texB, u_mix,
+     * u_aspectA, u_aspectB, u_canvasAspect, u_time (seconds since effect started).
+     * Use `in vec2 v_uv` and `out vec4 fragColor` instead of the ES 1.00 forms.
      */
     fragSrc: string;
 }

package/dist/avatarEffects.js

@@ -11,9 +11,9 @@
 // Replicates the hand-authored glitch art style: strong persistent chromatic
 // aberration (cyan/magenta fringing always visible), periodic brightness
 // washout, and horizontal scanline tears during burst events.
-const GLITCH_FRAG_SRC = `
+const GLITCH_FRAG_SRC = `#version 300 es
 precision mediump float;
-varying vec2 v_uv;
+in vec2 v_uv;
 uniform sampler2D u_texA;
 uniform sampler2D u_texB;
 uniform float u_mix;
@@ -21,6 +21,7 @@ uniform float u_aspectA;
 uniform float u_aspectB;
 uniform float u_canvasAspect;
 uniform float u_time;
+out vec4 fragColor;
 
 float hash(float n) {
   return fract(sin(n) * 43758.5453);
@@ -39,7 +40,7 @@ vec4 sampleContain(sampler2D tex, vec2 uv, float texAspect) {
   if (mapped.x < 0.0 || mapped.x > 1.0 || mapped.y < 0.0 || mapped.y > 1.0) {
     return vec4(0.0);
   }
-  return texture2D(tex, mapped);
+  return texture(tex, mapped);
 }
 
 void main() {
@@ -86,7 +87,7 @@ void main() {
   float blowout = decay * 0.45;
   col.rgb = mix(col.rgb, vec3(1.0), blowout * col.a);
 
-  gl_FragColor = col;
+  fragColor = col;
 }`;
 // ─── Registry ─────────────────────────────────────────────────────────────────
 /**

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).
@@ -480,6 +481,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 +1650,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
@@ -1911,6 +1923,24 @@ export interface ModAPI {
          * };
          */
         tr: (key: string, variables?: Record<string, Translatable | number>, context?: string) => TranslatableString;
+        /**
+         * Save the current game state to a character-scoped backup file.
+         * Throws if no save is loaded or if the write fails.
+         * @param filename - Name of the backup file (e.g. 'quicksave-001.json')
+         */
+        makeSave: (filename: string) => Promise<void>;
+        /**
+         * Load game state from a character-scoped backup file, replacing current state.
+         * Throws if no save is loaded or if the file cannot be read.
+         * @param filename - Name of the backup file to load
+         */
+        loadSave: (filename: string) => Promise<void>;
+        /**
+         * List all backup save files available for the current character.
+         * Throws if no save is loaded.
+         * @returns Array of backup file metadata
+         */
+        listSaves: () => Promise<SaveFileInfo[]>;
     };
     hooks: {
         /**
@@ -2098,15 +2128,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 +2146,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-v2",
   "description": "Type definitions for Ascend From Nine Mountains",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/itemAction.d.ts

@@ -1,33 +0,0 @@
-import type { ReactNode } from 'react';
-import type { AppDispatch } from '../store';
-import type { BreakthroughState } from './breakthrough';
-import type { SoundEffectName } from './audio';
-import type { Item } from './item';
-import type { PlayerEntity } from './entity';
-import type { InventoryState } from './reduxState';
-interface OpenItem {
-    item: Item;
-    data: unknown;
-    onComplete: () => void;
-}
-export interface ItemActionContext {
-    item: Item;
-    player: PlayerEntity;
-    inventory: InventoryState;
-    breakthrough: BreakthroughState;
-    flags: Record<string, number | string | boolean>;
-    dispatch: AppDispatch;
-    setResult: (result: ReactNode) => void;
-    setClicked: (clicked: boolean) => void;
-    setOpenItem?: (openItem: OpenItem) => void;
-    setDoEnchant?: (doEnchant: boolean) => void;
-    setDoUpgrade?: (doUpgrade: boolean) => void;
-    setDoAppearanceChange?: (doAppearanceChange: boolean) => void;
-    playSfx: (sound: SoundEffectName) => void;
-    usageRestricted: boolean;
-}
-export interface ItemActionResult {
-    buttons: ReactNode[];
-}
-export type ItemActionHandler = (context: ItemActionContext) => ItemActionResult;
-export {};

package/dist/itemAction.js

@@ -1 +0,0 @@
-export {};

package/dist/manual.d.ts

@@ -1,8 +0,0 @@
-import { Realm } from './realm';
-export interface Manual {
-    name: string;
-    icon: string;
-    realm: Realm;
-    techniques: string[];
-    stance: string[];
-}

package/dist/manual.js

@@ -1 +0,0 @@
-export {};

package/dist/typeTests.d.ts

@@ -1,9 +0,0 @@
-/**
- * Type Tests - These files ensure type compatibility across the codebase
- * If any of these fail to compile, it means we have a type mismatch
- */
-import type { RootState as StoreRootState } from '../store';
-import type { RootState as TypesRootState } from './reduxState';
-type TestExactMatch = StoreRootState extends TypesRootState ? TypesRootState extends StoreRootState ? true : false : false;
-export type RootStateIsConsistent = TestExactMatch;
-export {};