afnm-types 0.6.58 → 0.6.59

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' | 'expedition' | 'pillarGrid' | 'fallenStar' | 'trainingGround' | 'tenThousandFlames' | 'lifeScreen' | 'soulShardDelve' | 'enchantmentShop' | 'challengeBoard';
+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' | 'formationPuzzle' | 'rumours';
 export type ScreenType = GameScreen | 'newgame' | 'combat' | 'crafting' | 'dualCultivation' | 'event' | 'auction' | 'mysticalRegion' | 'tournament' | 'house' | 'guild' | 'stoneCutting' | 'fallenStar' | 'soulShardDelve' | 'expedition';

package/dist/audio.d.ts

@@ -1,6 +1,6 @@
 export declare const ambienceNames: readonly ["HerbField", "Market", "Forge", "SectHall", "Wind", "Crypt", "Forest", "Rain", "BoilingLake", "BoilingLakeSurface", "Field", "Space", "CultivationChamber"];
 export type AmbienceName = (typeof ambienceNames)[number];
-export declare const musicNames: readonly ["Ascending", "Crafting", "Crypt", "Forest", "Herb", "Lake", "Liangtiao", "Mine", "Observatory", "Reststop", "Sect", "Settingoff", "Shenhenda", "Tomb", "Valley", "Combat", "Xidian", "North", "Wastes", "DualCultivation", "ProgenitorRuGong", "ProgenitorDongTiang", "ProgenitorYingMeihua", "ProgenitorDiaoGian", "ProgenitorTeJinshu", "ProgenitorLuBuLin"];
+export declare const musicNames: readonly ["Ascending", "Crafting", "Crypt", "Forest", "Herb", "Lake", "Liangtiao", "Mine", "Observatory", "Reststop", "Sect", "Settingoff", "Shenhenda", "Tomb", "Valley", "Combat", "Xidian", "North", "Wastes", "DualCultivation", "ProgenitorRuGong", "ProgenitorDongTiang", "ProgenitorYingMeihua", "ProgenitorDiaoGian", "ProgenitorTeJinshu", "ProgenitorLuBuLin", "YuMaiMine", "JadeForest", "Expedition", "SoulShard"];
 export type MusicName = (typeof musicNames)[number];
 export declare const soundEffectNames: readonly ["Hit", "Buff", "Debuff", "Heal", "Death", "Fuse", "Refine", "Stabilize", "Equip", "Drink", "Learn", "Crystal", "Eat", "BuySell", "Select", "Confirm", "Hover", "Cancel", "OpenEquip", "PlayerDialogOpen", "CrystalCrack", "CrystalCrackOpen", "CrystalCrackBg", "ChangeTab", "Failed", "MasteryUnveil", "BuildingEnter", "Talk", "Healer", "DialogClose", "BuildingLeave", "SelectItem", "RemoveItem", "BottleneckBreakthrough", "BreakthroughLightning", "Pool", "CraftingBuff", "CraftFail", "CraftSuccess", "PerfectCraft", "TakeItem", "Text", "Speech", "Destiny", "Money", "Favour", "Reputation", "Qi", "Location", "BreakthroughItemSet", "BreakthroughItemRemove", "Footstep", "Fly", "SpawnImpact", "SelectStance", "Plant", "Unplant", "Collect", "Dig", "GrowlBark", "GrowlChirp", "GrowlDeep", "GrowlDrone", "GrowlFrog", "GrowlGrind", "GrowlHigh", "GrowlLoud", "GrowlMinotaur", "GrowlRumble", "GrowlScreech", "GrowlSlow", "GrowlSnuffle", "Satisfaction", "CloudAttack", "BlossomAttack", "FistAttack", "WeaponAttack", "BloodAttack", "CelestialAttack"];
 export type SoundEffectName = (typeof soundEffectNames)[number];

package/dist/audio.js

