afnm-types 0.6.56 → 0.6.58

package/dist/GameScreen.d.ts

@@ -1,2 +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';
+export type GameScreen = 'location' | 'recipe' | 'mission' | 'craftingHall' | 'manual' | 'cultivation' | 'map' | 'healer' | 'market' | 'favour' | 'herbField' | 'mine' | 'recipeLibrary' | 'requestBoard' | 'compendium' | 'library' | 'altar' | 'research' | 'reforge' | 'expedition' | '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' | 'expedition';

package/dist/auction.d.ts

@@ -18,6 +18,7 @@ export interface AuctionItemDef {
     condition: string;
     countOverride?: number;
     countMultiplier?: number;
+    costMultiplier?: number;
 }
 export interface AuctionCharacter {
     name: string;

package/dist/breakthrough.d.ts

@@ -23,12 +23,30 @@ export interface StoredFigment {
     stances: StoredStance[];
     currentStyle?: StoredStyle;
     storedStyles?: StoredStyle[];
+    assignedTiers?: Record<string, number>;
+}
+/** An active firmament incursion targeting the player's inner world */
+export interface ActiveIncursion {
+    id: string;
+    spawnedYear: number;
+    spawnedMonth: number;
+}
+/** Generated but uncollected essence accumulating in the inner world */
+export interface PendingEssence {
+    essenceItemName: string;
+    count: number;
+    progress: number;
 }
 /** State for the Life Flourishing breakthrough system */
 export interface LifeFlourishingState {
     unlockedSpecies: string[];
     storedFigments: StoredFigment[];
-    manifestedFigmentId?: string;
+    evokedFigmentId?: string;
+    worldAspectId?: string;
+    firmamentProgress?: number;
+    activeIncursions?: ActiveIncursion[];
+    pendingEssences?: PendingEssence[];
+    essenceTiersUnlocked?: Record<string, number>;
 }
 export interface BreakthroughState {
     mundane?: {

package/dist/buff.d.ts

@@ -57,6 +57,20 @@ interface InventoryItemTechniqueCondition extends BaseTechniqueCondition {
     count: number;
     mode: 'more' | 'less' | 'equal';
 }
+/**
+ * Configures how a buff lives outside combat. Buffs without a `persistence`
+ * field are combat or event scoped only.
+ */
+export interface BuffPersistence {
+    /**
+     * When combat ends, the surviving stack count of this buff on the player is
+     * written back into `player.monthBuffs`. Existing entries are replaced, not
+     * additively merged. Stacks of zero or below remove the buff.
+     */
+    persistAfterCombat?: boolean;
+    /** Stacks of this buff lost at the end of every month. */
+    decayPerMonth?: number;
+}
 export interface Buff {
     name: string;
     displayName?: Translatable;
@@ -108,6 +122,7 @@ export interface Buff {
     /** Block specific triggers from executing. Used to prevent effects like celestial rotation. */
     blockTriggerEffects?: {
         trigger: string;
+        condition?: TechniqueCondition;
         effects: BuffEffect[];
     }[];
     damageInterceptorEffects?: {
@@ -122,6 +137,7 @@ export interface Buff {
         amplifier: {
             kind: 'multiply';
             value: number;
+            cantUpgrade?: boolean;
         };
         effects?: BuffEffect[];
         appliesTo: ('damage' | 'barrier' | 'heal' | 'tempHealth')[];
@@ -134,6 +150,7 @@ export interface Buff {
         modifier: {
             kind: 'add' | 'multiply';
             value: number;
+            cantUpgrade?: boolean;
         };
         effects?: BuffEffect[];
     }[];
@@ -144,6 +161,12 @@ export interface Buff {
     stacks: number;
     stacksAreDays?: boolean;
     stacksAreMonths?: boolean;
+    /**
+     * Marks the buff as carrying state on the player between events. When set,
+     * the buff opts out of the default daily monthBuffs decay (which treats
+     * stacks as days remaining) and follows the rules in this object instead.
+     */
+    persistence?: BuffPersistence;
     buffType?: string;
     buffTypeTooltip?: string;
     endurePercent?: number;
@@ -155,6 +178,11 @@ export interface Buff {
     guardianIntercept?: {
         percent: Scaling;
         maxHp: Scaling;
+        /** How re-application of the guardian buff combines with existing guardian HP.
+         *  'refresh' (default): maxHp = max(old, new); hp = maxHp (fully heal).
+         *  'extend': hp = oldHp + newMaxHp; maxHp = max(oldMaxHp, hp). Adds onto current and extends the cap. */
+        refreshMode?: 'refresh' | 'extend';
+        canUpgrade?: boolean;
     };
     /** Runtime guardian HP — set automatically from guardianIntercept.maxHp at buff creation */
     guardianHp?: number;
@@ -328,6 +356,7 @@ interface BaseBuff {
         [key in CombatStatistic]: Scaling;
     }>;
     hidden?: boolean;
+    cantUpgrade?: boolean;
 }
 interface DamageEffect extends BaseBuff {
     kind: 'damage';
@@ -372,6 +401,7 @@ interface ConsumeBuffSelfEffect extends BaseBuff {
     buff: Buff | string;
     silent?: boolean;
     hideBuff?: boolean;
+    targeting?: EffectTargeting;
 }
 interface CreateBuffTargetEffect extends BaseBuff {
     kind: 'buffTarget';
@@ -418,6 +448,9 @@ interface ModifyBuffGroupEffect extends BaseBuff {
     onTarget?: boolean;
     group: string;
     amount: Scaling;
+    /** Defaults to 'all'. 'highest'/'lowest' restrict the effect to a single matching buff
+     *  chosen by stack count. */
+    mode?: 'all' | 'highest' | 'lowest';
 }
 interface SetStateEffect extends BaseBuff {
     kind: 'setState';

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

@@ -537,6 +537,18 @@ function extractFromFile(filePath) {
                         });
                     }
                 }
+                else if (typescript_1.default.isBinaryExpression(arg) && arg.operatorToken.kind === typescript_1.default.SyntaxKind.PlusToken) {
+                    // String concatenation with + is supported - try to resolve it
+                    const resolved = (0, template_processor_js_1.tryResolveBinaryExpression)(arg, sourceFile, filePath);
+                    if (resolved !== null && resolved.trim().length > 0) {
+                        results.push({
+                            text: resolved,
+                            file: filePath,
+                            line: (0, template_processor_js_1.getLineNumber)(sourceFile, node.getStart()),
+                            context: `${funcName}-call`,
+                        });
+                    }
+                }
                 else if (typescript_1.default.isTemplateExpression(arg)) {
                     const templateText = arg.getText(sourceFile);
                     const processed = (0, template_processor_js_1.processTemplateExpression)(arg, sourceFile, filePath);

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

@@ -1037,20 +1037,31 @@ function buildTranslationLookup(langData) {
 function loadExistingLanguageFiles() {
     const languageFiles = new Map();
     const translationsDir = path_1.default.join('src', 'translations');
-    // List of language codes to look for
-    const languages = ['zh', 'de', 'fr', 'es', 'ru'];
-    for (const lang of languages) {
-        const langPath = path_1.default.join(translationsDir, `${lang}.json`);
-        if (fs_1.default.existsSync(langPath)) {
-            try {
-                const data = JSON.parse(fs_1.default.readFileSync(langPath, 'utf-8'));
-                languageFiles.set(lang, data);
-                console.log(`  Loaded existing translations from ${lang}.json`);
-            }
-            catch (error) {
-                const message = error instanceof Error ? error.message : String(error);
-                console.warn(`  Warning: Failed to parse ${lang}.json: ${message}`);
-            }
+    // Discover languages by scanning the translations directory rather than maintaining
+    // a hardcoded list (which silently dropped ja/ko/vi/fi/pl/pt-BR/th/zh-CN/zh-TW).
+    // Filenames are <lang>.json; non-language files in this dir are explicitly excluded.
+    const NON_LANGUAGE_FILES = new Set([
+        'template.json',
+        'debug.json',
+        'custom-strings.json',
+        'technique-tooltip-templates.json',
+    ]);
+    const entries = fs_1.default.readdirSync(translationsDir);
+    for (const file of entries) {
+        if (!file.endsWith('.json'))
+            continue;
+        if (NON_LANGUAGE_FILES.has(file))
+            continue;
+        const lang = file.replace(/\.json$/, '');
+        const langPath = path_1.default.join(translationsDir, file);
+        try {
+            const data = JSON.parse(fs_1.default.readFileSync(langPath, 'utf-8'));
+            languageFiles.set(lang, data);
+            console.log(`  Loaded existing translations from ${lang}.json`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`  Warning: Failed to parse ${lang}.json: ${message}`);
         }
     }
     return languageFiles;

package/dist/components.d.ts

@@ -3,7 +3,7 @@ import type { ReactNode, PropsWithChildren, ReactElement } from 'react';
 import type { SoundEffectName } from './audio';
 import type { ScreenEffectType } from './ScreenEffectType';
 import type React from 'react';
-export type BorderType = 'wood' | 'mystic';
+export type BorderType = 'wood' | 'mystic' | 'expedition' | 'expeditionSmall';
 interface GameDialogProps {
     id: string;
     onClose?: () => void;
@@ -33,6 +33,7 @@ export type GameIconButtonFC = React.ForwardRefRenderFunction<HTMLButtonElement,
     hoverSfx?: SoundEffectName;
     clickSfx?: SoundEffectName;
     tooltip?: ReactNode;
+    fancyBorder?: boolean;
 }>;
 export type GameCloseButtonFC = React.ForwardRefRenderFunction<HTMLButtonElement, Omit<IconButtonProps & {
     hoverSfx?: SoundEffectName;

package/dist/entity.d.ts

@@ -333,6 +333,8 @@ export interface CombatEntity {
     partyId?: string;
     /** When true, critchance is forced to 0 for this entity (used in training ground) */
     noCrit?: boolean;
+    /** Maximum qi droplets for this entity (set during combat entity creation) */
+    maxqiDroplets?: number;
     /** Cached hash for getVariablesFromEntity. Cleared whenever stats or buffs mutate. */
     _cachedHash?: string;
 }

package/dist/event.d.ts

@@ -39,7 +39,7 @@ export interface BaseEventStep {
     kind: EventStepKind;
     condition?: string;
 }
-export type EventStep = TextStep | SpeechStep | CombatStep | CraftingStep | ChoiceStep | ConditionalStep | SetFlagStep | ExitStep | CreateBuffStep | ConsumeBuffStep | ChangeLocationStep | AddItemStep | RemoveItemStep | AddQuestStep | ChangeMoneyStep | ChangeFavourStep | AddDestinyStep | ChangeReputationStep | QiStep | UnlockLocationStep | ClearCharacterStep | SetCharacterStep | LabelStep | GotoLabelStep | UnlockCraftingTechniqueStep | TalkToCharacterStep | TradeWithCharacterStep | CraftWithCharacterStep | FightCharacterStep | MarkBeatCharacterStep | MarkDidEncounterStep | ChangeHpStep | PassTimeStep | ReportAnalyticsStep | ApprovalStep | ProgressRelationshipStep | MarkGiftedStep | UpdateCharacterDefinitionStep | AuctionStep | MarkCalendarEventCompleteStep | AddMultipleItemStep | AdvanceMysticalRegionStep | CraftSkillStep | TournamentStep | TeamUpStep | CraftingTeamUpStep | AddFollowerStep | BreakPartyStep | ClearTeamUpStep | UnlockAltarStep | DropItemStep | SetAltarCooldownStep | CompressCoreStep | ChangeScreenStep | UnlockTechniqueStep | UnlockAuctionTechniqueStep | AddRecipeStep | AddManualStep | LearnNpcStancesStep | ReplaceItemStep | DualCultivationStep | ChangeBGMStep | ClearChangeBGMStep | AddGuildApprovalStep | AdvanceGuildRankStep | OverridePlayerRealmStep | SetContentRealmOverrideStep | SetAidBreakthroughCooldownStep | StoneCuttingStep | GiveItemStep | ChangePhysicalStatStep | ChangeSocialStatStep | SelectRelationshipPathStep | SetTradeCooldownStep | StatusStep | ClearStatusStep;
+export type EventStep = TextStep | SpeechStep | CombatStep | CraftingStep | ChoiceStep | ConditionalStep | SetFlagStep | ExitStep | CreateBuffStep | ConsumeBuffStep | ChangeLocationStep | AddItemStep | RemoveItemStep | AddQuestStep | ChangeMoneyStep | ChangeFavourStep | AddDestinyStep | ChangeReputationStep | QiStep | UnlockLocationStep | ClearCharacterStep | SetCharacterStep | LabelStep | GotoLabelStep | UnlockCraftingTechniqueStep | TalkToCharacterStep | TradeWithCharacterStep | CraftWithCharacterStep | FightCharacterStep | MarkBeatCharacterStep | MarkDidEncounterStep | ChangeHpStep | PassTimeStep | ReportAnalyticsStep | ApprovalStep | ProgressRelationshipStep | MarkGiftedStep | UpdateCharacterDefinitionStep | AuctionStep | MarkCalendarEventCompleteStep | AddMultipleItemStep | AdvanceMysticalRegionStep | CraftSkillStep | TournamentStep | TeamUpStep | CraftingTeamUpStep | AddFollowerStep | BreakPartyStep | ClearTeamUpStep | UnlockAltarStep | DropItemStep | SetAltarCooldownStep | CompressCoreStep | ChangeScreenStep | UnlockTechniqueStep | UnlockAuctionTechniqueStep | AddRecipeStep | AddManualStep | LearnNpcStancesStep | ReplaceItemStep | DualCultivationStep | ChangeBGMStep | ClearChangeBGMStep | AddGuildApprovalStep | AdvanceGuildRankStep | OverridePlayerRealmStep | SetContentRealmOverrideStep | SetAidBreakthroughCooldownStep | StoneCuttingStep | GiveItemStep | ChangePhysicalStatStep | ChangeSocialStatStep | SelectRelationshipPathStep | SetTradeCooldownStep | StatusStep | ClearStatusStep | IncreaseInstabilityStep | EndExpeditionStep | AddItemsToFoundStep | AddItemsToExtractedStep;
 export interface TextStep extends BaseEventStep {
     kind: 'text';
     text: Translatable;
@@ -174,6 +174,7 @@ export interface CreateBuffStep extends BaseEventStep {
     buff: Buff;
     amount: string;
     persistBeyondEvent?: boolean;
+    debuff?: boolean;
 }
 export interface ConsumeBuffStep extends BaseEventStep {
     kind: 'consumeBuff';
@@ -464,6 +465,10 @@ export interface SetAidBreakthroughCooldownStep extends BaseEventStep {
 export interface StoneCuttingStep extends BaseEventStep {
     kind: 'stoneCutting';
     realm: Realm;
+    /** Percentage discount to apply to stone cutting costs (0-100), evaluated as expression */
+    discountPercentage?: string;
+    /** Number of stones the player can cut for free, evaluated as expression */
+    freeCount?: string;
 }
 export interface GiveItemStep extends BaseEventStep {
     kind: 'giveItem';
@@ -509,4 +514,26 @@ export interface EventStatusThreshold {
     colour: string;
     label?: Translatable;
 }
+export interface IncreaseInstabilityStep {
+    kind: 'instability';
+    condition?: string;
+}
+export interface EndExpeditionStep {
+    kind: 'endExpedition';
+    failed: boolean;
+    condition?: string;
+}
+export interface AddItemsToFoundStep {
+    kind: 'addToFound';
+    items: {
+        item: ItemDesc;
+        count: number;
+    }[];
+    condition?: string;
+}
+export interface AddItemsToExtractedStep {
+    kind: 'addToExtracted';
+    extractSlots: number;
+    condition?: string;
+}
 export {};

package/dist/expedition.d.ts

@@ -0,0 +1,128 @@
+import { Buff } from './buff';
+import { EnemyEntity } from './entity';
+import { EventStep } from './event';
+import { ItemDesc } from './item';
+import { Rarity } from './rarity';
+import { Translatable } from './translatable';
+export declare const expeditionBaseCost = 87500;
+export declare const expeditionDirections: readonly ["left", "right", "top", "bottom"];
+export type ExpeditionDirection = (typeof expeditionDirections)[number];
+export declare const expeditionDirectionOpposite: {
+    [key in ExpeditionDirection]: ExpeditionDirection;
+};
+export declare const expeditionDirectionPoint: {
+    [key in ExpeditionDirection]: ExpeditionPoint;
+};
+export interface ExpeditionPoint {
+    x: number;
+    y: number;
+}
+export type RoleRarity = Exclude<Rarity, 'transcendent'>;
+export declare const RoleRarityWeight: Record<RoleRarity, number>;
+export type Roles = 'fighter' | 'healer' | 'surveyor' | 'archaeologist' | 'stabilizer' | 'qiflow';
+export declare const rolesToName: Record<Roles, string>;
+export declare const roleDescription: Record<Roles, string>;
+export declare const RoleWeight: Record<Roles, number>;
+export type MemberRole = {
+    role: Roles;
+    rarity: RoleRarity;
+};
+export type TeamMember = {
+    name: Translatable;
+    buff?: Buff;
+    role: MemberRole;
+};
+export type ExpeditionTeam = TeamMember[];
+export interface TileMonsters {
+    combat: EnemyEntity[];
+    boss: EnemyEntity[];
+    challenge: EnemyEntity[];
+}
+export type ExpeditionTileTypes = 'entrance' | 'exit' | 'extract' | 'combat' | 'rest' | 'treasure' | 'boss' | 'buff' | 'debuff' | 'challenge' | 'puzzle' | 'boonBane';
+export interface ExpeditionTilePoint extends ExpeditionPoint {
+    name: string;
+}
+export interface ExpeditionTile extends ExpeditionPoint {
+    expeditionTiles: ExpeditionTilePoint[];
+    edges: {
+        [key in ExpeditionDirection]: ExpeditionPoint[];
+    };
+    tileConnections: {
+        src: string;
+        dst: string;
+    }[];
+    edgeConnections: {
+        tile: string;
+        edge: string;
+        direction: ExpeditionDirection;
+    }[];
+}
+export type ExpeditionTiles = EntranceTile | ExitTile | ExtractTile | CombatTile | RestTile | TreasureTile | BossTile | BuffTile | DebuffTile | ChallengeTile | PuzzleTile | BoonBaneTile;
+interface BaseTile {
+    name: string;
+    icon: string;
+    bg: string;
+    description: Translatable;
+    rarity: Rarity;
+    intro: EventStep[];
+}
+export interface EntranceTile extends BaseTile {
+    kind: 'entrance';
+}
+export interface ExitTile extends BaseTile {
+    kind: 'exit';
+}
+export interface ExtractTile extends BaseTile {
+    kind: 'extract';
+    extractCount: number;
+}
+export interface CombatTile extends BaseTile {
+    kind: 'combat';
+    modifier?: number;
+    enemyCount?: number;
+    items?: {
+        item: ItemDesc;
+        count: number;
+    }[];
+}
+export interface RestTile extends BaseTile {
+    kind: 'rest';
+    baseRestore: number;
+}
+export interface TreasureTile extends BaseTile {
+    kind: 'treasure';
+}
+export interface BossTile extends BaseTile {
+    kind: 'boss';
+    modifier?: number;
+    items?: {
+        item: ItemDesc;
+        count: number;
+    }[];
+}
+export interface BuffTile extends BaseTile {
+    kind: 'buff';
+}
+export interface DebuffTile extends BaseTile {
+    kind: 'debuff';
+}
+export interface ChallengeTile extends BaseTile {
+    kind: 'challenge';
+    modifier?: number;
+    items?: {
+        item: ItemDesc;
+        count: number;
+    }[];
+}
+export interface PuzzleTile extends BaseTile {
+    kind: 'puzzle';
+    enemies?: boolean;
+}
+export interface BoonBaneTile extends BaseTile {
+    kind: 'boonBane';
+}
+export interface ItemWCount {
+    item: ItemDesc;
+    count: number;
+}
+export {};

package/dist/expedition.js

@@ -0,0 +1,57 @@
+export const expeditionBaseCost = 87500;
+export const expeditionDirections = ['left', 'right', 'top', 'bottom'];
+export const expeditionDirectionOpposite = {
+    left: 'right',
+    right: 'left',
+    top: 'bottom',
+    bottom: 'top',
+};
+export const expeditionDirectionPoint = {
+    left: {
+        x: -1,
+        y: 0,
+    },
+    right: {
+        x: 2,
+        y: 0,
+    },
+    top: {
+        x: 0,
+        y: -1,
+    },
+    bottom: {
+        x: 0,
+        y: 2,
+    },
+};
+export const RoleRarityWeight = {
+    mundane: 30,
+    qitouched: 30,
+    empowered: 25,
+    resplendent: 20,
+    incandescent: 5,
+};
+export const rolesToName = {
+    fighter: 'Fighter',
+    healer: 'Healer',
+    surveyor: 'Surveyor',
+    archaeologist: 'Archeologist',
+    stabilizer: 'Stabilizer',
+    qiflow: 'Qi Manipulator',
+};
+export const roleDescription = {
+    fighter: 'Assists in limiting the prowess of fierce foes',
+    healer: 'Aids recuperation while resting',
+    surveyor: 'Analyzes signs of ambushes and plots routes avoiding them',
+    archaeologist: 'Utilizes expedition records to locate additional treasures',
+    stabilizer: 'Trained in placing spatial nodes that slow spatial destabilization',
+    qiflow: "Senses minute qi flow changes and manipulates them to the team's advantage",
+};
+export const RoleWeight = {
+    healer: 25,
+    archaeologist: 25,
+    surveyor: 20,
+    stabilizer: 15,
+    fighter: 10,
+    qiflow: 5,
+};

package/dist/fallenStar.d.ts

@@ -1,6 +1,7 @@
-import type { Buff, EnemyEntity, ItemDesc, Realm } from '.';
+import type { Buff, EnemyEntity, ItemDesc, Realm, Translatable } from '.';
 export interface FallenStar {
     name: string;
+    displayName?: Translatable;
     realm: Realm;
     image: string;
     monsterPool: {

package/dist/gameVersion.d.ts

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

package/dist/gameVersion.js

@@ -15,4 +15,4 @@
  *   };
  * }
  */
-export const GAME_VERSION = "0.6.56";
+export const GAME_VERSION = "0.6.58";

package/dist/index.d.ts

@@ -19,7 +19,6 @@ export * from './dualCultivation';
 export * from './element';
 export * from './entity';
 export * from './event';
-export * from './evolution';
 export * from './fallenStar';
 export * from './GameScreen';
 export * from './gameVersion';

package/dist/index.js

@@ -19,7 +19,6 @@ export * from './dualCultivation';
 export * from './element';
 export * from './entity';
 export * from './event';
-export * from './evolution';
 export * from './fallenStar';
 export * from './GameScreen';
 export * from './gameVersion';

package/dist/item.d.ts

@@ -12,7 +12,7 @@ import type { Realm, RealmProgress } from './realm';
 import type { RecipeDifficulty } from './RecipeDifficulty';
 import type { CombatStatistic, CombatStatsMap, CraftingStatistic, CraftingStatsMap, PhysicalStatistic, Scaling, SocialStatistic } from './stat';
 import type { Technique, TechniqueEffect } from './technique';
-import { DelveRoom } from './soulShardDelve';
+import { DelveRoomConfig } from './soulShardDelve';
 export declare const itemKinds: readonly ["clothing", "talisman", "artefact", "mount", "cauldron", "flame", "upgrade", "fruit", "elixir", "recipe", "technique", "action", "transport_seal", "enchantment", "pill", "reagent", "concoction", "consumable", "recuperation", "formation", "breakthrough", "pillar_shard", "material", "flare", "mystical_key", "condensation_art", "blueprint", "trophy", "treasure", "token", "life_essence", "device", "manual", "pillar_pattern", "local_map"];
 export type ItemKind = (typeof itemKinds)[number];
 export declare const itemKindToName: {
@@ -43,6 +43,13 @@ interface ItemBase {
     qualityTier?: number;
     hiddenPotential?: number;
     minimumPotential?: number;
+    corruption?: ItemCorruption;
+}
+export interface ItemCorruption {
+    name: Translatable;
+    debuff: Buff;
+    threshold: number;
+    countPerCombat: number;
 }
 export interface ItemDesc {
     name: string;
@@ -223,6 +230,14 @@ export interface CombatItem extends ItemBase {
 export interface ConsumablePillItem extends BasePillItem {
     pillKind: 'consumable';
     max: number;
+    /**
+     * Optional shared consumption group. When set, the player can consume at most `groupCap`
+     * pills total across every pill that names the same `consumptionGroup`, in addition to
+     * each pill's individual `max` limit.
+     */
+    consumptionGroup?: string;
+    /** Lifetime cap for the entire consumption group. Required when `consumptionGroup` is set. */
+    groupCap?: number;
     physicalStats: Partial<Record<PhysicalStatistic, number>>;
     socialStats: Partial<Record<SocialStatistic, number>>;
     rawStats?: Partial<Record<CombatStatistic | CraftingStatistic, Scaling>>;
@@ -292,6 +307,11 @@ export interface RecipeItem extends ItemBase {
     baseItem: Item;
     perfectItem: Item;
     sublimeItem?: Item;
+    /** Override the default perfection effect resolved from the perfectItem's
+     *  ItemKind in recipePerfectionEffect. Use 'quality' on recipes that should
+     *  reward perfect/sublime crafts with stronger items (quality tier bonus)
+     *  instead of producing more copies. */
+    perfectionEffectOverride?: 'none' | 'quality' | 'stacks';
     displayPerfect?: boolean;
     hideFromCompendium?: boolean;
     realmProgress: RealmProgress;
@@ -328,6 +348,7 @@ export interface CraftingTechniqueItem extends ItemBase {
 export interface TransportSealItem extends ItemBase {
     kind: 'transport_seal';
     destination: string;
+    omni?: boolean;
 }
 export interface EnchantmentItem extends ItemBase {
     kind: 'enchantment';
@@ -454,9 +475,9 @@ export interface PillarShardVariant {
 }
 export interface PillarShardItem extends ItemBase {
     kind: 'pillar_shard';
-    tooltip: Translatable;
+    tooltip?: Translatable;
     maxInstances?: number;
-    delveRoomConfig?: DelveRoom;
+    delveRoomConfig?: DelveRoomConfig;
     variants?: PillarShardVariant[];
     stability?: number;
     portal?: {
@@ -499,6 +520,8 @@ export interface UncutStonePool {
 }
 export interface LifeEssenceItem extends ItemBase {
     kind: 'life_essence';
+    /** Signature colour for UI (rings, slot borders, picker tints). Hex string. */
+    color: string;
     thresholds: {
         level: number;
         buffs: Buff[];

package/dist/itemAction.d.ts

@@ -0,0 +1,33 @@
+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

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

package/dist/life.d.ts

@@ -14,6 +14,11 @@ export interface LifeForm {
     role: string;
     species: string;
     image: string;
+    unlockCost: {
+        essence: string;
+        amount: number;
+    }[];
+    parentSpecies?: string;
     supportImage?: LifeFormAnimationImage;
     defensiveImage?: LifeFormAnimationImage;
     utilityImage?: LifeFormAnimationImage;