afnm-types 0.6.54 → 0.6.55-injecttest

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

@@ -1,14 +1,22 @@
 export type KeybindingCategory = 'general' | 'navigation' | 'ui' | 'world' | 'combat' | 'crafting' | 'dialogs' | 'gamepad';
 export type KeybindingAction = 'confirm' | 'cancel' | 'pause' | 'alternateConfirm' | 'moveUp' | 'moveDown' | 'moveLeft' | 'moveRight' | 'openInventory' | 'openQuests' | 'openCharacterStats' | 'openTechniques' | 'openCalendar' | 'openWorldMap' | 'combatSelectStance0' | 'combatSelectStance1' | 'combatSelectStance2' | 'combatSelectStance3' | 'combatSelectStance4' | 'combatSelectStance5' | 'combatSelectStance6' | 'combatSelectStance7' | 'combatSelectStance8' | 'combatSelectStance9' | 'combatToggleSpeed' | 'combatToggleLog' | 'combatShowStats' | 'combatAutoBattle' | 'combatUseItem' | 'combatCancel' | 'craftingAction1' | 'craftingAction2' | 'craftingAction3' | 'craftingAction4' | 'craftingAction5' | 'craftingAction6' | 'craftingAction7' | 'craftingAction8' | 'craftingAction9' | 'craftingAction10' | 'craftingAction11' | 'craftingAction12' | 'craftingAction13' | 'craftingAction14' | 'craftingAction15' | 'craftingAction16' | 'craftingAction17' | 'craftingAction18' | 'craftingAction19' | 'craftingAction20' | 'craftingAction21' | 'craftingAction22' | 'craftingAction23' | 'craftingAction24' | 'craftingAction25' | 'craftingAction26' | 'craftingAction27' | 'craftingAction28' | 'craftingAction29' | 'craftingAction30' | 'craftingAction31' | 'craftingAction32' | 'craftingAction33' | 'craftingAction34' | 'craftingAction35' | 'craftingAction36' | 'craftingAction37' | 'craftingAction38' | 'craftingAction39' | 'craftingAction40' | 'craftingAction41' | 'craftingAction42' | 'craftingAction43' | 'craftingAction44' | 'craftingAction45' | 'craftingAction46' | 'craftingAction47' | 'craftingAction48' | 'craftingAction49' | 'craftingAction50' | 'dialogChoice1' | 'dialogChoice2' | 'dialogChoice3' | 'dialogChoice4' | 'dialogChoice5' | 'dialogChoice6' | 'dialogChoice7' | 'dialogChoice8' | 'dialogChoice9' | 'gamepadConfirm' | 'gamepadCancel' | 'gamepadUp' | 'gamepadDown' | 'gamepadLeft' | 'gamepadRight';
 export interface KeybindingDefinition {
-    action: KeybindingAction;
+    action: KeybindingAction | string;
     category: KeybindingCategory;
     displayName: string;
     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;
@@ -20,6 +28,7 @@ export declare const MODIFIER_PREFIXES: {
     readonly alt: "Alt+";
     readonly shift: "Shift+";
 };
+export declare const baseKeyToCode: Record<string, string>;
 export declare function getBaseKeyFromEvent(event: KeyboardEvent): string;
 export declare function buildKeybindingString(key: string, modifiers: {
     ctrl?: boolean;
@@ -34,8 +43,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

@@ -908,6 +908,8 @@ const codeToBaseKey = {
     F11: 'F11',
     F12: 'F12',
 };
+// Build reverse lookup from base key to code for matching KeyboardEvent.code
+export const baseKeyToCode = Object.fromEntries(Object.entries(codeToBaseKey).map(([code, baseKey]) => [baseKey, code]));
 // Get the base key from a keyboard event (uses code for consistent physical key)
 export function getBaseKeyFromEvent(event) {
     // Try to get base key from code first (handles Shift+2 -> '2' instead of '!')
@@ -964,6 +966,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 +995,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 +1012,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,6 +73,42 @@ export interface GameSettingsProps {
     eventHistoryLimit: number;
     setEventHistoryLimit: (value: number) => void;
 }
+/**
+ * Where injected content is placed relative to the matched element.
+ *
+ * Sibling insertions:
+ *   'before'          inserted as a sibling immediately before the target
+ *   'after'           inserted as a sibling immediately after the target (default)
+ *
+ * Child insertions:
+ *   'prependChild'    inserted as the first child inside the target
+ *   'appendChild'     inserted as the last child inside the target
+ *   { insertAt: N }   inserted as the Nth child inside the target (0-based)
+ *
+ * Overlay:
+ *   'overlay'         absolutely positioned layer covering the target (target gets position:relative if needed)
+ *
+ * Structural replacements (use with care on React-rendered elements):
+ *   'replaceContents' clears the target's children and renders content inside the target
+ *   'replaceElement'  removes the target entirely and renders content in its place
+ *   'wrapElement'     target becomes a DOM child of the content's outermost element (e.g. a border div wraps around target)
+ *   'wrapContents'    target's existing children are moved inside the content's outermost element, which is then appended to target
+ */
+export type InjectPlacement = 'before' | 'after' | 'prependChild' | 'appendChild' | 'overlay' | 'replaceContents' | 'replaceElement' | 'wrapElement' | 'wrapContents' | {
+    insertAt: number;
+};
+export interface NewGameIntent {
+    items: ItemDesc[];
+    techniques: string[];
+    recipes: string[];
+    destinies: string[];
+    quests: string[];
+    money: number;
+    favour: number;
+    flags: Record<string, number>;
+    player: PlayerEntity;
+    craftingActions: string[];
+}
 /**
  * Sprite images for a custom player character.
  * All images should be strings (either mod:// URLs for mod assets, or data: URLs).
@@ -353,8 +389,6 @@ export interface ModReduxAPI {
         TooltipLine: TooltipLineFC;
     };
     utils: {
-        hasSave: () => boolean;
-        getCurrentState: () => RootState | null;
         parseTooltipLine: (tooltip: string) => React.ReactNode;
         expandTooltipTemplate: (template: string, templateValues: Map<string, string>, addPeriod?: boolean) => string;
         expandTooltipTags: (template: string) => string;
@@ -2051,14 +2085,22 @@ 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.
+         */
+        getHasSaveLoaded: () => boolean;
     };
     hooks: {
         /**
@@ -2351,45 +2393,46 @@ export interface ModAPI {
          *   return payload;
          * });
          */
-        onReduxActionPayload: (interceptor: (actionType: string, payload: unknown) => unknown | null) => void;
+        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).
@@ -2404,6 +2447,17 @@ export interface ModAPI {
             costItems?: Item[];
             resultItem?: Item;
         } | undefined) => void;
+        /**
+         * Intercept the full set of changes planned for a new game before they are applied.
+         * Return a modified intent to change starting items, techniques, flags, etc.
+         * @param interceptor - Receives the full intent and returns a modified copy
+         * @example
+         * modAPI.hooks.onNewGame((intent) => ({
+         *   ...intent,
+         *   flags: { ...intent.flags, my_mod_enabled: 1 },
+         * }));
+         */
+        onNewGame: (interceptor: (intent: NewGameIntent) => NewGameIntent) => void;
     };
     /**
      * Inject UI into a named slot (dialog title or screen name).
@@ -2411,27 +2465,25 @@ export interface ModAPI {
      * The generator receives (api, element, inject):
      * - api: full ModReduxAPI with game state, actions, and components
      * - element: root DOM element of the slot; use querySelector to find children
-     * - inject(selector, content, mode?, position?): helper to portal content into the element
-     *   matched by selector. mode is 'overlay' (default, floats over) or 'inline'
-     *   (inserts as a sibling after the target, flowing with the layout).
-     *   position controls where content is placed (see InjectPosition enum).
+     * - inject(selector, content, placement?): helper to portal content relative to the element
+     *   matched by selector. placement controls where content appears (see InjectPlacement).
+     *   Defaults to 'after' (sibling inserted after the target).
      *
      * Slot names for dialogs are the id (e.g. 'combat-victory'). You can find these by inspecting the DOM in dev mode.
      * Slot names for screens match the ScreenType value (e.g. 'combat').
      *
      * @example
-     * // Add a button to combat victory dialog
+     * // Add a button after an element in the combat victory dialog
      * modAPI.ui.injectUI('combat-victory', (api, element, inject) => {
      *   return inject('[aria-live="assertive"]',
      *     <api.components.GameButton onClick={() => api.actions.changeQi(100)}>
      *       Absorb Qi
      *     </api.components.GameButton>,
-     *     'inline',
-     *     InjectPosition.After
+     *     'after'
      *   );
      * });
      */
-    injectUI: (slotName: string, generator: (api: ModReduxAPI, element: HTMLElement | null, inject: (selector: string, content: React.ReactNode, mode?: 'overlay' | 'inline', position?: InjectPosition) => React.ReactNode) => React.ReactNode) => void;
+    injectUI: (slotName: string, generator: (api: ModReduxAPI, element: HTMLElement | null, inject: (selector: string, content: React.ReactNode, placement?: InjectPlacement) => React.ReactNode) => React.ReactNode) => void;
     /**
      * Subscribe to any Redux state changes. The callback receives the new state.
      * Returns an unsubscribe function.
@@ -2456,4 +2508,6 @@ export interface ModAPI {
      */
     getGameStateSnapshot: () => RootState | null;
 }
-export type InjectPosition = 'inside' | 'before' | 'after';
+export type ModHooks = {
+    [K in keyof ModAPI['hooks']]: Parameters<ModAPI['hooks'][K]>[0][];
+};

package/package.json

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