@@ -40,6 +40,10 @@ export const musicNames = [
     'ProgenitorDiaoGian',
     'ProgenitorTeJinshu',
     'ProgenitorLuBuLin',
+    'YuMaiMine',
+    'JadeForest',
+    'Expedition',
+    'SoulShard',
 ];
 export const soundEffectNames = [
     'Hit',

package/dist/breakthrough.d.ts

@@ -3,9 +3,17 @@ import type { ReactNode } from 'react';
 import type { CombatEntity, CraftingEntity, PlayerEntity, StoredStance, StoredStyle } from './entity';
 import type { ItemDesc } from './item';
 import type { Realm, RealmProgress } from './realm';
-import type { PhysicalStatistic, SocialStatistic, Scaling } from './stat';
+import type { CombatStatistic, CraftingStatistic, PhysicalStatistic, Scaling, SocialStatistic } from './stat';
 import type { Buff } from './buff';
 import type { CraftingBuff } from './craftingBuff';
+/**
+ * Discriminator for manifestation events queued and replayed during the
+ * lifeFlourishing breakthrough. Runtime constants matching each member live
+ * in src/store/slices/manifestation/manifestationFlags.ts and are typed
+ * against this union, so adding a new event there only compiles after the
+ * member is added here.
+ */
+export type ManifestationEventId = 'manifestation_birth' | 'manifestation_aspect_filled_creativity' | 'manifestation_aspect_filled_empathy' | 'manifestation_aspect_filled_agency' | 'manifestation_focus_selector';
 export interface Position {
     x: number;
     y: number;
@@ -25,11 +33,26 @@ export interface StoredFigment {
     storedStyles?: StoredStyle[];
     assignedTiers?: Record<string, number>;
 }
+/** Variant of an incursion fight. Drives the enemy roster and the reward
+ *  amount the player gets when they win. */
+export type IncursionKind = 'normal' | 'horde' | 'boss';
 /** An active firmament incursion targeting the player's inner world */
 export interface ActiveIncursion {
     id: string;
     spawnedYear: number;
     spawnedMonth: number;
+    /** Variant of fight when the player engages this incursion. Defaults to
+     *  'normal' for backward compatibility with saves spawned before kinds
+     *  existed. */
+    kind?: IncursionKind;
+    /** Frozen difficulty proxy used to scale the enemies on engagement.
+     *  Sampled at spawn time from the live firmament progress plus a small
+     *  random jitter and a -5% offset per active incursion. Falling back to
+     *  the live progress is fine for legacy incursions. */
+    effectiveProgress?: number;
+    /** Amount of +N applied per chosen figment-upgrade pick after a win.
+     *  1 for normal, larger for harder variants. */
+    upgradeAmount?: number;
 }
 /** Generated but uncollected essence accumulating in the inner world */
 export interface PendingEssence {
@@ -37,6 +60,70 @@ export interface PendingEssence {
     count: number;
     progress: number;
 }
+/** Three life aspects that grow as the manifestation lives in the world. */
+export type ManifestationAspect = 'creativity' | 'empathy' | 'agency';
+/** A single entry in the manifestation's activity diary. */
+export interface ManifestationLogEntry {
+    year: number;
+    month: number;
+    day: number;
+    /** Localisable log line built from real game-data nouns. */
+    text: Translatable;
+    /** Which aspect this entry advanced, if any. */
+    aspect?: ManifestationAspect;
+    /** Aspect delta from this entry (typically 0 on failure, +1 on success). */
+    delta?: number;
+}
+/** Tracks one recently-consumed item for the creativity gift bonus. */
+export interface ManifestationConsumptionEntry {
+    item: string;
+    count: number;
+    day: number;
+}
+/** Capstone of the Life Flourishing realm: an autonomous lifeform walking the world. */
+export interface ManifestationState {
+    /** Player-visible name. Generated at first manifest, editable. */
+    name: string;
+    /** Linked StoredFigment id that provides visuals, species, and stances. */
+    figmentId: string;
+    /** Calendar year of first manifestation. */
+    birthYear: number;
+    /** Calendar month of first manifestation. */
+    birthMonth: number;
+    /** Aspect values, 0..100 integer. */
+    creativity: number;
+    empathy: number;
+    agency: number;
+    /** Biases the monthly move decision and which aspect category actions prefer. */
+    focus: ManifestationAspect;
+    /** Current location (GameLocation.name) the manifestation is wandering at. */
+    locationName: string;
+    /** Months spent at the current location; forces a move if it stagnates. */
+    monthsAtLocation: number;
+    /**
+     * Destination the manifestation is travelling toward. Movement is
+     * resolved one node per month along the shortest path; once
+     * `locationName === destinationLocationName` the field is cleared.
+     * Undefined means "no current journey, idle at locationName."
+     */
+    destinationLocationName?: string;
+    /** Ring buffer of diary entries, newest last. Capped at MANIFESTATION_LOG_CAP. */
+    log: ManifestationLogEntry[];
+    /** Accumulator so day-batches still emit one entry per 3 days. */
+    daysSinceLastLog: number;
+    /** Manifestation events that have already played. */
+    seenEvents: ManifestationEventId[];
+    /** Manifestation event queued to play on next player co-located interaction. */
+    pendingEvent?: ManifestationEventId;
+    /** Months until a random-encounter milestone is eligible again. */
+    randomEventCooldown: number;
+    /** Creativity gift cooldown in months. <=0 means eligible to gift. */
+    creativityGiftCooldown: number;
+    /** Empathy companion cooldown in months. <=0 means eligible to join. */
+    empathyCompanionCooldown: number;
+    /** Items the player has recently consumed; bounded ring of size MANIFESTATION_CONSUMPTION_CAP. */
+    recentConsumption: ManifestationConsumptionEntry[];
+}
 /** State for the Life Flourishing breakthrough system */
 export interface LifeFlourishingState {
     unlockedSpecies: string[];
@@ -47,6 +134,74 @@ export interface LifeFlourishingState {
     activeIncursions?: ActiveIncursion[];
     pendingEssences?: PendingEssence[];
     essenceTiersUnlocked?: Record<string, number>;
+    /** The single manifested lifeform, if any. */
+    manifestation?: ManifestationState;
+    /**
+     * Lifeform realm used for inner-world combat (incursions + expand) ONLY.
+     * Independent of the player's realm. Defaults to bodyForging / Early when
+     * unset. When the lifeform is manifested in the outer world, the
+     * manifestation companion stats still read player realm.
+     */
+    lifeformRealm?: Realm;
+    /** Step within the lifeform realm: 0 = Early, 1 = Middle, 2 = Late. */
+    lifeformRealmStep?: LifeformRealmStep;
+    /**
+     * Calendar stamp of when the player first created any figment. Drives the
+     * time component of the incursion spawn rate. Undefined => no incursions
+     * can spawn yet.
+     */
+    firstFigmentYear?: number;
+    firstFigmentMonth?: number;
+    /** Global figment upgrade pool earned from incursion victories. */
+    figmentUpgrades?: FigmentUpgrades;
+    /**
+     * Present while an unspent incursion-victory upgrade is owed to the player.
+     * The Life screen renders a blocking picker until the player picks one.
+     * `upgradeAmount` is the +N applied when an upgrade is chosen; carried over
+     * from the resolved incursion so harder variants pay out more.
+     * `baseExpansion` is the firmament-expansion gain already auto-applied on
+     * victory (1-3%), surfaced in the picker so the player can see it.
+     */
+    pendingFigmentUpgrade?: {
+        upgradeAmount: number;
+        baseExpansion: number;
+    };
+    /** Ids of minor world aspects the player has unlocked. */
+    unlockedMinorAspectIds?: string[];
+    /**
+     * Three slots arranged in an arc below the main aspect; each entry is the
+     * world aspect id placed in that slot (major or minor) or undefined.
+     * Length grows as the player unlocks slots (cap 3).
+     */
+    slottedAspectIds?: (string | undefined)[];
+    /**
+     * Months remaining of firmament-suppression from a consumed Calming item.
+     * While positive, the monthly incursion-chance accumulation is halved.
+     * Refreshing the buff (consuming another item) re-sets it to the full
+     * duration rather than stacking.
+     */
+    firmamentReductionMonths?: number;
+    /**
+     * Accumulated incursion-spawn chance, 0..100. Each month the spawn formula
+     * adds its computed value to this counter (instead of rolling against it).
+     * When it crosses 100 an incursion spawns and the counter resets to 0.
+     */
+    incursionChance?: number;
+}
+/** Step within a lifeform realm: 0 = Early, 1 = Middle, 2 = Late. */
+export type LifeformRealmStep = 0 | 1 | 2;
+/**
+ * Global figment combat upgrades. The five percent fields are capped at 30
+ * (each point = +1%). Enhancement is uncapped and applies as a flat +N
+ * enhancement to every figment technique used in inner-world combat.
+ */
+export interface FigmentUpgrades {
+    hp: number;
+    power: number;
+    protection: number;
+    barrierMit: number;
+    critMult: number;
+    enhancement: number;
 }
 export interface BreakthroughState {
     mundane?: {
@@ -66,6 +221,10 @@ export interface BreakthroughState {
     };
     coreFormation?: {
         compressions?: number;
+        /** Location names of altars the player has successfully compressed at
+         *  at least once. Used to gate past-9 over-compressions to new altars,
+         *  and to grant per-altar stat bonuses on breakthrough. */
+        beatenAltars?: string[];
     };
     pillarCreation?: {
         grid: string[];
@@ -100,6 +259,16 @@ export interface BreakthroughBase {
     socialStats: Partial<{
         [key in SocialStatistic]: number;
     }>;
+    /** Permanent additive combat-stat bonuses granted by the breakthrough.
+     *  Values are `Scaling` so the dialog can render multipliers as "+10%
+     *  Power" instead of the evaluated flat amount. */
+    combatStats?: Partial<{
+        [key in CombatStatistic]: Scaling;
+    }>;
+    /** Permanent additive crafting-stat bonuses granted by the breakthrough. */
+    craftingStats?: Partial<{
+        [key in CraftingStatistic]: Scaling;
+    }>;
     combatBuffs?: {
         buff: Buff;
         buffStacks: Scaling;
@@ -159,6 +328,12 @@ export interface Breakthrough extends BreakthroughBase {
         socialStats: Partial<{
             [key in SocialStatistic]: number;
         }>;
+        combatStats?: Partial<{
+            [key in CombatStatistic]: Scaling;
+        }>;
+        craftingStats?: Partial<{
+            [key in CraftingStatistic]: Scaling;
+        }>;
         combatBuffs?: {
             buff: Buff;
             buffStacks: Scaling;

package/dist/buff.d.ts

@@ -101,6 +101,14 @@ export interface Buff {
     type?: TechniqueElement;
     noneType?: string;
     secondaryType?: TechniqueElement | 'origin';
+    /** Marks this buff as droplet-flavoured. Its outgoing damage / heal / barrier
+     * / temp HP effects gain the entity's <n>dropletBoost</n>, exactly as if the
+     * effects came from a technique with a droplet cost. */
+    isDroplet?: boolean;
+    /** Marks this buff as an opener for boost purposes. Effects gain <n>openerBoost</n>. */
+    isOpener?: boolean;
+    /** Marks this buff as a finisher for boost purposes. Effects gain <n>finisherBoost</n>. */
+    isFinisher?: boolean;
     enhancement?: number;
     beforeTechniqueEffects?: BuffEffect[];
     afterTechniqueEffects?: BuffEffect[];
@@ -188,6 +196,11 @@ export interface Buff {
     guardianHp?: number;
     /** Runtime guardian max HP — set automatically from guardianIntercept.maxHp at buff creation */
     guardianMaxHp?: number;
+    /** Cached hash of the static portion of this buff (name, flag, buffType,
+     *  stats keys and values, condition). Populated lazily by cloneCombatEntity
+     *  and createBuff so subsequent clones carry it forward via object spread,
+     *  saving the per-call string-hashing work in calculateCombatEntityHash. */
+    _staticHash?: number;
 }
 type BuffCombatImage = ScatterCombatImage | ArcCombatImage | FloatingCombatImage | OverlayCombatImage | CompanionCombatImage | GuardianCombatImage | GroundCombatImage | FormationCombatImage | ForegroundCombatImage | BackgroundCombatImage | TransformationCombatImage | AvatarEffectCombatImage;
 interface BaseCombatImage {

package/dist/buffIndexes.d.ts

@@ -0,0 +1,21 @@
+import type { Buff } from './buff';
+/**
+ * Per-entity indexes built by walking entity.buffs once, then read repeatedly
+ * during combat to avoid filtering the full buff list per category lookup.
+ *
+ * Invariant: indexes hold direct references into entity.buffs. They are valid
+ * only while that array's contents are unchanged. cloneCombatEntity does not
+ * carry the cache forward; invalidateEntityHash clears it after any mutation
+ * routed through mutateCombatEntity.
+ */
+export interface BuffIndexes {
+    beforeTechnique: Buff[];
+    afterTechnique: Buff[];
+    onRound: Buff[];
+    onRoundStart: Buff[];
+    damageIntercept: Buff[];
+    guardian: Buff[];
+    buffAmplifier: Buff[];
+    techniqueAmplifier: Buff[];
+    byStat: Record<string, Buff[]>;
+}

package/dist/buffIndexes.js

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

package/dist/buildSubmission.d.ts

@@ -109,5 +109,7 @@ export interface NormalizedBuildSubmission {
         name?: string;
         stances: StoredStance[];
         currentStyle?: StoredStyle;
+        /** Per-essence tier assignments for this figment. */
+        assignedTiers?: Record<string, number>;
     };
 }

package/dist/character.d.ts

@@ -111,7 +111,7 @@ export interface Character {
         condition: string;
     }[];
 }
-export declare const characterRelationships: readonly ["Hostile", "Neutral", "Friendly", "Intimate"];
+export declare const characterRelationships: readonly ["Hostile", "Neutral", "Friendly", "Intimate", "Special"];
 export type CharacterRelationship = (typeof characterRelationships)[number];
 export declare const relationshipTextColour: Record<CharacterRelationship, string>;
 export declare const relationshipBorderColour: Record<CharacterRelationship, string>;
@@ -196,6 +196,7 @@ export interface ShopCharacterInteraction extends BaseCharacterInteraction {
         tokenStock: Array<{
             item: Item;
             tokenCost: number;
+            buyAsStack?: boolean;
         }>;
     };
 }

package/dist/character.js

@@ -1,19 +1,28 @@
-export const characterRelationships = ['Hostile', 'Neutral', 'Friendly', 'Intimate'];
+export const characterRelationships = [
+    'Hostile',
+    'Neutral',
+    'Friendly',
+    'Intimate',
+    'Special',
+];
 export const relationshipTextColour = {
     Hostile: 'red',
     Neutral: 'white',
     Friendly: 'palegreen',
     Intimate: 'pink',
+    Special: 'gold',
 };
 export const relationshipBorderColour = {
     Hostile: '#780000',
     Neutral: 'rgb(75,75,75)',
     Friendly: '#19521e',
     Intimate: '#9e007c',
+    Special: '#7a5900',
 };
 export const relationshipTooltip = {
     Hostile: 'You can attack a hostile character, or threaten them to steal their possessions.',
     Neutral: 'Willing to talk and maybe trade with you, but little else.',
     Friendly: '',
     Intimate: '',
+    Special: '',
 };

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

@@ -46,6 +46,7 @@ exports.NON_TRANSLATABLE_PROPERTIES = [
     'shard',
     'ability',
     'guild',
+    'relationship',
     'eventName',
     'achievementID',
     'apiSecret',
@@ -327,6 +328,10 @@ exports.EXCLUDE_PATTERNS = [
     /^[a-z]+-[a-z]+,\s*[a-z]+-[a-z]+$/,
     // shaders
     /.*vec2.*/,
+    // CSS anywhere in the string
+    /@keyframes/,
+    /box-shadow/,
+    /rgb/i,
 ];
 /** Patterns to exclude from code-changes report */
 exports.CODE_CHANGE_EXCLUDE_PATTERNS = [

package/dist/combat.d.ts

@@ -97,7 +97,7 @@ export interface CurrentCombatState {
     enemyEffectTracking: Record<string, CombatEffectTracking>;
     stanceTracking: Record<string, StanceTracking>;
     partyStanceTracking: Record<number, Record<string, StanceTracking>>;
-    pillTracking: Record<string, number>;
+    pillTracking: Record<string, InventoryItemState>;
     autoUseRowTracking: Record<number, number>;
     inventoryItems?: InventoryItemState[];
     loot: Item[];

package/dist/entity.d.ts

@@ -1,6 +1,7 @@
 import type { Translatable } from './translatable';
 import type { SoundEffectName } from './audio';
 import type { Buff } from './buff';
+import type { BuffIndexes } from './buffIndexes';
 import type { CraftingBuff } from './craftingBuff';
 import type { CraftingTechnique, KnownCraftingTechnique } from './craftingTechnique';
 import type { TechniqueElement } from './element';
@@ -337,6 +338,12 @@ export interface CombatEntity {
     maxqiDroplets?: number;
     /** Cached hash for getVariablesFromEntity. Cleared whenever stats or buffs mutate. */
     _cachedHash?: string;
+    /** Cached buff indexes (by effect category and by stat). Cleared whenever buffs mutate.
+     *  See src/util/buffIndexes.ts. */
+    _buffIndexes?: BuffIndexes;
+    /** Cached pre-trigger buff-count snapshot. Cleared whenever buffs mutate.
+     *  See src/combat/effects/preTriggerSnapshot.ts. */
+    _preTriggerSnapshot?: Record<string, number>;
 }
 export type StanceRule = SingleStance | RandomStance;
 export interface SingleStance {

package/dist/event.d.ts

@@ -7,6 +7,7 @@ import type { CraftingBuff } from './craftingBuff';
 import type { IntimateTrait } from './dualCultivation';
 import type { TechniqueElement } from './element';
 import type { EnemyEntity } from './entity';
+import type { FormationGlyphId, FormationNodeId, FormationWinCondition } from './formation';
 import type { ItemDesc } from './item';
 import type { Realm, RealmProgress } from './realm';
 import type { PhysicalStatistic, ReputationTier, SocialStatistic } from './stat';
@@ -33,13 +34,13 @@ export interface GameEvent {
         value: number;
     }[];
 }
-export declare const EVENT_STEP_KINDS: readonly ["text", "speech", "combat", "crafting", "choice", "conditional", "flag", "exit", "createBuff", "consumeBuff", "addItem", "addMultipleItem", "dropItem", "removeItem", "replaceItem", "location", "quest", "money", "favour", "destiny", "reputation", "qi", "unlockLocation", "unlockAltar", "setCharacter", "clearCharacter", "label", "gotoLabel", "unlockCraftingTechnique", "unlockTechnique", "unlockAuctionTechnique", "addRecipe", "addManual", "learnNpcStances", "talkToCharacter", "tradeWithCharacter", "craftWithCharacter", "fightCharacter", "markBeatCharacter", "markDidEncounter", "changeHp", "passTime", "analytics", "approval", "progressRelationship", "selectRelationshipPath", "updateCharacterDefinition", "markGifted", "auction", "markCalendarEventComplete", "advanceMysticalRegion", "craftSkill", "tournament", "dualCultivation", "teamUp", "craftingTeamUp", "addFollower", "breakParty", "clearTeamUp", "setAltarCooldown", "setTradeCooldown", "compressCore", "changeScreen", "changeBGM", "clearChangeBGM", "addGuildApproval", "advanceGuildRank", "overridePlayerRealm", "setContentRealmOverride", "setAidBreakthroughCooldown", "stoneCutting", "giveItem", "changePhysicalStat", "changeSocialStat", "status", "clearStatus"];
+export declare const EVENT_STEP_KINDS: readonly ["text", "speech", "combat", "crafting", "choice", "conditional", "flag", "exit", "createBuff", "consumeBuff", "addItem", "addMultipleItem", "dropItem", "removeItem", "replaceItem", "location", "quest", "money", "favour", "destiny", "reputation", "qi", "unlockLocation", "unlockAltar", "setCharacter", "clearCharacter", "label", "gotoLabel", "unlockCraftingTechnique", "unlockTechnique", "unlockAuctionTechnique", "addRecipe", "addManual", "learnNpcStances", "talkToCharacter", "tradeWithCharacter", "craftWithCharacter", "fightCharacter", "markBeatCharacter", "markDidEncounter", "changeHp", "passTime", "analytics", "approval", "progressRelationship", "selectRelationshipPath", "updateCharacterDefinition", "markGifted", "auction", "markCalendarEventComplete", "advanceMysticalRegion", "craftSkill", "tournament", "dualCultivation", "teamUp", "craftingTeamUp", "addFollower", "breakParty", "clearTeamUp", "setAltarCooldown", "setTradeCooldown", "compressCore", "changeScreen", "changeBGM", "clearChangeBGM", "addGuildApproval", "advanceGuildRank", "overridePlayerRealm", "setContentRealmOverride", "setAidBreakthroughCooldown", "stoneCutting", "formationPuzzle", "giveItem", "changePhysicalStat", "changeSocialStat", "status", "clearStatus"];
 export type EventStepKind = (typeof EVENT_STEP_KINDS)[number];
 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 | IncreaseInstabilityStep | EndExpeditionStep | AddItemsToFoundStep | AddItemsToExtractedStep;
+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 | FormationPuzzleStep | GiveItemStep | ChangePhysicalStatStep | ChangeSocialStatStep | SelectRelationshipPathStep | SetTradeCooldownStep | StatusStep | ClearStatusStep | IncreaseInstabilityStep | EndExpeditionStep | AddItemsToFoundStep | AddItemsToExtractedStep;
 export interface TextStep extends BaseEventStep {
     kind: 'text';
     text: Translatable;
@@ -125,6 +126,7 @@ interface ItemCondition {
     item: ItemDesc;
     alternates?: ItemDesc[];
     amount: number;
+    displayName?: Translatable;
 }
 interface MoneyCondition {
     kind: 'money';
@@ -470,6 +472,39 @@ export interface StoneCuttingStep extends BaseEventStep {
     /** Number of stones the player can cut for free, evaluated as expression */
     freeCount?: string;
 }
+export interface FormationPuzzleStep extends BaseEventStep {
+    kind: 'formationPuzzle';
+    isTutorial?: boolean;
+    /** Shown in the activity history when the puzzle starts. */
+    displayName?: string;
+    /** Prefix for the per-glyph completion flags. For each glyph type with at
+     *  least one activated placement, two flags are written, keyed by the
+     *  glyph's single-character `gridSymbol` (the same symbol used in `layout`).
+     *  `{flagPrefix}_{gridSymbol}` holds the total power absorbed across
+     *  activated placements of that glyph type, and
+     *  `{flagPrefix}_{gridSymbol}_count` holds the number of activated (fully
+     *  powered) placements of that glyph type. */
+    flagPrefix: string;
+    /** ASCII grid layout. Each non-empty line is one row (top = y=0).
+     *  Tokens: `.` empty cell, `_` off-grid, node gridSymbol for pre-placed
+     *  (locked) nodes, `SYM:>` for a rotated pre-placed node. */
+    layout: string;
+    pool: {
+        nodes: {
+            nodeId: FormationNodeId;
+            count: number;
+        }[];
+        glyphs: {
+            nodeId: FormationGlyphId;
+            count: number;
+        }[];
+    };
+    winCondition: FormationWinCondition[];
+    /** Followed when the player presses Seal with the win condition met. */
+    success: EventStep[];
+    /** Followed when the player presses Give Up. */
+    failure: EventStep[];
+}
 export interface GiveItemStep extends BaseEventStep {
     kind: 'giveItem';
     description: Translatable;

package/dist/event.js

@@ -70,6 +70,7 @@ export const EVENT_STEP_KINDS = [
     'setContentRealmOverride',
     'setAidBreakthroughCooldown',
     'stoneCutting',
+    'formationPuzzle',
     'giveItem',
     'changePhysicalStat',
     'changeSocialStat',

package/dist/expedition.d.ts

@@ -17,7 +17,7 @@ export interface ExpeditionPoint {
     x: number;
     y: number;
 }
-export type RoleRarity = Exclude<Rarity, 'transcendent'>;
+export type RoleRarity = Rarity;
 export declare const RoleRarityWeight: Record<RoleRarity, number>;
 export type Roles = 'fighter' | 'healer' | 'surveyor' | 'archaeologist' | 'stabilizer' | 'qiflow';
 export declare const rolesToName: Record<Roles, string>;
@@ -28,7 +28,8 @@ export type MemberRole = {
     rarity: RoleRarity;
 };
 export type TeamMember = {
-    name: Translatable;
+    name: string;
+    displayName: Translatable;
     buff?: Buff;
     role: MemberRole;
 };
@@ -125,4 +126,12 @@ export interface ItemWCount {
     item: ItemDesc;
     count: number;
 }
+export interface NpcPoints {
+    name: Translatable;
+    points: number;
+}
+export interface TeamPoints {
+    playerPoints: number;
+    npcPoints: NpcPoints[];
+}
 export {};

package/dist/expedition.js

@@ -29,7 +29,8 @@ export const RoleRarityWeight = {
     qitouched: 30,
     empowered: 25,
     resplendent: 20,
-    incandescent: 5,
+    incandescent: 10,
+    transcendent: 3,
 };
 export const rolesToName = {
     fighter: 'Fighter',

package/dist/formation.d.ts

@@ -0,0 +1,74 @@
+import type { ReactNode } from 'react';
+export type FormationSourcePower = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+export type FormationSourceId = `source${FormationSourcePower}`;
+export type FormationChannelingNodeId = 'multiplyForward' | 'turnRight' | 'turnLeft' | 'splitTwo' | 'splitThree' | 'mergeTo5' | 'mergeOpposite' | 'mergeThree' | 'pivotHalve' | 'crossHalve' | 'crossEnhance' | 'flatSplit' | 'forkRight' | 'forkLeft' | 'enhanceRight' | 'enhanceLeft' | 'enhanceExcessRight' | 'enhanceExcessLeft' | 'flatForward' | 'flatForwardHigh' | 'mergeCornerRight' | 'mergeCornerLeft' | 'splitTwoFull' | 'forkAsymmetricRight' | 'forkAsymmetricLeft' | 'addOne' | 'addTwo';
+export type FormationBlockerId = 'blocker';
+export interface FormationNode {
+    id: FormationNodeId;
+    displayName: string;
+    description: string;
+    /** Single character used to reference this node in ASCII puzzle layouts
+     *  (see formationPuzzleFromAscii). Must be unique across the registry.
+     *  Reserved: '.' (empty cell) and ' ' (off-grid). */
+    gridSymbol: string;
+    /** SVG inner body, rendered by FormationSymbol on a 0..100 viewBox.
+     *  Authored canonically (top of symbol = up). Grid rotation handles the
+     *  physical orientation. */
+    renderer: ReactNode;
+    inputs?: {
+        left?: number;
+        right?: number;
+        bottom?: number;
+        top?: number;
+    };
+    anyInputSuffices?: boolean;
+    output?: {
+        mode: 'flat' | 'multiply' | 'add';
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
+    portal?: {
+        type: 'entrance' | 'exit';
+    };
+    complexity: 'basicRouting' | 'basicEnhance' | 'advancedRouting' | 'advancedEnhance' | 'overpowered' | 'special';
+}
+export interface FormationPuzzleCell {
+    id: string;
+    x: number;
+    y: number;
+}
+export interface FormationPuzzlePlacement {
+    nodeId: FormationNodeId;
+    x: number;
+    y: number;
+    rotation: number;
+    locked?: boolean;
+}
+export type FormationAbsorberMode = 'All' | 'One';
+export type FormationAbsorberThreshold = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+export type FormationGlyphId = `absorber${FormationAbsorberMode}${FormationAbsorberThreshold}`;
+type AbsorberModeSymbol = 'a' | 'o';
+export type FormationGlyphSymbol = `${AbsorberModeSymbol}${FormationAbsorberThreshold}`;
+export type FormationNodeId = FormationSourceId | FormationChannelingNodeId | FormationBlockerId | FormationGlyphId;
+export interface FormationWinCondition {
+    glyph: FormationGlyphSymbol;
+    minActivated: number;
+}
+export interface FormationPuzzleDefinition {
+    cells: FormationPuzzleCell[];
+    prePlaced: FormationPuzzlePlacement[];
+    pool: {
+        nodes: {
+            nodeId: FormationNodeId;
+            count: number;
+        }[];
+        glyphs: {
+            nodeId: FormationGlyphId;
+            count: number;
+        }[];
+    };
+    winCondition: FormationWinCondition[];
+}
+export {};

package/dist/formation.js

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

package/dist/gameVersion.d.ts

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

package/dist/gameVersion.js

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

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export * from './DamageType';
 export * from './destiny';
 export * from './dualCultivation';
 export * from './element';
+export * from './expedition';
 export * from './entity';
 export * from './event';
 export * from './fallenStar';
@@ -50,3 +51,6 @@ export * from './tournament';
 export * from './trainingGround';
 export * from './translatable';
 export * from './tutorial';
+export * from './expedition';
+export * from './worldAspect';
+export * from './avatarEffects';

package/dist/index.js

@@ -17,6 +17,7 @@ export * from './DamageType';
 export * from './destiny';
 export * from './dualCultivation';
 export * from './element';
+export * from './expedition';
 export * from './entity';
 export * from './event';
 export * from './fallenStar';
@@ -50,3 +51,6 @@ export * from './tournament';
 export * from './trainingGround';
 export * from './translatable';
 export * from './tutorial';
+export * from './expedition';
+export * from './worldAspect';
+export * from './avatarEffects';

package/dist/item.d.ts

@@ -241,6 +241,18 @@ export interface ConsumablePillItem extends BasePillItem {
     physicalStats: Partial<Record<PhysicalStatistic, number>>;
     socialStats: Partial<Record<SocialStatistic, number>>;
     rawStats?: Partial<Record<CombatStatistic | CraftingStatistic, Scaling>>;
+    /**
+     * Optional flag effect: when consumed, iterates the flag value by `amount`.
+     * The flag is used to track cumulative effects across multiple pill consumptions.
+     */
+    flagEffect?: {
+        /** Key to search in the flags Record */
+        flag: string;
+        /** Value to iterate the flag by (can be negative for subtraction) */
+        amount: number;
+    };
+    /** Optional tooltip to explain the pill's effects in the consumption dialogue */
+    tooltip?: string;
     toxicity?: undefined;
 }
 export interface CraftingEquipmentItem extends ItemBase {
@@ -413,10 +425,6 @@ export interface CondensationArtItem extends ItemBase {
     artName: string;
     patternBg: string;
     patternOpacity: number;
-    condenseCost: number;
-    hpCost?: number;
-    moneyCost?: number;
-    producedDroplets: number;
     maxDroplets: number;
     restoredDroplets?: number;
     statChange: Partial<Record<PhysicalStatistic, number>>;
@@ -435,7 +443,6 @@ export interface CondensationArtItem extends ItemBase {
 export interface CondensationArtEnchantment extends Enchantment {
     itemKind: 'condensation_art';
     condenseEfficiency?: number;
-    producedDroplets?: number;
     maxDroplets?: number;
     charisma?: number;
     qiAbsorption?: number;

package/dist/life.d.ts

@@ -14,6 +14,7 @@ export interface LifeForm {
     role: string;
     species: string;
     image: string;
+    portrait?: string;
     unlockCost: {
         essence: string;
         amount: number;

package/dist/location.d.ts

@@ -3,7 +3,7 @@ import type { ScreenEffectType } from './ScreenEffectType';
 import type { EventStep } from './event';
 import type { Rarity } from './rarity';
 import type { Realm, RealmProgress } from './realm';
-import type { ReputationTier } from './stat';
+import type { CombatStatistic, CraftingStatistic, ReputationTier, Scaling } from './stat';
 import type { EnemyEntity } from './entity';
 import type { Item, ItemDesc } from './item';
 import type { House, HouseData } from './house';
@@ -146,9 +146,34 @@ export interface CraftingMission {
     condition: string;
 }
 export declare const exploresPerUnlock = 3;
-export type BuildingType = 'cultivation' | 'manual' | 'crafting' | 'mission' | 'craftingHall' | 'healer' | 'market' | 'favourExchange' | 'vault' | 'custom' | 'herbField' | 'mine' | 'recipe' | 'requestBoard' | 'compendium' | 'mysticalRegion' | 'expedition' | 'trainingGround' | 'library' | 'house' | 'altar' | 'research' | 'reforge' | 'guild' | 'tenThousandFlames' | 'soulShardDelve' | 'enchantmentShop' | 'challengeBoard' | 'jadeCutter' | 'modBuilding';
-export type LocationBuilding = CultivationBuilding | ManualBuilding | CraftingBuilding | MissionBuilding | CraftingHallBuilding | HealerBuilding | MarketBuilding | VaultBuilding | FavourExchangeBuilding | CustomBuilding | HerbFieldBuilding | MineBuilding | RecipeLibraryBuilding | RequestBoardBuilding | CompendiumBuilding | MysticalRegionBuilding | TrainingGroundBuilding | LibraryBuilding | HouseBuilding | CompressionAltarBuilding | ResearchBuilding | ReforgeBuilding | ExpeditionBuilding | GuildBuilding | TenThousandFlamesBuilding | SoulShardDelveBuilding | EnchantmentShopBuilding | ChallengeBoardBuilding | JadeCutterBuilding | ModBuilding;
-export type LocationBuildingState = MissionBuildingState | CraftingHallBuildingState | ShopBuildingState | RequestBoardBuildingState | HouseBuildingState | CompressionAltarBuildingState;
+export type BuildingType = 'cultivation' | 'manual' | 'crafting' | 'mission' | 'craftingHall' | 'healer' | 'market' | 'favourExchange' | 'vault' | 'custom' | 'herbField' | 'mine' | 'recipe' | 'requestBoard' | 'compendium' | 'mysticalRegion' | 'expedition' | 'trainingGround' | 'library' | 'house' | 'altar' | 'research' | 'reforge' | 'guild' | 'tenThousandFlames' | 'soulShardDelve' | 'enchantmentShop' | 'challengeBoard' | 'jadeCutter' | 'rumours' | 'modBuilding';
+export type LocationBuilding = CultivationBuilding | ManualBuilding | CraftingBuilding | MissionBuilding | CraftingHallBuilding | HealerBuilding | MarketBuilding | VaultBuilding | FavourExchangeBuilding | CustomBuilding | HerbFieldBuilding | MineBuilding | RecipeLibraryBuilding | RequestBoardBuilding | CompendiumBuilding | MysticalRegionBuilding | TrainingGroundBuilding | LibraryBuilding | HouseBuilding | CompressionAltarBuilding | ResearchBuilding | ReforgeBuilding | ExpeditionBuilding | GuildBuilding | TenThousandFlamesBuilding | SoulShardDelveBuilding | EnchantmentShopBuilding | ChallengeBoardBuilding | JadeCutterBuilding | RumoursBuilding | ModBuilding;
+export type LocationBuildingState = MissionBuildingState | CraftingHallBuildingState | ShopBuildingState | RequestBoardBuildingState | HouseBuildingState | CompressionAltarBuildingState | RumoursBuildingState;
+export interface Rumour {
+    /** Stable identifier used to track purchase state. */
+    key: string;
+    /** Revealed title once purchased. */
+    title: Translatable;
+    /** Cost in spirit stones to buy (before realm scaling). */
+    cost: number;
+    /** Realm used to scale the cost via getNumericReward. */
+    costRealm: Realm;
+    /** Revealed body text, the actual hint. */
+    hint: Translatable;
+    /** Optional gate so a rumour only appears once relevant. */
+    condition?: string;
+}
+export interface RumoursBuilding extends BuildingBase {
+    kind: 'rumours';
+    /** Display name for the trader screen header. */
+    traderName: Translatable;
+    rumours: Rumour[];
+}
+export interface RumoursBuildingState {
+    kind: 'rumours';
+    /** Keys of rumours the player has purchased. */
+    purchased: string[];
+}
 interface BuildingBase {
     kind: BuildingType;
     condition?: string;
@@ -164,6 +189,21 @@ export interface CultivationBuilding extends BuildingBase {
 export interface CompressionAltarBuilding extends BuildingBase {
     kind: 'altar';
     buff: Buff;
+    /** Permanent combat / crafting stat increments granted on the Core
+     *  Formation breakthrough once the player has compressed at this altar.
+     *  Granted once regardless of how many times the altar is used. Values use
+     *  the same `Scaling` shape as background `rawStats`, so altars can mix flat
+     *  bonuses (`{ value: 5, stat: undefined, scaling: 'stacks' }`) with
+     *  realm-scaling multipliers (`{ value: 0.1, stat: 'power', scaling: 'stacks' }`
+     *  for +10% of current power). */
+    breakthroughReward?: {
+        combatStats?: Partial<{
+            [key in CombatStatistic]: Scaling;
+        }>;
+        craftingStats?: Partial<{
+            [key in CraftingStatistic]: Scaling;
+        }>;
+    };
 }
 export interface CompressionAltarBuildingState {
     kind: 'altar';
@@ -229,12 +269,19 @@ export interface MarketTokenStock {
     item: ShopItem;
     /** Number of currency-item tokens consumed per stack purchased. */
     tokenCost: number;
+    /**
+     * If set, the listing is sold as a bundle: the player must buy the entire stack
+     * for `tokenCost` (no partial purchases). Defaults to per-unit pricing when omitted.
+     */
+    buyAsStack?: boolean;
 }
 export interface MarketTokenCurrency {
     /** The token item used as currency (e.g. Serpent Token). The market reads stack count from the player's inventory. */
     currencyItem: Item;
-    /** Stock entries. Each refresh restores the listed `item.stacks` count for each entry. */
-    tokenStock: MarketTokenStock[];
+    /** Stock entries, grouped by realm. Items from all realms up to the player's current realm are shown. */
+    tokenStock: {
+        [key in Realm]: MarketTokenStock[];
+    };
 }
 export interface MarketBuilding extends ShopBuilding {
     kind: 'market';

package/dist/location.js

@@ -29,5 +29,6 @@ export const buildingTypeToName = {
     enchantmentShop: 'Enchantment Shop',
     challengeBoard: 'Challenge Board',
     jadeCutter: 'Jade Cutter',
+    rumours: 'Rumour Trader',
     modBuilding: '',
 };

package/dist/mineConfig.d.ts

@@ -1,3 +1,4 @@
+import { AmbienceName, MusicName } from './audio';
 import type { Buff } from './buff';
 import type { EnemyEntity } from './entity';
 import type { FlareItem } from './item';
@@ -56,9 +57,9 @@ export interface MineConfig {
     /** Defeat flavor text after pathing combat. */
     combatDefeatText: string;
     /** Music cue name (resolved against musicMap in AppRouter). */
-    music: string;
+    music: MusicName;
     /** Ambience cue name (resolved against ambienceMap in AppRouter). */
-    ambience: string;
+    ambience: AmbienceName;
 }
 export declare const getMineStratumIndex: (y: number) => number;
 export declare const getMineStratumAt: (config: MineConfig, y: number) => MineStratum | undefined;

package/dist/mod.d.ts

@@ -130,6 +130,14 @@ export interface PlayerSpriteImages {
     support: string;
     /** Image shown when using utility stance techniques */
     utility: string;
+    /** Image shown during crafting support technique */
+    craftingSupport?: string;
+    /** Image shown during crafting stabilize technique */
+    craftingStabilize?: string;
+    /** Image shown during crafting refine technique */
+    craftingRefine?: string;
+    /** Image shown during crafting fusion technique */
+    craftingFusion?: string;
 }
 /**
  * A custom player sprite that can be selected during character creation.
@@ -240,6 +248,14 @@ export interface ModReduxAPI {
          * setModData('myMod', 'customNPC_affinity', { npcId: 'elder_li', value: 75 });
          */
         setModData: (modName: string, key: string, data: unknown) => void;
+        /**
+         * Remove a key from mod-specific data stored in save file.
+         * @param modName - Name of your mod (for namespacing)
+         * @param key - Data key identifier to remove
+         * @example
+         * removeModData('myMod', 'customNPC_affinity');
+         */
+        removeModData: (modName: string, key: string) => void;
         /**
          * Move player to a different location on the world map.
          * @param location - Location key from the locations data
@@ -399,6 +415,26 @@ export interface ModReduxAPI {
 export type ModScreenFC = React.FC<{
     screenAPI: ModReduxAPI;
 }>;
+/**
+ * Represents save file metadata shown on the Load page.
+ */
+export interface Save {
+    dbName: string;
+    playerName: string;
+    forename?: string;
+    surname?: string;
+    icon: string;
+    realm: string;
+    realmProgress: string;
+    age: number;
+    createdAt: number;
+    lastPlayed?: number;
+    playtime: number;
+    version: string;
+    mods: string[];
+    location?: string;
+    screen?: string;
+}
 /**
  * A React component that renders a mod's settings/options UI.
  * Receives a Redux API for accessing game state and dispatching actions.
@@ -2294,13 +2330,6 @@ export interface ModAPI {
          * @returns Total exploration amount per action
          */
         getExplorationAmount: (player: PlayerEntity) => number;
-        /**
-         * Get the number of qi droplets produced per condensation action.
-         * @param player - The player entity
-         * @param breakthrough - The current breakthrough state
-         * @returns Number of droplets produced (0 if no vessel equipped)
-         */
-        getDropletProduction: (player: PlayerEntity, breakthrough: BreakthroughState) => number;
         /**
          * Calculate the effective toxicity of a pill before rounding.
          * Applies toxicity resistance and realm-based scaling penalty.
@@ -2481,8 +2510,6 @@ export interface ModAPI {
          */
         getCondensationCost: (player: PlayerEntity, breakthrough: BreakthroughState) => {
             qi: number;
-            money: number;
-            hp: number;
         };
         /**
          * Check whether the player can currently perform a condensation action.
@@ -2916,6 +2943,16 @@ export interface ModAPI {
          * }));
          */
         onGameLoad: (interceptor: (state: RootState) => RootState) => () => void;
+        /**
+         * Called when a character save is deleted from the Load page.
+         * Use this to clean up per-character mod configuration.
+         * @param interceptor - Receives the save info being deleted
+         * @example
+         * modAPI.hooks.onDeleteCharacter((saveInfo) => {
+         *   myModConfig.deleteCharacterConfig(saveInfo.dbName);
+         * });
+         */
+        onDeleteCharacter: (interceptor: (saveInfo: Save) => void) => () => void;
         /**
          * Hook fired before combat advances a step
          * Return a modified context to change combat state, a cancel object (with log message) to skip the step, or `null` to continue as normal.

package/dist/quest.d.ts

@@ -45,7 +45,7 @@ interface GuildApprovalQuestReward {
     amount: number;
     guild: string;
 }
-export type QuestStep = EventQuestStep | ConditionQuestStep | CollectQuestStep | MissionHallQuestStep | FlagValueQuestStep | SpeakToCharacterQuestStep | KillQuestStep | WaitQuestStep | RaidQuestStep;
+export type QuestStep = EventQuestStep | ExplorationEventQuestStep | ConditionQuestStep | CollectQuestStep | MissionHallQuestStep | FlagValueQuestStep | SpeakToCharacterQuestStep | KillQuestStep | WaitQuestStep | RaidQuestStep;
 interface QuestStepBase {
     hint: Translatable;
 }
@@ -54,6 +54,13 @@ interface EventQuestStep extends QuestStepBase {
     event: GameEvent;
     completionCondition?: string;
 }
+export interface ExplorationEventQuestStep extends QuestStepBase {
+    kind: 'explorationEvent';
+    event: GameEvent;
+    locations: string[];
+    completionCondition?: string;
+    triggerChance?: number;
+}
 interface ConditionQuestStep extends QuestStepBase {
     kind: 'condition';
     completionCondition: string;

package/dist/reduxState.d.ts

@@ -21,7 +21,8 @@ import type { EventStep, GameEvent, ReportAnalyticsStep, StatusStep, TournamentS
 import type { Background } from './background';
 import type { Realm } from './realm';
 import type { CraftingBuff } from './craftingBuff';
-import { ExpeditionTeam } from './expedition';
+import { ExpeditionTeam, TeamPoints } from './expedition';
+import { FormationPuzzleCell, FormationWinCondition } from './formation';
 export interface Viewport {
     x: number;
     y: number;
@@ -34,6 +35,8 @@ export interface PlayerState {
     }[];
     numStancesSeen: number;
     learnedNpcManuals?: ManualItem[];
+    /** Formation node ids the player has learned and can use in crafting mode. */
+    learnedFormationGlyphs?: string[];
 }
 export interface InventoryItemState {
     name: string;
@@ -91,10 +94,13 @@ export interface CombatState {
         buildId: string | null;
         prevWins: number;
     };
-    /** Marker for an inner-world fight (Life Flourishing). VictoryDialog reads it to dispatch the right follow-up. */
+    /**
+     * Marker for an inner-world fight (Life Flourishing). VictoryDialog reads
+     * it to dispatch the post-incursion reward picker on victory.
+     */
     lifeFlourishingCombat?: {
-        kind: 'expand' | 'incursion';
-        incursionId?: string;
+        kind: 'incursion';
+        incursionId: string;
     };
 }
 export type CraftingSliceState = ExistingCraftingState;
@@ -297,6 +303,8 @@ export interface ExpeditionState {
     };
     explored: string[];
     instability: number;
+    pointPool: number;
+    teamPoints?: TeamPoints;
 }
 export interface TournamentSliceState {
     sourceStep?: TournamentStep;
@@ -458,6 +466,12 @@ export interface GameEventState {
     useLocationbg?: boolean;
     teamUpOverride?: Buff;
     craftingTeamUpOverride?: CraftingBuff;
+    /**
+     * Empathy companion crafting buff generated by handleCrafting when the
+     * manifestation rolls in, mirrored after craftingTeamUpOverride. Picked up
+     * by the crafting confirmation UI at session start.
+     */
+    empathyCraftingOverride?: CraftingBuff;
     musicOverride?: MusicName;
     flags: Record<string, number>;
     sourceQuest?: {
@@ -539,5 +553,40 @@ export interface RootState {
     fallenStar: FallenStarState;
     characterUiPreferences: CharacterUiPreferencesState;
     soulShardDelve: SoulShardDelveState;
+    formationPuzzle: FormationPuzzleState;
+}
+export interface FormationPuzzlePlacementState {
+    nodeId: string;
+    x: number;
+    y: number;
+    rotation: number;
+    locked?: boolean;
+    /** Pool entry index this placement was drawn from (undefined for prePlaced). */
+    poolIndex?: number;
+}
+export interface FormationPuzzleActiveState {
+    flagPrefix: string;
+    displayName?: string;
+    cells: FormationPuzzleCell[];
+    pool: {
+        nodes: {
+            nodeId: string;
+            count: number;
+        }[];
+        glyphs: {
+            nodeId: string;
+            count: number;
+        }[];
+    };
+    winCondition: FormationWinCondition[];
+}
+export interface FormationPuzzleState {
+    /** Active inline puzzle definition (from the FormationPuzzleStep), or
+     *  undefined when no puzzle is in progress. */
+    active?: FormationPuzzleActiveState;
+    /** All node placements on the grid (locked + player). */
+    placements: FormationPuzzlePlacementState[];
+    /** Snapshot of event state when the puzzle started; restored on completion. */
+    eventStateSnapshot?: GameEventState;
 }
 export {};

package/dist/soulShardDelve.d.ts

@@ -131,11 +131,14 @@ export interface SoulShardDelveConfig {
     location: string;
     /** Events played when each threshold is crossed, in order. Length determines total threshold count. */
     thresholdEvents: GameEvent[];
-    /** One-time item rewards granted when accumulatedQither reaches each intensity level. */
-    intensityRewards: {
+    /** One-time rewards granted when accumulatedQither reaches each intensity level. */
+    intensityRewards: ({
         intensity: number;
         reward: ItemDesc;
-    }[];
+    } | {
+        intensity: number;
+        minorAspectId: string;
+    })[];
     /** Source power regeneration rate: 1 qither per this many months. Default 6. */
     rechargeMonths: number;
     monsters: RegionMonsters;

package/dist/stat.d.ts

@@ -3,7 +3,7 @@ import type { 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", "poolCostFlat"];
-export declare const combatStatistics: readonly ["maxhp", "hp", "maxbarrier", "barrier", "maxtoxicity", "toxicity", "resistance", "pillsPerRound", "itemEffectiveness", "power", "artefactpower", "critchance", "defense", "protection", "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", "noneDisabled", "pillsDisabled", "dropletsDisabled", "fistResistance", "blossomResistance", "weaponResistance", "cloudResistance", "bloodResistance", "celestialResistance", "damageBoost", "healingBoost", "barrierBoost", "temphpBoost", "overheal", "barrierBleed", "formationPartRecovery", "overcrit", "cultivatorResistance", "temphp"];
+export declare const combatStatistics: readonly ["maxhp", "hp", "maxbarrier", "barrier", "maxtoxicity", "toxicity", "resistance", "pillsPerRound", "itemEffectiveness", "power", "artefactpower", "critchance", "defense", "protection", "dr", "barrierMitigation", "lifesteal", "critmultiplier", "vulnerability", "weakness", "fistBoost", "blossomBoost", "weaponBoost", "cloudBoost", "bloodBoost", "celestialBoost", "fistAffinity", "blossomAffinity", "weaponAffinity", "cloudAffinity", "bloodAffinity", "celestialAffinity", "noneAffinity", "qiDroplets", "excessDropletsCost", "dropletBoost", "openerBoost", "finisherBoost", "fistDisabled", "bloodDisabled", "blossomDisabled", "cloudDisabled", "celestialDisabled", "weaponDisabled", "noneDisabled", "pillsDisabled", "dropletsDisabled", "fistResistance", "blossomResistance", "weaponResistance", "cloudResistance", "bloodResistance", "celestialResistance", "damageBoost", "healingBoost", "barrierBoost", "temphpBoost", "overheal", "barrierBleed", "formationPartRecovery", "overcrit", "cultivatorResistance", "temphp"];
 export type PhysicalStatistic = (typeof physicalStatistics)[number];
 export type SocialStatistic = (typeof socialStatistics)[number];
 export type CraftingStatistic = (typeof craftingStatistics)[number];
@@ -32,8 +32,11 @@ export declare const combatStatToName: {
 export declare const combatStatToDescription: {
     [key in CombatStatistic]: string;
 };
-export declare const percentageCombatStats: Set<"pillsPerRound" | "maxtoxicity" | "toxicity" | "resistance" | "itemEffectiveness" | "critchance" | "critmultiplier" | "maxhp" | "hp" | "maxbarrier" | "barrier" | "power" | "artefactpower" | "defense" | "protection" | "dr" | "barrierMitigation" | "lifesteal" | "vulnerability" | "weakness" | "fistBoost" | "blossomBoost" | "weaponBoost" | "cloudBoost" | "bloodBoost" | "celestialBoost" | "fistAffinity" | "blossomAffinity" | "weaponAffinity" | "cloudAffinity" | "bloodAffinity" | "celestialAffinity" | "noneAffinity" | "qiDroplets" | "fistDisabled" | "bloodDisabled" | "blossomDisabled" | "cloudDisabled" | "celestialDisabled" | "weaponDisabled" | "noneDisabled" | "pillsDisabled" | "dropletsDisabled" | "fistResistance" | "blossomResistance" | "weaponResistance" | "cloudResistance" | "bloodResistance" | "celestialResistance" | "damageBoost" | "healingBoost" | "barrierBoost" | "temphpBoost" | "overheal" | "barrierBleed" | "formationPartRecovery" | "overcrit" | "cultivatorResistance" | "temphp">;
-export declare const multiplicativePercentStats: Set<"pillsPerRound" | "maxtoxicity" | "toxicity" | "resistance" | "itemEffectiveness" | "critchance" | "critmultiplier" | "maxhp" | "hp" | "maxbarrier" | "barrier" | "power" | "artefactpower" | "defense" | "protection" | "dr" | "barrierMitigation" | "lifesteal" | "vulnerability" | "weakness" | "fistBoost" | "blossomBoost" | "weaponBoost" | "cloudBoost" | "bloodBoost" | "celestialBoost" | "fistAffinity" | "blossomAffinity" | "weaponAffinity" | "cloudAffinity" | "bloodAffinity" | "celestialAffinity" | "noneAffinity" | "qiDroplets" | "fistDisabled" | "bloodDisabled" | "blossomDisabled" | "cloudDisabled" | "celestialDisabled" | "weaponDisabled" | "noneDisabled" | "pillsDisabled" | "dropletsDisabled" | "fistResistance" | "blossomResistance" | "weaponResistance" | "cloudResistance" | "bloodResistance" | "celestialResistance" | "damageBoost" | "healingBoost" | "barrierBoost" | "temphpBoost" | "overheal" | "barrierBleed" | "formationPartRecovery" | "overcrit" | "cultivatorResistance" | "temphp">;
+export declare const percentageCombatStats: Set<"pillsPerRound" | "maxtoxicity" | "toxicity" | "resistance" | "itemEffectiveness" | "critchance" | "critmultiplier" | "maxhp" | "hp" | "maxbarrier" | "barrier" | "power" | "artefactpower" | "defense" | "protection" | "dr" | "barrierMitigation" | "lifesteal" | "vulnerability" | "weakness" | "fistBoost" | "blossomBoost" | "weaponBoost" | "cloudBoost" | "bloodBoost" | "celestialBoost" | "fistAffinity" | "blossomAffinity" | "weaponAffinity" | "cloudAffinity" | "bloodAffinity" | "celestialAffinity" | "noneAffinity" | "qiDroplets" | "excessDropletsCost" | "dropletBoost" | "openerBoost" | "finisherBoost" | "fistDisabled" | "bloodDisabled" | "blossomDisabled" | "cloudDisabled" | "celestialDisabled" | "weaponDisabled" | "noneDisabled" | "pillsDisabled" | "dropletsDisabled" | "fistResistance" | "blossomResistance" | "weaponResistance" | "cloudResistance" | "bloodResistance" | "celestialResistance" | "damageBoost" | "healingBoost" | "barrierBoost" | "temphpBoost" | "overheal" | "barrierBleed" | "formationPartRecovery" | "overcrit" | "cultivatorResistance" | "temphp">;
+export declare const multiplicativePercentStats: Set<"pillsPerRound" | "maxtoxicity" | "toxicity" | "resistance" | "itemEffectiveness" | "critchance" | "critmultiplier" | "maxhp" | "hp" | "maxbarrier" | "barrier" | "power" | "artefactpower" | "defense" | "protection" | "dr" | "barrierMitigation" | "lifesteal" | "vulnerability" | "weakness" | "fistBoost" | "blossomBoost" | "weaponBoost" | "cloudBoost" | "bloodBoost" | "celestialBoost" | "fistAffinity" | "blossomAffinity" | "weaponAffinity" | "cloudAffinity" | "bloodAffinity" | "celestialAffinity" | "noneAffinity" | "qiDroplets" | "excessDropletsCost" | "dropletBoost" | "openerBoost" | "finisherBoost" | "fistDisabled" | "bloodDisabled" | "blossomDisabled" | "cloudDisabled" | "celestialDisabled" | "weaponDisabled" | "noneDisabled" | "pillsDisabled" | "dropletsDisabled" | "fistResistance" | "blossomResistance" | "weaponResistance" | "cloudResistance" | "bloodResistance" | "celestialResistance" | "damageBoost" | "healingBoost" | "barrierBoost" | "temphpBoost" | "overheal" | "barrierBleed" | "formationPartRecovery" | "overcrit" | "cultivatorResistance" | "temphp">;
+export declare const percentageCraftingStats: Set<"pillsPerRound" | "maxpool" | "pool" | "maxtoxicity" | "toxicity" | "resistance" | "itemEffectiveness" | "control" | "intensity" | "critchance" | "critmultiplier" | "poolCostPercentage" | "stabilityCostPercentage" | "successChanceBonus" | "poolCostFlat">;
+export declare const unsignedCraftingStats: Set<"pillsPerRound" | "maxpool" | "pool" | "maxtoxicity" | "toxicity" | "resistance" | "itemEffectiveness" | "control" | "intensity" | "critchance" | "critmultiplier" | "poolCostPercentage" | "stabilityCostPercentage" | "successChanceBonus" | "poolCostFlat">;
+export declare const fractionalCraftingStats: Set<"pillsPerRound" | "maxpool" | "pool" | "maxtoxicity" | "toxicity" | "resistance" | "itemEffectiveness" | "control" | "intensity" | "critchance" | "critmultiplier" | "poolCostPercentage" | "stabilityCostPercentage" | "successChanceBonus" | "poolCostFlat">;
 export declare const uncommonStatTooltips: Partial<{
     [key in CombatStatistic]: string;
 }>;

package/dist/stat.js

@@ -69,6 +69,10 @@ export const combatStatistics = [
     'celestialAffinity',
     'noneAffinity',
     'qiDroplets',
+    'excessDropletsCost',
+    'dropletBoost',
+    'openerBoost',
+    'finisherBoost',
     'fistDisabled',
     'bloodDisabled',
     'blossomDisabled',
@@ -133,6 +137,10 @@ export const combatStatToName = {
     bloodBoost: 'Blood Boost',
     celestialBoost: 'Celestial Boost',
     qiDroplets: 'Qi Droplets',
+    excessDropletsCost: 'Excess Droplet Health Cost',
+    dropletBoost: 'Droplet Boost',
+    openerBoost: 'Opener Boost',
+    finisherBoost: 'Finisher Boost',
     fistAffinity: 'Fist Root',
     blossomAffinity: 'Blossom Root',
     weaponAffinity: 'Weapon Root',
@@ -194,6 +202,10 @@ export const combatStatToDescription = {
     celestialBoost: '',
     barrierMitigation: 'Controls how efficiently your barrier absorbs damage, with diminishing returns. Barrier always blocks damage first before health is lost.',
     qiDroplets: '',
+    excessDropletsCost: '',
+    dropletBoost: '',
+    openerBoost: '',
+    finisherBoost: '',
     fistAffinity: '',
     blossomAffinity: '',
     weaponAffinity: '',
@@ -261,11 +273,34 @@ export const percentageCombatStats = new Set([
     'bloodResistance',
     'celestialResistance',
     'cultivatorResistance',
+    'excessDropletsCost',
+    'dropletBoost',
+    'openerBoost',
+    'finisherBoost',
 ]);
 // Stats whose sources multiply together rather than add.
 // Each source applies as (1 - value/100)^scaleFactor to a running multiplier.
 // The final value is converted back to a percentage: (1 - multiplier) * 100.
 export const multiplicativePercentStats = new Set(['weakness', 'dr']);
+// Crafting stats that are displayed as percentages in tooltips and UI.
+export const percentageCraftingStats = new Set([
+    'critchance',
+    'critmultiplier',
+    'resistance',
+    'itemEffectiveness',
+    'successChanceBonus',
+    'poolCostPercentage',
+    'stabilityCostPercentage',
+]);
+// Crafting percentage stats that are multipliers (100 = baseline) rather than
+// signed bonuses, so they render without a +/- prefix.
+export const unsignedCraftingStats = new Set([
+    'poolCostPercentage',
+    'stabilityCostPercentage',
+]);
+// successChanceBonus is stored as a fraction (0.05 = 5%); other percentage
+// crafting stats store the integer percent directly.
+export const fractionalCraftingStats = new Set(['successChanceBonus']);
 // 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 = {
@@ -281,6 +316,10 @@ export const uncommonStatTooltips = {
     formationPartRecovery: 'Each point of <n>Formation Part Recovery</n> returns a <n>Formation Part</n> used in combat back to your Spatial Ring after battle.',
     overcrit: '<n>Overcrit</n> allows critical hits to chain up to <n>9</n> additional times. Your crit chance is multiplied by your overcrit percentage after each chain. Overcrit has a maximum of <n>90%</n>.',
     dr: '<n>Damage Resistance</n> reduces damage taken to your health. Multiple sources multiply together. Does not affect damage taken to your barrier.',
+    excessDropletsCost: '<n>Excess Droplet Health Cost</n> lets droplet techniques be used even when you lack enough <n>Qi Droplets</n>. Each missing droplet instead costs this percentage of your <n>Max Health</n>, dealt as <name>True Damage</name>.',
+    dropletBoost: '<n>Droplet Boost</n> increases the power of techniques that cost <n>Qi Droplets</n>.',
+    openerBoost: '<n>Opener Boost</n> increases the power of <n>Opener</n> techniques.',
+    finisherBoost: '<n>Finisher Boost</n> increases the power of <n>Finisher</n> techniques.',
 };
 export const craftingStatToName = {
     maxpool: 'Max Qi Pool',

package/dist/worldAspect.d.ts

@@ -20,4 +20,11 @@ export interface WorldAspect {
     /** GameLocation name. The location's `image` is the World tab background and its `icon` is the aspect picker icon. */
     location: string;
     essenceGeneration: WorldAspectEssence[];
+    /**
+     * Marks this aspect as a minor aspect. Minor aspects are only available
+     * through the manual expansion unlock; they cannot be chosen as the main
+     * world aspect. They can be placed into minor aspect slots alongside major
+     * aspects to generate their essences at full per-month rate.
+     */
+    minor?: boolean;
 }

package/package.json

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