afnm-types 0.6.57 → 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' | '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' | '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;
@@ -23,12 +31,177 @@ export interface StoredFigment {
     stances: StoredStance[];
     currentStyle?: StoredStyle;
     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 {
+    essenceItemName: string;
+    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[];
     storedFigments: StoredFigment[];
-    manifestedFigmentId?: string;
+    evokedFigmentId?: string;
+    worldAspectId?: string;
+    firmamentProgress?: number;
+    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?: {
@@ -48,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[];
@@ -82,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;
@@ -141,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/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

@@ -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;
+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';
@@ -174,6 +176,7 @@ export interface CreateBuffStep extends BaseEventStep {
     buff: Buff;
     amount: string;
     persistBeyondEvent?: boolean;
+    debuff?: boolean;
 }
 export interface ConsumeBuffStep extends BaseEventStep {
     kind: 'consumeBuff';
@@ -469,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;
@@ -513,4 +549,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/event.js

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