afnm-types 0.6.52-v2 → 0.6.53

package/dist/GameScreen.d.ts

@@ -1 +1,2 @@
 export type GameScreen = 'location' | 'recipe' | 'mission' | 'craftingHall' | 'manual' | 'cultivation' | 'map' | 'healer' | 'market' | 'favour' | 'herbField' | 'mine' | 'recipeLibrary' | 'requestBoard' | 'compendium' | 'library' | 'altar' | 'research' | 'reforge' | 'pillarGrid' | 'fallenStar' | 'trainingGround' | 'tenThousandFlames' | 'lifeScreen' | 'soulShardDelve' | 'enchantmentShop' | 'challengeBoard';
+export type ScreenType = GameScreen | 'newgame' | 'combat' | 'crafting' | 'dualCultivation' | 'event' | 'auction' | 'mysticalRegion' | 'tournament' | 'house' | 'guild' | 'stoneCutting' | 'fallenStar' | 'soulShardDelve';

package/dist/cli/extract-mod-translations/index.js

@@ -326,7 +326,7 @@ async function main() {
     console.log(`Template-ready strings : ${templateStrings.length}`);
     // Generate hierarchical template
     console.log('\nGenerating translation template...');
-    const template = (0, reporters_js_1.generateHierarchicalTemplate)(templateStrings);
+    const template = (0, reporters_js_1.generateHierarchicalTemplate)(templateStrings, undefined, undefined, false);
     const sortedTemplate = deepSortObject(template);
     const stringCount = countHierarchicalStrings(sortedTemplate);
     console.log(`  ${stringCount} unique translatable entries found.`);

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

@@ -243,7 +243,7 @@ function findMinimalUniquePaths(paths) {
  * - If different texts have same simple field -> use minimal unique path prefix
  * - If text is unique for its simple field -> just use simple field
  */
-function generateHierarchicalTemplate(allStrings, techniqueTooltipsData, textsRequiringContext) {
+function generateHierarchicalTemplate(allStrings, techniqueTooltipsData, textsRequiringContext, includeRootPatterns = true) {
     const template = {};
     const intermediate = new Map();
     // Helper to add entry to intermediate structure
@@ -637,37 +637,39 @@ function generateHierarchicalTemplate(allStrings, techniqueTooltipsData, textsRe
             }
         }
     }
-    // Add hardcoded patterns to a special category
-    if (!template['_patterns']) {
-        template['_patterns'] = {};
-    }
-    if (!template['_patterns']['hardcoded']) {
-        template['_patterns']['hardcoded'] = {};
-    }
-    // Add stack-related strings
-    template['_patterns']['hardcoded']['[word] stack'] = '';
-    template['_patterns']['hardcoded']['[word] stacks'] = '';
-    // Add dynamic template patterns
-    for (const tmpl of config_js_1.HARDCODED_TEMPLATE_PATTERNS) {
-        template['_patterns']['hardcoded'][`[template] ${tmpl}`] = '';
-    }
-    // Add condition words
-    if (!template['_patterns']['conditions']) {
-        template['_patterns']['conditions'] = {};
-    }
-    for (const word of config_js_1.CONDITION_WORDS) {
-        template['_patterns']['conditions'][`[word] ${word}`] = '';
-    }
-    // Add condition template strings from describeTechniqueCondition.ts and describeCraftingTechniqueCondition.ts
-    for (const tmpl of config_js_1.CONDITION_TEMPLATES) {
-        template['_patterns']['conditions'][`[condition] ${tmpl}`] = '';
-    }
-    // Add requirement strings
-    if (!template['_patterns']['requirements']) {
-        template['_patterns']['requirements'] = {};
-    }
-    for (const reqStr of config_js_1.REQUIREMENT_STRINGS) {
-        template['_patterns']['requirements'][`[requirement] ${reqStr}`] = '';
+    // Add hardcoded patterns to a special category (only when extracting for the game, not for mods)
+    if (includeRootPatterns) {
+        if (!template['_patterns']) {
+            template['_patterns'] = {};
+        }
+        if (!template['_patterns']['hardcoded']) {
+            template['_patterns']['hardcoded'] = {};
+        }
+        // Add stack-related strings
+        template['_patterns']['hardcoded']['[word] stack'] = '';
+        template['_patterns']['hardcoded']['[word] stacks'] = '';
+        // Add dynamic template patterns
+        for (const tmpl of config_js_1.HARDCODED_TEMPLATE_PATTERNS) {
+            template['_patterns']['hardcoded'][`[template] ${tmpl}`] = '';
+        }
+        // Add condition words
+        if (!template['_patterns']['conditions']) {
+            template['_patterns']['conditions'] = {};
+        }
+        for (const word of config_js_1.CONDITION_WORDS) {
+            template['_patterns']['conditions'][`[word] ${word}`] = '';
+        }
+        // Add condition template strings from describeTechniqueCondition.ts and describeCraftingTechniqueCondition.ts
+        for (const tmpl of config_js_1.CONDITION_TEMPLATES) {
+            template['_patterns']['conditions'][`[condition] ${tmpl}`] = '';
+        }
+        // Add requirement strings
+        if (!template['_patterns']['requirements']) {
+            template['_patterns']['requirements'] = {};
+        }
+        for (const reqStr of config_js_1.REQUIREMENT_STRINGS) {
+            template['_patterns']['requirements'][`[requirement] ${reqStr}`] = '';
+        }
     }
     return template;
 }

package/dist/components.d.ts

@@ -1,5 +1,5 @@
 import type { Breakpoint, ButtonProps, IconButtonProps } from '@mui/material';
-import type { ReactNode, PropsWithChildren } from 'react';
+import type { ReactNode, PropsWithChildren, ReactElement } from 'react';
 import type { SoundEffectName } from './audio';
 import type { ScreenEffectType } from './ScreenEffectType';
 import type React from 'react';
@@ -55,4 +55,22 @@ export interface BackgroundImageProps {
 }
 export type BackgroundImageFC = React.FC<BackgroundImageProps>;
 export type MemoBackgroundImageFC = React.NamedExoticComponent<BackgroundImageProps>;
+export interface GameTooltipProps {
+    provider: () => ReactNode;
+    children: ReactElement;
+    flipped?: boolean;
+    disabled?: boolean;
+    minimal?: boolean;
+}
+export interface GameTooltipBoxProps {
+    isSecondary?: boolean;
+    isAux?: boolean;
+    removeWidthLimit?: boolean;
+}
+export interface TooltipLineProps {
+    children?: React.ReactNode;
+}
+export type GameTooltipFC = React.FC<GameTooltipProps>;
+export type GameTooltipBoxFC = React.FC<PropsWithChildren<GameTooltipBoxProps>>;
+export type TooltipLineFC = React.ComponentType<TooltipLineProps>;
 export {};

package/dist/craftingState.d.ts

@@ -27,7 +27,7 @@ export interface HarmonyData {
     inscribedPatterns?: InscribedPatternsData;
     resonance?: ResonanceData;
     recommendedTechniqueTypes: CraftingTechniqueType[];
-    additionalData?: any;
+    additionalData?: unknown;
 }
 export interface CraftingEffectTracking {
     icon: string;

package/dist/dualCultivation.d.ts

@@ -1,10 +1,10 @@
 import type { Translatable } from './translatable';
-declare const intimateStats: readonly ["satisfaction", "energy", "painThreshold"];
-export type IntimateStat = (typeof intimateStats)[number];
-declare const intimateResources: readonly ["pain", "harmony", "excitement", "rhythm"];
-export type IntimateResource = (typeof intimateResources)[number];
-declare const intimateTechniqueTypes: readonly ["rough", "tender", "passionate"];
-export type IntimateTechniqueType = (typeof intimateTechniqueTypes)[number];
+declare const _intimateStats: readonly ["satisfaction", "energy", "painThreshold"];
+export type IntimateStat = (typeof _intimateStats)[number];
+declare const _intimateResources: readonly ["pain", "harmony", "excitement", "rhythm"];
+export type IntimateResource = (typeof _intimateResources)[number];
+declare const _intimateTechniqueTypes: readonly ["rough", "tender", "passionate"];
+export type IntimateTechniqueType = (typeof _intimateTechniqueTypes)[number];
 export declare const intimateTechniqueTypeToName: Record<IntimateTechniqueType, string>;
 export declare const intimateResourceToName: Record<IntimateResource, string>;
 export declare const dualCultivationCompletionStateToName: Record<string, string>;

package/dist/dualCultivation.js

@@ -1,6 +1,6 @@
-const intimateStats = ['satisfaction', 'energy', 'painThreshold'];
-const intimateResources = ['pain', 'harmony', 'excitement', 'rhythm'];
-const intimateTechniqueTypes = ['rough', 'tender', 'passionate'];
+const _intimateStats = ['satisfaction', 'energy', 'painThreshold'];
+const _intimateResources = ['pain', 'harmony', 'excitement', 'rhythm'];
+const _intimateTechniqueTypes = ['rough', 'tender', 'passionate'];
 export const intimateTechniqueTypeToName = {
     rough: 'Rough',
     tender: 'Tender',

package/dist/entity.js

@@ -1,4 +1,11 @@
-export const entityTypes = ['Player', 'Lifeform', 'Enemy', 'PlayerParty', 'EnemyParty', 'System'];
+export const entityTypes = [
+    'Player',
+    'Lifeform',
+    'Enemy',
+    'PlayerParty',
+    'EnemyParty',
+    'System',
+];
 export const sexes = ['male', 'female'];
 export const sexToName = {
     male: 'Male',

package/dist/gameVersion.d.ts

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

package/dist/gameVersion.js

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

package/dist/mod.d.ts

@@ -6,6 +6,8 @@ import type { AuctionItemDef, AuctionItem } from './auction';
 import type { Background } from './background';
 import type { Breakthrough } from './breakthrough';
 import type { Buff } from './buff';
+import type { BreakthroughState } from './breakthrough';
+import type { CharactersState } from './reduxState';
 import type { CalendarEvent } from './calendar';
 import type { Character } from './character';
 import type { CraftingTechnique, CraftingRecipeStats } from './craftingTechnique';
@@ -35,7 +37,7 @@ import type { ItemKind } from './item';
 import type { SoundEffectName } from './audio';
 import type { ScreenEffectType } from './ScreenEffectType';
 import type { RootState } from './reduxState';
-import type { GameDialogFC, GameButtonExoticFC, GameIconButtonExoticFC, MemoBackgroundImageFC } from './components';
+import type { GameDialogFC, GameButtonExoticFC, GameIconButtonExoticFC, MemoBackgroundImageFC, GameTooltipFC, GameTooltipBoxFC, TooltipLineFC } from './components';
 import type { PuppetType } from './trainingGround';
 import type { TechniqueElement } from './element';
 import type { AlternativeStart } from './alternativeStart';
@@ -43,8 +45,10 @@ import type { Tutorial } from './tutorial';
 import type { Sex } from './entity';
 import type { DamageType } from './DamageType';
 import { AvatarEffectShader } from './avatarEffects';
-import type { Translatable, TranslatableString } from '../types/translatable';
+import type { Translatable, TranslatableString } from './translatable';
 import type { SaveFileInfo } from './electron';
+import type { KeybindingDefinition } from './keybindings';
+import { ScreenType } from './GameScreen';
 /**
  * Sprite images for a custom player character.
  * All images should be strings (either mod:// URLs for mod assets, or data: URLs).
@@ -163,7 +167,7 @@ export interface ModReduxAPI {
          * @example
          * setModData('myMod', 'customNPC_affinity', { npcId: 'elder_li', value: 75 });
          */
-        setModData: (modName: string, key: string, data: any) => void;
+        setModData: (modName: string, key: string, data: unknown) => void;
         /**
          * Move player to a different location on the world map.
          * @param location - Location key from the locations data
@@ -310,6 +314,14 @@ export interface ModReduxAPI {
         GameIconButton: GameIconButtonExoticFC;
         BackgroundImage: MemoBackgroundImageFC;
         PlayerComponent: React.FC;
+        GameTooltip: GameTooltipFC;
+        GameTooltipBox: GameTooltipBoxFC;
+        TooltipLine: TooltipLineFC;
+    };
+    utils: {
+        parseTooltipLine: (tooltip: string) => React.ReactNode;
+        expandTooltipTemplate: (template: string, templateValues: Map<string, string>, addPeriod?: boolean) => string;
+        expandTooltipTags: (template: string) => string;
     };
 }
 export type ModScreenFC = React.FC<{
@@ -1033,6 +1045,22 @@ export interface ModAPI {
          * const highScore = flags['myMod_highScore'] ?? 0;
          */
         getGlobalFlags: () => Record<string, number>;
+        /**
+         * Register a custom keybinding for your mod.
+         * Once registered, the keybinding is permanent for the session (mods cannot be unloaded without restarting the game).
+         * Users can rebind registered keybindings in the game settings Controls tab.
+         * @param definition - The keybinding definition including action name, category, display name, and default key
+         * @example
+         * registerKeybinding({
+         *   action: 'myMod.specialAction',
+         *   category: 'general',
+         *   displayName: 'Special Action',
+         *   description: 'Performs a special action',
+         *   defaultKey: 'F',
+         *   allowRebind: true,
+         * });
+         */
+        registerKeybinding: (definition: KeybindingDefinition) => void;
     };
     utils: {
         /**
@@ -1941,8 +1969,74 @@ export interface ModAPI {
          * @returns Array of backup file metadata
          */
         listSaves: () => Promise<SaveFileInfo[]>;
+        /**
+         * Display a toast notification on the screen.
+         * @param message - The text message or ReactNode to display
+         * @param timeout - Optional timeout in milliseconds (default 3000ms)
+         * @param style - Optional toast style: 'info' (default), 'success', 'warning', 'error'
+         * @param customStyle - Optional custom styling { bg?, border?, color? }
+         * @example
+         * showToast('Item added to inventory');
+         * showToast('Quest completed!', 5000);
+         * showToast('Warning message', 3000, 'warning');
+         * showToast('Error!', 5000, 'error');
+         * showToast(<div><button>Click me</button></div>, 5000, 'info', { bg: '#ff0000', color: '#ffffff' });
+         */
+        showToast: (message: React.ReactNode, timeout?: number, style?: 'info' | 'success' | 'warning' | 'error', customStyle?: {
+            bg?: string;
+            border?: string;
+            color?: string;
+        }) => void;
+        /**
+         * Determine the current screen/game state from the Redux root state.
+         * @param rootState - The Redux root state
+         * @returns The current screen type identifier
+         * @example
+         * const screen = determineCurrentScreen(store.getState());
+         */
+        determineCurrentScreen: (rootState: RootState) => ScreenType;
     };
     hooks: {
+        /**
+         * Hook into player combat entity creation to modify stats.
+         * @param interceptor - Function to modify combat entity
+         * @example
+         * onCreatePlayerCombatEntity((player, combatEntity, breakthrough, flags) => {
+         *   if (flags.enhanced_powers) {
+         *     combatEntity.stats.power *= 1.2;
+         *   }
+         *   return combatEntity;
+         * });
+         */
+        onCreatePlayerCombatEntity: (interceptor: (player: PlayerEntity, combatEntity: CombatEntity, breakthrough: BreakthroughState, gameFlags: Record<string, number>) => CombatEntity) => void;
+        /**
+         * Hook into player crafting entity creation to modify stats.
+         * @param interceptor - Function to modify crafting entity
+         * @example
+         * onCreatePlayerCraftingEntity((player, craftingEntity, breakthrough, characters, flags) => {
+         *   if (flags.master_craftsman) {
+         *     craftingEntity.stats.control *= 1.2;
+         *   }
+         *   return craftingEntity;
+         * });
+         */
+        onCreatePlayerCraftingEntity: (interceptor: (player: PlayerEntity, craftingEntity: CraftingEntity, breakthrough: BreakthroughState, characters: CharactersState | undefined, gameFlags: Record<string, number>) => CraftingEntity) => void;
+        /**
+         * Hook called before crafting begins to modify recipe, recipe stats, or player.
+         * @param interceptor - Function returning modified recipe/stats/player or undefined
+         * @example
+         * onBeforeCraft((player, recipe, recipeStats, flags) => {
+         *   if (flags.sharp_tools && recipeStats.difficulty > 100) {
+         *     return { recipeStats: { ...recipeStats, difficulty: recipeStats.difficulty * 0.9 } };
+         *   }
+         *   return undefined;
+         * });
+         */
+        onBeforeCraft: (interceptor: (player: CraftingEntity, recipe: RecipeItem, recipeStats: CraftingRecipeStats, gameFlags: Record<string, number>) => {
+            recipe?: RecipeItem;
+            recipeStats?: CraftingRecipeStats;
+            player?: CraftingEntity;
+        } | undefined) => void;
         /**
          * Hook into enemy combat entity creation to modify stats.
          * @param interceptor - Function to modify combat entity

package/dist/reduxState.d.ts

@@ -62,6 +62,7 @@ export interface InventoryState {
     recipes: RecipeState[];
     money: number;
     favour: number;
+    favoritedItems?: string[];
 }
 export interface StanceTracking {
     techniques: string[];
@@ -275,7 +276,7 @@ export interface HouseState {
 }
 export interface ModSliceProps {
     activeMods: string[];
-    data: Record<string, Record<string, any>>;
+    data: Record<string, Record<string, unknown>>;
 }
 export interface DualCultivationState {
     partner?: {

package/package.json

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