afnm-types 0.6.27 → 0.6.29

package/dist/buff.d.ts

@@ -72,7 +72,7 @@ export interface Buff {
     onRoundStartEffects?: BuffEffect[];
     onCombatStartEffects?: BuffEffect[];
     interceptBuffEffects?: {
-        buff: Buff;
+        buff: Buff | string;
         effects: BuffEffect[];
         cancelApplication: boolean;
     }[];
@@ -82,6 +82,11 @@ export interface Buff {
         /** If true, this trigger will also fire when the opponent triggers the same event */
         listenToOpponent?: boolean;
     }[];
+    /** Block specific triggers from executing. Used to prevent effects like celestial rotation. */
+    blockTriggerEffects?: {
+        trigger: string;
+        effects: BuffEffect[];
+    }[];
     damageInterceptorEffects?: {
         trigger?: TechniqueCondition;
         damageModifier: DamageModifier;
@@ -124,6 +129,10 @@ export interface FloatingCombatImage extends BaseCombatImage {
     position: 'floating';
     entrance?: 'rotate' | 'grow';
     stacksScale?: number;
+    offset?: {
+        x: number;
+        y: number;
+    };
     mergedImage?: {
         image: string;
         otherBuff: string;

package/dist/keybindings.d.ts

@@ -1,5 +1,5 @@
 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' | 'craftingAction1' | 'craftingAction2' | 'craftingAction3' | 'craftingAction4' | 'craftingAction5' | 'craftingAction6' | 'craftingAction7' | 'craftingAction8' | 'craftingAction9' | 'craftingAction10' | 'dialogChoice1' | 'dialogChoice2' | 'dialogChoice3' | 'dialogChoice4' | 'dialogChoice5' | 'dialogChoice6' | 'dialogChoice7' | 'dialogChoice8' | 'dialogChoice9' | 'gamepadConfirm' | 'gamepadCancel' | 'gamepadUp' | 'gamepadDown' | 'gamepadLeft' | 'gamepadRight';
+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' | '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;
     category: KeybindingCategory;
@@ -15,6 +15,27 @@ export declare const keybindingCategoryInfo: Record<KeybindingCategory, {
     description: string;
 }>;
 export declare const defaultKeybindings: KeybindingsMap;
-export declare function getKeyDisplayName(key: string): string;
+export declare const MODIFIER_PREFIXES: {
+    readonly ctrl: "Ctrl+";
+    readonly alt: "Alt+";
+    readonly shift: "Shift+";
+};
+export declare function getBaseKeyFromEvent(event: KeyboardEvent): string;
+export declare function buildKeybindingString(key: string, modifiers: {
+    ctrl?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+}): string;
+export declare function buildKeybindingFromEvent(event: KeyboardEvent): string;
+export declare function parseKeybindingString(keybinding: string | undefined | null): {
+    key: string;
+    ctrl: boolean;
+    alt: boolean;
+    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 isModifierKey(key: string): boolean;
 export declare function isKeyAllowed(key: string): boolean;
 export declare function getKeybindingsByCategory(category: KeybindingCategory): KeybindingDefinition[];

package/dist/keybindings.js

@@ -133,6 +133,14 @@ export const keybindingDefinitions = [
         defaultKey: 'b',
         allowRebind: true,
     },
+    {
+        action: 'combatUseItem',
+        category: 'combat',
+        displayName: 'Use Item',
+        description: 'Open the use item dialog during combat',
+        defaultKey: 'e',
+        allowRebind: true,
+    },
     {
         action: 'combatSelectStance1',
         category: 'combat',
@@ -310,6 +318,330 @@ export const keybindingDefinitions = [
         defaultKey: '0',
         allowRebind: true,
     },
+    // Crafting Actions 11-20 (Shift+1-0)
+    {
+        action: 'craftingAction11',
+        category: 'crafting',
+        displayName: 'Crafting Action 11',
+        description: 'Execute crafting technique 11',
+        defaultKey: 'Shift+1',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction12',
+        category: 'crafting',
+        displayName: 'Crafting Action 12',
+        description: 'Execute crafting technique 12',
+        defaultKey: 'Shift+2',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction13',
+        category: 'crafting',
+        displayName: 'Crafting Action 13',
+        description: 'Execute crafting technique 13',
+        defaultKey: 'Shift+3',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction14',
+        category: 'crafting',
+        displayName: 'Crafting Action 14',
+        description: 'Execute crafting technique 14',
+        defaultKey: 'Shift+4',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction15',
+        category: 'crafting',
+        displayName: 'Crafting Action 15',
+        description: 'Execute crafting technique 15',
+        defaultKey: 'Shift+5',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction16',
+        category: 'crafting',
+        displayName: 'Crafting Action 16',
+        description: 'Execute crafting technique 16',
+        defaultKey: 'Shift+6',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction17',
+        category: 'crafting',
+        displayName: 'Crafting Action 17',
+        description: 'Execute crafting technique 17',
+        defaultKey: 'Shift+7',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction18',
+        category: 'crafting',
+        displayName: 'Crafting Action 18',
+        description: 'Execute crafting technique 18',
+        defaultKey: 'Shift+8',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction19',
+        category: 'crafting',
+        displayName: 'Crafting Action 19',
+        description: 'Execute crafting technique 19',
+        defaultKey: 'Shift+9',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction20',
+        category: 'crafting',
+        displayName: 'Crafting Action 20',
+        description: 'Execute crafting technique 20',
+        defaultKey: 'Shift+0',
+        allowRebind: true,
+    },
+    // Crafting Actions 21-30 (Ctrl+1-0)
+    {
+        action: 'craftingAction21',
+        category: 'crafting',
+        displayName: 'Crafting Action 21',
+        description: 'Execute crafting technique 21',
+        defaultKey: 'Ctrl+1',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction22',
+        category: 'crafting',
+        displayName: 'Crafting Action 22',
+        description: 'Execute crafting technique 22',
+        defaultKey: 'Ctrl+2',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction23',
+        category: 'crafting',
+        displayName: 'Crafting Action 23',
+        description: 'Execute crafting technique 23',
+        defaultKey: 'Ctrl+3',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction24',
+        category: 'crafting',
+        displayName: 'Crafting Action 24',
+        description: 'Execute crafting technique 24',
+        defaultKey: 'Ctrl+4',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction25',
+        category: 'crafting',
+        displayName: 'Crafting Action 25',
+        description: 'Execute crafting technique 25',
+        defaultKey: 'Ctrl+5',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction26',
+        category: 'crafting',
+        displayName: 'Crafting Action 26',
+        description: 'Execute crafting technique 26',
+        defaultKey: 'Ctrl+6',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction27',
+        category: 'crafting',
+        displayName: 'Crafting Action 27',
+        description: 'Execute crafting technique 27',
+        defaultKey: 'Ctrl+7',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction28',
+        category: 'crafting',
+        displayName: 'Crafting Action 28',
+        description: 'Execute crafting technique 28',
+        defaultKey: 'Ctrl+8',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction29',
+        category: 'crafting',
+        displayName: 'Crafting Action 29',
+        description: 'Execute crafting technique 29',
+        defaultKey: 'Ctrl+9',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction30',
+        category: 'crafting',
+        displayName: 'Crafting Action 30',
+        description: 'Execute crafting technique 30',
+        defaultKey: 'Ctrl+0',
+        allowRebind: true,
+    },
+    // Crafting Actions 31-40 (Alt+1-0)
+    {
+        action: 'craftingAction31',
+        category: 'crafting',
+        displayName: 'Crafting Action 31',
+        description: 'Execute crafting technique 31',
+        defaultKey: 'Alt+1',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction32',
+        category: 'crafting',
+        displayName: 'Crafting Action 32',
+        description: 'Execute crafting technique 32',
+        defaultKey: 'Alt+2',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction33',
+        category: 'crafting',
+        displayName: 'Crafting Action 33',
+        description: 'Execute crafting technique 33',
+        defaultKey: 'Alt+3',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction34',
+        category: 'crafting',
+        displayName: 'Crafting Action 34',
+        description: 'Execute crafting technique 34',
+        defaultKey: 'Alt+4',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction35',
+        category: 'crafting',
+        displayName: 'Crafting Action 35',
+        description: 'Execute crafting technique 35',
+        defaultKey: 'Alt+5',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction36',
+        category: 'crafting',
+        displayName: 'Crafting Action 36',
+        description: 'Execute crafting technique 36',
+        defaultKey: 'Alt+6',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction37',
+        category: 'crafting',
+        displayName: 'Crafting Action 37',
+        description: 'Execute crafting technique 37',
+        defaultKey: 'Alt+7',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction38',
+        category: 'crafting',
+        displayName: 'Crafting Action 38',
+        description: 'Execute crafting technique 38',
+        defaultKey: 'Alt+8',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction39',
+        category: 'crafting',
+        displayName: 'Crafting Action 39',
+        description: 'Execute crafting technique 39',
+        defaultKey: 'Alt+9',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction40',
+        category: 'crafting',
+        displayName: 'Crafting Action 40',
+        description: 'Execute crafting technique 40',
+        defaultKey: 'Alt+0',
+        allowRebind: true,
+    },
+    // Crafting Actions 41-50 (Ctrl+Shift+1-0)
+    {
+        action: 'craftingAction41',
+        category: 'crafting',
+        displayName: 'Crafting Action 41',
+        description: 'Execute crafting technique 41',
+        defaultKey: 'Ctrl+Shift+1',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction42',
+        category: 'crafting',
+        displayName: 'Crafting Action 42',
+        description: 'Execute crafting technique 42',
+        defaultKey: 'Ctrl+Shift+2',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction43',
+        category: 'crafting',
+        displayName: 'Crafting Action 43',
+        description: 'Execute crafting technique 43',
+        defaultKey: 'Ctrl+Shift+3',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction44',
+        category: 'crafting',
+        displayName: 'Crafting Action 44',
+        description: 'Execute crafting technique 44',
+        defaultKey: 'Ctrl+Shift+4',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction45',
+        category: 'crafting',
+        displayName: 'Crafting Action 45',
+        description: 'Execute crafting technique 45',
+        defaultKey: 'Ctrl+Shift+5',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction46',
+        category: 'crafting',
+        displayName: 'Crafting Action 46',
+        description: 'Execute crafting technique 46',
+        defaultKey: 'Ctrl+Shift+6',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction47',
+        category: 'crafting',
+        displayName: 'Crafting Action 47',
+        description: 'Execute crafting technique 47',
+        defaultKey: 'Ctrl+Shift+7',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction48',
+        category: 'crafting',
+        displayName: 'Crafting Action 48',
+        description: 'Execute crafting technique 48',
+        defaultKey: 'Ctrl+Shift+8',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction49',
+        category: 'crafting',
+        displayName: 'Crafting Action 49',
+        description: 'Execute crafting technique 49',
+        defaultKey: 'Ctrl+Shift+9',
+        allowRebind: true,
+    },
+    {
+        action: 'craftingAction50',
+        category: 'crafting',
+        displayName: 'Crafting Action 50',
+        description: 'Execute crafting technique 50',
+        defaultKey: 'Ctrl+Shift+0',
+        allowRebind: true,
+    },
     // Dialog Choices (Number keys 1-9)
     {
         action: 'dialogChoice1',
@@ -470,28 +802,203 @@ export const keybindingCategoryInfo = {
 };
 // Default keybindings
 export const defaultKeybindings = Object.fromEntries(keybindingDefinitions.map((def) => [def.action, def.defaultKey]));
-// Helper to get display name for a key
-export function getKeyDisplayName(key) {
-    const keyDisplayNames = {
-        Enter: 'Enter',
-        Escape: 'Esc',
-        ' ': 'Space',
-        ArrowUp: '↑',
-        ArrowDown: '↓',
-        ArrowLeft: '←',
-        ArrowRight: '→',
-        Tab: 'Tab',
-        Shift: 'Shift',
-        Control: 'Ctrl',
-        Alt: 'Alt',
-        Backspace: 'Backspace',
-        Delete: 'Delete',
-        Home: 'Home',
-        End: 'End',
-        PageUp: 'PgUp',
-        PageDown: 'PgDn',
-    };
-    return keyDisplayNames[key] || (key === null || key === void 0 ? void 0 : key.toUpperCase());
+// Modifier key prefixes used in keybinding strings
+export const MODIFIER_PREFIXES = {
+    ctrl: 'Ctrl+',
+    alt: 'Alt+',
+    shift: 'Shift+',
+};
+// Map from KeyboardEvent.code to base key name (for physical key identification)
+const codeToBaseKey = {
+    // Number row
+    Digit0: '0',
+    Digit1: '1',
+    Digit2: '2',
+    Digit3: '3',
+    Digit4: '4',
+    Digit5: '5',
+    Digit6: '6',
+    Digit7: '7',
+    Digit8: '8',
+    Digit9: '9',
+    // Letters
+    KeyA: 'a',
+    KeyB: 'b',
+    KeyC: 'c',
+    KeyD: 'd',
+    KeyE: 'e',
+    KeyF: 'f',
+    KeyG: 'g',
+    KeyH: 'h',
+    KeyI: 'i',
+    KeyJ: 'j',
+    KeyK: 'k',
+    KeyL: 'l',
+    KeyM: 'm',
+    KeyN: 'n',
+    KeyO: 'o',
+    KeyP: 'p',
+    KeyQ: 'q',
+    KeyR: 'r',
+    KeyS: 's',
+    KeyT: 't',
+    KeyU: 'u',
+    KeyV: 'v',
+    KeyW: 'w',
+    KeyX: 'x',
+    KeyY: 'y',
+    KeyZ: 'z',
+    // Punctuation
+    Minus: '-',
+    Equal: '=',
+    BracketLeft: '[',
+    BracketRight: ']',
+    Backslash: '\\',
+    Semicolon: ';',
+    Quote: "'",
+    Backquote: '`',
+    Comma: ',',
+    Period: '.',
+    Slash: '/',
+    // Special keys
+    Space: ' ',
+    Enter: 'Enter',
+    Escape: 'Escape',
+    Backspace: 'Backspace',
+    Tab: 'Tab',
+    Delete: 'Delete',
+    Home: 'Home',
+    End: 'End',
+    PageUp: 'PageUp',
+    PageDown: 'PageDown',
+    ArrowUp: 'ArrowUp',
+    ArrowDown: 'ArrowDown',
+    ArrowLeft: 'ArrowLeft',
+    ArrowRight: 'ArrowRight',
+    // Function keys
+    F1: 'F1',
+    F2: 'F2',
+    F3: 'F3',
+    F4: 'F4',
+    F5: 'F5',
+    F6: 'F6',
+    F7: 'F7',
+    F8: 'F8',
+    F9: 'F9',
+    F10: 'F10',
+    F11: 'F11',
+    F12: 'F12',
+};
+// 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 '!')
+    const baseKey = codeToBaseKey[event.code];
+    if (baseKey) {
+        return baseKey;
+    }
+    // Fall back to event.key for unmapped keys
+    return event.key;
+}
+// Build a keybinding string from a key and modifier state
+export function buildKeybindingString(key, modifiers) {
+    let result = '';
+    if (modifiers.ctrl)
+        result += MODIFIER_PREFIXES.ctrl;
+    if (modifiers.alt)
+        result += MODIFIER_PREFIXES.alt;
+    if (modifiers.shift)
+        result += MODIFIER_PREFIXES.shift;
+    result += key;
+    return result;
+}
+// Build a keybinding string directly from a keyboard event
+export function buildKeybindingFromEvent(event) {
+    const baseKey = getBaseKeyFromEvent(event);
+    return buildKeybindingString(baseKey, {
+        ctrl: event.ctrlKey,
+        alt: event.altKey,
+        shift: event.shiftKey,
+    });
+}
+// Parse a keybinding string into its components
+export function parseKeybindingString(keybinding) {
+    if (!keybinding) {
+        return { key: '', ctrl: false, alt: false, shift: false };
+    }
+    let remaining = keybinding;
+    const ctrl = remaining.startsWith(MODIFIER_PREFIXES.ctrl);
+    if (ctrl)
+        remaining = remaining.slice(MODIFIER_PREFIXES.ctrl.length);
+    const alt = remaining.startsWith(MODIFIER_PREFIXES.alt);
+    if (alt)
+        remaining = remaining.slice(MODIFIER_PREFIXES.alt.length);
+    const shift = remaining.startsWith(MODIFIER_PREFIXES.shift);
+    if (shift)
+        remaining = remaining.slice(MODIFIER_PREFIXES.shift.length);
+    return { key: remaining, ctrl, alt, shift };
+}
+// Check if a keyboard event matches a keybinding string
+export function matchesKeybinding(event, keybinding) {
+    const parsed = parseKeybindingString(keybinding);
+    return (event.key === parsed.key &&
+        event.ctrlKey === parsed.ctrl &&
+        event.altKey === parsed.alt &&
+        event.shiftKey === parsed.shift);
+}
+const singleKeyDisplayNames = {
+    Enter: 'Enter',
+    Escape: 'Esc',
+    ' ': 'Space',
+    ArrowUp: '↑',
+    ArrowDown: '↓',
+    ArrowLeft: '←',
+    ArrowRight: '→',
+    Tab: 'Tab',
+    Shift: 'Shift',
+    Control: 'Ctrl',
+    Alt: 'Alt',
+    Backspace: 'Backspace',
+    Delete: 'Delete',
+    Home: 'Home',
+    End: 'End',
+    PageUp: 'PgUp',
+    PageDown: 'PgDn',
+};
+// Helper to get display name for a key (full version)
+export function getKeyDisplayName(keybinding) {
+    var _a;
+    if (!keybinding)
+        return '';
+    const parsed = parseKeybindingString(keybinding);
+    let result = '';
+    if (parsed.ctrl)
+        result += 'Ctrl+';
+    if (parsed.alt)
+        result += 'Alt+';
+    if (parsed.shift)
+        result += 'Shift+';
+    result += singleKeyDisplayNames[parsed.key] || ((_a = parsed.key) === null || _a === void 0 ? void 0 : _a.toUpperCase());
+    return result;
+}
+// Helper to get short display name for a key (compact version for UI previews)
+export function getKeyShortDisplayName(keybinding) {
+    var _a;
+    if (!keybinding)
+        return '';
+    const parsed = parseKeybindingString(keybinding);
+    let result = '';
+    if (parsed.ctrl)
+        result += 'C+';
+    if (parsed.alt)
+        result += 'A+';
+    if (parsed.shift)
+        result += 'S+';
+    result += singleKeyDisplayNames[parsed.key] || ((_a = parsed.key) === null || _a === void 0 ? void 0 : _a.toUpperCase());
+    return result;
+}
+// Check if a key is a modifier key (not allowed as standalone binding)
+export function isModifierKey(key) {
+    return ['Shift', 'Control', 'Alt', 'Meta'].includes(key);
 }
 // Validate if a key is allowed for binding
 export function isKeyAllowed(key) {
@@ -500,6 +1007,9 @@ export function isKeyAllowed(key) {
         'F11', // Fullscreen
         'F12', // Dev tools
         'Meta', // Windows/Cmd key
+        'Shift', // Modifier keys alone not allowed
+        'Control',
+        'Alt',
     ];
     return !disallowedKeys.includes(key);
 }

package/dist/mod.d.ts

@@ -304,6 +304,11 @@ export interface ModAPI {
             };
             cloud: {
                 clouds: Buff;
+                thunderAspect: Buff;
+                galeAspect: Buff;
+                mistAspect: Buff;
+                monsoonAspect: Buff;
+                blizzardAspect: Buff;
             };
             fist: {
                 flow: Buff;

package/dist/stat.d.ts

@@ -3,7 +3,7 @@ import { 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"];
-export declare const combatStatistics: readonly ["maxhp", "hp", "maxbarrier", "barrier", "maxtoxicity", "toxicity", "resistance", "pillsPerRound", "itemEffectiveness", "power", "artefactpower", "critchance", "defense", "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", "fistResistance", "blossomResistance", "weaponResistance", "cloudResistance", "bloodResistance", "celestialResistance"];
+export declare const combatStatistics: readonly ["maxhp", "hp", "maxbarrier", "barrier", "maxtoxicity", "toxicity", "resistance", "pillsPerRound", "itemEffectiveness", "power", "artefactpower", "critchance", "defense", "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", "fistResistance", "blossomResistance", "weaponResistance", "cloudResistance", "bloodResistance", "celestialResistance", "damageBoost", "healingBoost", "barrierBoost", "overheal"];
 export type PhysicalStatistic = (typeof physicalStatistics)[number];
 export type SocialStatistic = (typeof socialStatistics)[number];
 export type CraftingStatistic = (typeof craftingStatistics)[number];
@@ -32,6 +32,9 @@ export declare const combatStatToName: {
 export declare const combatStatToDescription: {
     [key in CombatStatistic]: string;
 };
+export declare const uncommonStatTooltips: Partial<{
+    [key in CombatStatistic]: string;
+}>;
 export declare const craftingStatToName: {
     [key in CraftingStatistic]: string;
 };
@@ -72,4 +75,5 @@ export interface Scaling {
     divideByStanceLength?: boolean;
     upgradeKey?: string;
     buff?: Buff;
+    increment?: number;
 }

package/dist/stat.js

@@ -79,6 +79,10 @@ export const combatStatistics = [
     'cloudResistance',
     'bloodResistance',
     'celestialResistance',
+    'damageBoost',
+    'healingBoost',
+    'barrierBoost',
+    'overheal',
 ];
 export const baseStatNumber = 10;
 export const expectedHpPerFlesh = 1000;
@@ -138,6 +142,10 @@ export const combatStatToName = {
     cloudResistance: 'Cloud Resistance',
     bloodResistance: 'Blood Resistance',
     celestialResistance: 'Celestial Resistance',
+    damageBoost: 'Damage Boost',
+    healingBoost: 'Healing Boost',
+    barrierBoost: 'Barrier Boost',
+    overheal: 'Overheal',
 };
 export const combatStatToDescription = {
     maxhp: 'The amount of damage you can take before you are unable to continue.',
@@ -185,6 +193,18 @@ export const combatStatToDescription = {
     celestialResistance: '',
     pillsPerRound: '',
     itemEffectiveness: 'The effectiveness of your pills, concoctions, and formation parts.',
+    damageBoost: '',
+    healingBoost: '',
+    barrierBoost: '',
+    overheal: '',
+};
+// 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
+export const uncommonStatTooltips = {
+    damageBoost: '<n>Damage Boost</n> increases all non-true damage dealt by a percentage.',
+    healingBoost: '<n>Healing Boost</n> increases all healing received by a percentage.',
+    barrierBoost: '<n>Barrier Boost</n> increases all barrier gained by a percentage.',
+    overheal: '<n>Overheal</n> converts a percentage of healing beyond your maximum health into barrier.',
 };
 export const craftingStatToName = {
     maxpool: 'Max Qi Pool',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "afnm-types",
-  "version": "0.6.27",
+  "version": "0.6.29",
   "description": "Type definitions for Ascend From Nine Mountains",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,11 +16,11 @@
     }
   },
   "peerDependencies": {
-    "@mui/icons-material": "^7.3.1",
-    "@mui/material": "^7.3.1"
+    "@mui/icons-material": "^7.3.6",
+    "@mui/material": "^7.3.6"
   },
   "devDependencies": {
-    "typescript": "^5.7.2"
+    "typescript": "^5.9.3"
   },
   "scripts": {
     "build": "tsc --project tsconfig.types.json",