afnm-types 0.6.54-3 → 0.6.55

package/dist/avatarEffects.js

@@ -11,83 +11,83 @@
 // 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 = `#version 300 es
-precision mediump float;
-in vec2 v_uv;
-uniform sampler2D u_texA;
-uniform sampler2D u_texB;
-uniform float u_mix;
-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);
-}
-
-vec4 sampleContain(sampler2D tex, vec2 uv, float texAspect) {
-  float rel = texAspect / u_canvasAspect;
-  vec2 scale;
-  if (rel > 1.0) {
-    scale = vec2(1.0, 1.0 / rel);
-  } else {
-    scale = vec2(rel, 1.0);
-  }
-  vec2 offset = (1.0 - scale) * 0.5;
-  vec2 mapped = (uv - offset) / scale;
-  if (mapped.x < 0.0 || mapped.x > 1.0 || mapped.y < 0.0 || mapped.y > 1.0) {
-    return vec4(0.0);
-  }
-  return texture(tex, mapped);
-}
-
-void main() {
-  vec2 uv = v_uv;
-
-  // Glitch burst timing — ~0.8 event slots per second, 35% chance each.
-  float eventT = floor(u_time * 0.8);
-  float isGlitching = step(0.65, hash(eventT * 1.618));
-  // Sharp onset, slow decay — the burst lingers before fading.
-  float slotFrac = fract(u_time * 0.8);
-  float decay = (1.0 - smoothstep(0.1, 0.9, slotFrac)) * isGlitching;
-
-  // Band-based horizontal displacement (scanline tearing) during bursts.
-  float band = floor(uv.y * 24.0);
-  float bandActive = step(0.55, hash(band + eventT * 23.7));
-  float bandShift = (hash(band * 5.2 + eventT * 7.1) * 2.0 - 1.0) * 0.025;
-  float shift = bandShift * bandActive * decay;
-
-  // Occasional large block tears.
-  float bigTear = step(0.92, hash(band * 3.7 + eventT * 11.3));
-  shift += (hash(band * 9.1 + eventT * 4.7) * 2.0 - 1.0) * 0.08 * bigTear * decay;
-
-  vec2 shiftedUv = vec2(uv.x + shift, uv.y);
-
-  // Chromatic aberration: strong baseline always present, amplified by bursts.
-  float aberr = 0.012 + 0.018 * decay;
-
-  float rA = sampleContain(u_texA, vec2(shiftedUv.x + aberr, shiftedUv.y), u_aspectA).r;
-  float gA = sampleContain(u_texA, shiftedUv, u_aspectA).g;
-  float bA = sampleContain(u_texA, vec2(shiftedUv.x - aberr, shiftedUv.y), u_aspectA).b;
-  float aA = sampleContain(u_texA, shiftedUv, u_aspectA).a;
-  vec4 colA = vec4(rA, gA, bA, aA);
-
-  float rB = sampleContain(u_texB, vec2(shiftedUv.x + aberr, shiftedUv.y), u_aspectB).r;
-  float gB = sampleContain(u_texB, shiftedUv, u_aspectB).g;
-  float bB = sampleContain(u_texB, vec2(shiftedUv.x - aberr, shiftedUv.y), u_aspectB).b;
-  float aB = sampleContain(u_texB, shiftedUv, u_aspectB).a;
-  vec4 colB = vec4(rB, gB, bB, aB);
-
-  vec4 col = mix(colA, colB, u_mix);
-
-  // Brightness washout during bursts — push toward overexposed white,
-  // scaled by alpha so transparent edges don't bloom.
-  float blowout = decay * 0.45;
-  col.rgb = mix(col.rgb, vec3(1.0), blowout * col.a);
-
-  fragColor = col;
+const GLITCH_FRAG_SRC = `#version 300 es
+precision mediump float;
+in vec2 v_uv;
+uniform sampler2D u_texA;
+uniform sampler2D u_texB;
+uniform float u_mix;
+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);
+}
+
+vec4 sampleContain(sampler2D tex, vec2 uv, float texAspect) {
+  float rel = texAspect / u_canvasAspect;
+  vec2 scale;
+  if (rel > 1.0) {
+    scale = vec2(1.0, 1.0 / rel);
+  } else {
+    scale = vec2(rel, 1.0);
+  }
+  vec2 offset = (1.0 - scale) * 0.5;
+  vec2 mapped = (uv - offset) / scale;
+  if (mapped.x < 0.0 || mapped.x > 1.0 || mapped.y < 0.0 || mapped.y > 1.0) {
+    return vec4(0.0);
+  }
+  return texture(tex, mapped);
+}
+
+void main() {
+  vec2 uv = v_uv;
+
+  // Glitch burst timing — ~0.8 event slots per second, 35% chance each.
+  float eventT = floor(u_time * 0.8);
+  float isGlitching = step(0.65, hash(eventT * 1.618));
+  // Sharp onset, slow decay — the burst lingers before fading.
+  float slotFrac = fract(u_time * 0.8);
+  float decay = (1.0 - smoothstep(0.1, 0.9, slotFrac)) * isGlitching;
+
+  // Band-based horizontal displacement (scanline tearing) during bursts.
+  float band = floor(uv.y * 24.0);
+  float bandActive = step(0.55, hash(band + eventT * 23.7));
+  float bandShift = (hash(band * 5.2 + eventT * 7.1) * 2.0 - 1.0) * 0.025;
+  float shift = bandShift * bandActive * decay;
+
+  // Occasional large block tears.
+  float bigTear = step(0.92, hash(band * 3.7 + eventT * 11.3));
+  shift += (hash(band * 9.1 + eventT * 4.7) * 2.0 - 1.0) * 0.08 * bigTear * decay;
+
+  vec2 shiftedUv = vec2(uv.x + shift, uv.y);
+
+  // Chromatic aberration: strong baseline always present, amplified by bursts.
+  float aberr = 0.012 + 0.018 * decay;
+
+  float rA = sampleContain(u_texA, vec2(shiftedUv.x + aberr, shiftedUv.y), u_aspectA).r;
+  float gA = sampleContain(u_texA, shiftedUv, u_aspectA).g;
+  float bA = sampleContain(u_texA, vec2(shiftedUv.x - aberr, shiftedUv.y), u_aspectA).b;
+  float aA = sampleContain(u_texA, shiftedUv, u_aspectA).a;
+  vec4 colA = vec4(rA, gA, bA, aA);
+
+  float rB = sampleContain(u_texB, vec2(shiftedUv.x + aberr, shiftedUv.y), u_aspectB).r;
+  float gB = sampleContain(u_texB, shiftedUv, u_aspectB).g;
+  float bB = sampleContain(u_texB, vec2(shiftedUv.x - aberr, shiftedUv.y), u_aspectB).b;
+  float aB = sampleContain(u_texB, shiftedUv, u_aspectB).a;
+  vec4 colB = vec4(rB, gB, bB, aB);
+
+  vec4 col = mix(colA, colB, u_mix);
+
+  // Brightness washout during bursts — push toward overexposed white,
+  // scaled by alpha so transparent edges don't bloom.
+  float blowout = decay * 0.45;
+  col.rgb = mix(col.rgb, vec3(1.0), blowout * col.a);
+
+  fragColor = col;
 }`;
 // ─── Registry ─────────────────────────────────────────────────────────────────
 /**

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

@@ -357,9 +357,6 @@ async function main() {
     console.log(`  1. Open ${templatePath}`);
     console.log('  2. Copy it to a new language file, e.g. translations/ru.json');
     console.log('  3. Fill in the translated values for each key');
-    console.log('  4. Register the translations in your mod:');
-    console.log("       import ruTranslations from './translations/ru.json';");
-    console.log("       api.addTranslation('ru', ruTranslations);");
 }
 main().catch((error) => {
     console.error('Fatal error:', error);

package/dist/gameVersion.d.ts

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

package/dist/gameVersion.js

@@ -15,4 +15,4 @@
  *   };
  * }
  */
-export const GAME_VERSION = "0.6.54";
+export const GAME_VERSION = "0.6.55";

package/dist/keybindings.d.ts

@@ -7,8 +7,16 @@ export interface KeybindingDefinition {
     description: string;
     defaultKey: string;
     allowRebind: boolean;
+    modName?: string;
 }
 export type KeybindingsMap = Record<KeybindingAction | string, string>;
+export interface RegisteredKeybind {
+    displayText: string;
+    code: string;
+    ctrlKey: boolean;
+    altKey: boolean;
+    shiftKey: boolean;
+}
 export declare const keybindingDefinitions: KeybindingDefinition[];
 export declare const keybindingCategoryInfo: Record<KeybindingCategory, {
     name: string;
@@ -34,8 +42,9 @@ export declare function parseKeybindingString(keybinding: string | undefined | n
     shift: boolean;
 };
 export declare function matchesKeybinding(event: KeyboardEvent, keybinding: string): boolean;
-export declare function getKeyDisplayName(keybinding: string | undefined | null): string;
-export declare function getKeyShortDisplayName(keybinding: string | undefined | null): string;
+export declare function matchKeybinding(event: KeyboardEvent, keybind: RegisteredKeybind): boolean;
+export declare function getKeyDisplayName(keybinding: string | RegisteredKeybind | undefined | null): string;
+export declare function getKeyShortDisplayName(keybinding: string | RegisteredKeybind | undefined | null): string;
 export declare function isModifierKey(key: string): boolean;
 export declare function isKeyAllowed(key: string): boolean;
 export declare function getKeybindingsByCategory(category: KeybindingCategory): KeybindingDefinition[];

package/dist/keybindings.js

@@ -964,6 +964,13 @@ export function matchesKeybinding(event, keybinding) {
         event.altKey === parsed.alt &&
         event.shiftKey === parsed.shift);
 }
+// Check if a keyboard event matches a registered keybind
+export function matchKeybinding(event, keybind) {
+    return (event.code === keybind.code &&
+        event.ctrlKey === keybind.ctrlKey &&
+        event.altKey === keybind.altKey &&
+        event.shiftKey === keybind.shiftKey);
+}
 const singleKeyDisplayNames = {
     Enter: 'Enter',
     Escape: 'Esc',
@@ -986,9 +993,10 @@ const singleKeyDisplayNames = {
 // Helper to get display name for a key (full version)
 export function getKeyDisplayName(keybinding) {
     var _a;
-    if (!keybinding)
+    const displayText = typeof keybinding === 'object' && keybinding !== null ? keybinding.displayText : keybinding;
+    if (!displayText)
         return '';
-    const parsed = parseKeybindingString(keybinding);
+    const parsed = parseKeybindingString(displayText);
     let result = '';
     if (parsed.ctrl)
         result += 'Ctrl+';
@@ -1002,9 +1010,10 @@ export function getKeyDisplayName(keybinding) {
 // Helper to get short display name for a key (compact version for UI previews)
 export function getKeyShortDisplayName(keybinding) {
     var _a;
-    if (!keybinding)
+    const displayText = typeof keybinding === 'object' && keybinding !== null ? keybinding.displayText : keybinding;
+    if (!displayText)
         return '';
-    const parsed = parseKeybindingString(keybinding);
+    const parsed = parseKeybindingString(displayText);
     let result = '';
     if (parsed.ctrl)
         result += 'C+';

package/dist/mod.d.ts

@@ -47,7 +47,7 @@ import type { DamageType } from './DamageType';
 import { AvatarEffectShader } from './avatarEffects';
 import type { Translatable, TranslatableString } from './translatable';
 import type { SaveFileInfo } from './electron';
-import type { KeybindingDefinition } from './keybindings';
+import type { KeybindingDefinition, RegisteredKeybind } from './keybindings';
 import { ScreenType } from './GameScreen';
 export type SkipDialogueMode = 'flash' | 'silent';
 export type Sexuality = 'straight' | 'gay' | 'bisexual';
@@ -73,7 +73,7 @@ export interface GameSettingsProps {
     eventHistoryLimit: number;
     setEventHistoryLimit: (value: number) => void;
 }
-export type InjectPosition = 'inside' | 'before' | 'after';
+export type InjectPosition = 'before' | 'after';
 export interface NewGameIntent {
     items: ItemDesc[];
     techniques: string[];
@@ -2062,14 +2062,17 @@ export interface ModAPI {
          * Use this to check what key is currently bound to an action, useful for
          * displaying key hints in custom UI or handling key events outside React components.
          * @param action - The action name (e.g., 'myMod.specialAction')
-         * @returns The current bound key string (e.g., 'F12'), or undefined if not bound
+         * @returns The keybind info including displayText (e.g., 'Shift+F12'), code (e.g., 'F12'),
+         *          and modifier booleans (ctrlKey, altKey, shiftKey), or undefined if not bound
          * @example
          * const key = modAPI.utils.getRegisteredKeybindValue('myMod.specialAction');
          * if (key) {
-         *   console.log(`Special action is bound to ${key}`);
+         *   console.log(`Special action is bound to ${key.displayText}`);
+         *   // Match against KeyboardEvent:
+         *   // if (event.code === key.code && event.shiftKey === key.shiftKey) { ... }
          * }
          */
-        getRegisteredKeybindValue: (action: string) => string | undefined;
+        getRegisteredKeybindValue: (action: string) => RegisteredKeybind | undefined;
         /**
          *
          * @returns true if a save is currently loaded and game state is available, false otherwise.
@@ -2369,43 +2372,44 @@ export interface ModAPI {
          */
         onReduxActionPayload: (interceptor: (actionType: string, payload: unknown, stateBefore: RootState) => unknown | null) => void;
         /**
-         * Called before the equipment upgrade dialog is shown. Allows mutating upgrade cost items and result (but not base item).
+         * Called before the equipment upgrade dialog is shown. Allows mutating upgrade cost items and
+         * result item quality tier (but not base item).
          *
          * @example
-         * modAPI.hooks.onDeriveEquipmentUpgradeRequirement((baseItem, costItems, resultItem, flags) => {
-         *   // Modify the cost items (e.g., add additional requirements)
-         *   return { costItems: [...costItems, additionalItem], resultItem };
+         * modAPI.hooks.onDeriveEquipmentUpgradeRequirement((baseItem, costItems, resultItemName, resultQualityTier, flags) => {
+         *   // Override the result quality tier
+         *   return { costItems, resultItemName, resultQualityTier: resultQualityTier + 2 };
          * });
          */
-        onDeriveEquipmentUpgradeRequirement: (interceptor: (baseItem: Item, costItems: Item[], resultItem: Item, gameFlags: Record<string, number>) => {
+        onDeriveEquipmentUpgradeRequirement: (interceptor: (baseItem: Item, costItems: Item[], resultItemName: string, resultQualityTier: number, gameFlags: Record<string, number>) => {
             costItems?: Item[];
-            resultItem?: Item;
+            resultItemName?: string;
+            resultQualityTier?: number;
         } | undefined) => void;
         /**
-         * Called before the completion dialog showing the upgraded equipment. Allows mutating upgrade cost items and result (but not base item).
+         * Called when an equipment upgrade completes. Read-only: cannot modify the result item.
+         * Use onDeriveEquipmentUpgradeRequirement to change the result before the upgrade.
          *
          * @example
          * modAPI.hooks.onCompleteEquipmentUpgrade((baseItem, costItems, resultItem, flags) => {
-         *   // Boost the result item's stats
-         *   return { costItems, resultItem: { ...resultItem, damage: (resultItem.damage ?? 0) + 10 } };
+         *   // React to the upgrade (e.g., trigger a side effect)
          * });
          */
-        onCompleteEquipmentUpgrade: (interceptor: (baseItem: Item, costItems: Item[], resultItem: Item, gameFlags: Record<string, number>) => {
-            costItems?: Item[];
-            resultItem?: Item;
-        } | undefined) => void;
+        onCompleteEquipmentUpgrade: (interceptor: (baseItem: Item, costItems: Item[], resultItem: Item, gameFlags: Record<string, number>) => void) => void;
         /**
-         * Called before the equipment reforge dialog is shown. Allows mutating reforge cost items and result (but not base item).
+         * Called before the equipment reforge dialog is shown. Allows mutating reforge cost items and
+         * result item quality tier (but not base item).
          *
          * @example
-         * modAPI.hooks.onDeriveEquipmentReforgeRequirement((baseItem, costItems, resultItem, flags) => {
-         *   // Modify the result item
-         *   return { costItems, resultItem: { ...resultItem, qualityTier: (resultItem.qualityTier ?? 0) + 1 } };
+         * modAPI.hooks.onDeriveEquipmentReforgeRequirement((baseItem, costItems, resultItemName, resultQualityTier, flags) => {
+         *   // Override the result quality tier (e.g., set to max)
+         *   return { costItems, resultItemName, resultQualityTier: 10 };
          * });
          */
-        onDeriveEquipmentReforgeRequirement: (interceptor: (baseItem: Item, costItems: Item[], resultItem: Item, gameFlags: Record<string, number>) => {
+        onDeriveEquipmentReforgeRequirement: (interceptor: (baseItem: Item, costItems: Item[], resultItemName: string, resultQualityTier: number, gameFlags: Record<string, number>) => {
             costItems?: Item[];
-            resultItem?: Item;
+            resultItemName?: string;
+            resultQualityTier?: number;
         } | undefined) => void;
         /**
          * Called before the completion dialog showing the reforged equipment. Allows mutating reforge cost items and result (but not base item).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "afnm-types",
-  "version": "0.6.54-3",
+  "version": "0.6.55",
   "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 {};