koishi-plugin-warframe 1.15.0 → 1.16.0

package/lib/index.d.ts

@@ -34,7 +34,7 @@ declare module "warframe/types/ocr" {
     }
 }
 declare module "warframe/types/warframe-result" {
-    export const warframeErrorCodes: readonly ["common.fetchFailed", "relic.invalidName", "relic.dataLoading", "relic.notFound", "arbitration.invalidDayRange", "bounty.unavailable", "invasion.unavailable", "alert.unavailable", "event.unavailable", "calendar.unavailable", "steelEssence.unavailable", "nightwave.unavailable", "sortie.unavailable", "voidTrader.drifting", "voidTrader.arriving", "riven.imageFetchFailed", "riven.imageParseFailed", "riven.weaponNotFound", "riven.dispositionError", "riven.weaponTypeError", "riven.statTypeError", "wfm.inputItemName", "wfm.itemNotFound", "wfm.itemAmbiguous", "wfm.orderFetchFailed", "wfm.noOnlineSeller", "wfm.rivenWeaponNotFound", "wfm.rivenOrderFetchFailed", "wfm.noOnlineRivenSeller", "miscs.hotRiven.noData", "miscs.hotRiven.fetchFailed"];
+    export const warframeErrorCodes: readonly ["common.fetchFailed", "relic.invalidName", "relic.dataLoading", "relic.notFound", "arbitration.invalidDayRange", "bounty.unavailable", "invasion.unavailable", "alert.unavailable", "event.unavailable", "calendar.unavailable", "steelEssence.unavailable", "nightwave.unavailable", "sortie.unavailable", "voidTrader.drifting", "voidTrader.arriving", "riven.imageFetchFailed", "riven.imageParseFailed", "riven.weaponNotFound", "riven.dispositionError", "riven.weaponTypeError", "riven.statTypeError", "riven.unverifiedStat", "riven.variantRequired", "riven.variantError", "wfm.inputItemName", "wfm.itemNotFound", "wfm.itemAmbiguous", "wfm.orderFetchFailed", "wfm.noOnlineSeller", "wfm.rivenWeaponNotFound", "wfm.rivenOrderFetchFailed", "wfm.noOnlineRivenSeller", "miscs.hotRiven.noData", "miscs.hotRiven.fetchFailed"];
     export type WarframeErrorCode = typeof warframeErrorCodes[number];
     export type WarframeErrorParams = Record<string, string | number>;
     export interface WarframeError {
@@ -472,10 +472,59 @@ declare module "warframe/types/wfm" {
         };
     };
 }
+declare module "warframe/types/wf/riven-export" {
+    export interface RivenExportEntry {
+        tag: string;
+        prefixTag?: string;
+        suffixTag?: string;
+        upgradeValues: {
+            value: number;
+            locTag?: string;
+            reverseValueSymbol?: boolean;
+        }[];
+    }
+    export interface RivenExportDefinition {
+        uniqueName: string;
+        upgradeEntries: RivenExportEntry[];
+    }
+    export interface RivenExportWeapon {
+        uniqueName: string;
+        name: string;
+        productCategory: string;
+        omegaAttenuation: number;
+        primeOmegaAttenuation?: number;
+        slot?: number;
+    }
+    export interface RivenPublicExport {
+        schemaVersion: number;
+        downloadedAt: string;
+        sources: Record<string, {
+            url: string;
+            sha256: string;
+            bytes: number;
+        }>;
+        upgrades: RivenExportDefinition[];
+        upgradesZh: RivenExportDefinition[];
+        weapons: RivenExportWeapon[];
+        weaponNamesZh: Record<string, string>;
+    }
+}
 declare module "warframe/types/wf/riven" {
-    import type { IWeapon } from 'warframe-public-export-plus';
     import type { RivenAttributeUnit } from "warframe/types/wfm";
-    export type RivenWeaponType = 'Rifle' | 'Shotgun' | 'Pistol' | 'Archgun' | 'Melee';
+    import type { RivenExportWeapon } from "warframe/types/wf/riven-export";
+    export type RivenWeaponType = 'Rifle' | 'Shotgun' | 'Pistol' | 'Archgun' | 'Melee' | 'Kitgun' | 'Zaw';
+    export interface RivenCalculationAttribute {
+        gameRef?: string;
+        unit?: RivenAttributeUnit;
+        i18n?: {
+            'en'?: {
+                name?: string;
+            };
+            'zh-hans'?: {
+                name?: string;
+            };
+        };
+    }
     export type RivenStatCountType = '31' | '2' | '21' | '3';
     export interface RivenStatFixFactor {
         buffFactor: number;
@@ -493,6 +542,7 @@ declare module "warframe/types/wf/riven" {
         min: number;
     }
     export interface RivenStatAnalyzeResult {
+        notes?: string[];
         name: string;
         disposition: number;
         buffs: RivenStatAnalyzsis[];
@@ -509,9 +559,10 @@ declare module "warframe/types/wf/riven" {
             texture: string;
             riventype: string;
         };
-        weapon: IWeapon;
+        weapon: RivenExportWeapon;
     }
     export interface RivenStatResult {
+        notes?: string[];
         positive: Record<string, {
             name: string;
             max: number;
@@ -716,7 +767,7 @@ declare module "warframe/services/miscs-service" {
     export function getHotRivenWeapons(): Promise<WarframeResult<RivenWeaponItem[]>>;
 }
 declare module "warframe/assets/index" {
-    import type { RivenWeaponDisposition } from "warframe/types/index";
+    import type { RivenPublicExport } from "warframe/types/wf/riven-export";
     export interface BaroParsedItem {
         name: string;
         last: string;
@@ -724,10 +775,7 @@ declare module "warframe/assets/index" {
     }
     export type ArbyRewards = Record<string, number>;
     export const incarnons: string[][], warframes: string[][];
-    export const rivenAttrValues: Record<string, Record<string, number>>;
-    export const rivenCalc: {
-        weapons: RivenWeaponDisposition["calc"][];
-    };
+    export const rivenPublicExport: RivenPublicExport;
     export const dictEnExtra: Record<string, string>;
     export const dictZhExtra: Record<string, string>;
     export const arbitrationScheduleText: string;
@@ -736,17 +784,6 @@ declare module "warframe/assets/index" {
     export const BaroParsed: BaroParsedItem[];
     export const warframeAlias: Record<string, string[]>;
 }
-declare module "warframe/data/wf/arbitrationSchedule" {
-    import type { ArbitrationShort } from "warframe/types/index";
-    export const arbitrationSchedule: ArbitrationShort[];
-}
-declare module "warframe/data/wf/archonHunt" {
-    export function getArchonHuntModeName(): string;
-    export function getArchonHuntEnemyLevels(index: number): {
-        minLevel: number;
-        maxLevel: number;
-    };
-}
 declare module "warframe/infrastructure/wf/wf-api" {
     import type WorldState from 'warframe-worldstate-parser';
     import type { OracleBountyCycle, RawCalendarSeason, RawInvasion, RawSeasonInfo, RawSortie, RawSyndicateMission, RawWorldEvent } from "warframe/types/index";
@@ -776,11 +813,6 @@ declare module "warframe/infrastructure/wf/wf-api" {
         [itemName: string]: VoidTraderItem;
     }
 }
-declare module "warframe/data/wf/globalOracleBountyCycle" {
-    import type { AsyncCache, OracleBountyCycle } from "warframe/types/index";
-    export let globalOracleBountyCycle: AsyncCache<OracleBountyCycle | undefined>;
-    export function overrideGlobalOracleBountyCycle(cache: AsyncCache<OracleBountyCycle | undefined>): void;
-}
 declare module "warframe/infrastructure/wf/wf-export-adapter" {
     import type { IRegion } from 'warframe-public-export-plus';
     import type { RelicQuality, WFRegionShort } from "warframe/types/index";
@@ -842,44 +874,187 @@ declare module "warframe/infrastructure/wf/wfcd-adapter" {
 }
 declare module "warframe/data/wf/globalWorldState" {
     import type WorldState from 'warframe-worldstate-parser';
-    import type { Fissure, RawCalendarSeason, RawSeasonInfo, RawSyndicateMission, RawWorldEvent } from "warframe/types/index";
+    import type { AsyncCache, Fissure, RawCalendarSeason, RawInvasion, RawSeasonInfo, RawSortie, RawSyndicateMission, RawWorldEvent } from "warframe/types/index";
     type ParsedFissure = WorldState['fissures'][number];
-    export function adaptFissure(fissure: ParsedFissure): Promise<Fissure>;
-    export const globalWorldState: import("warframe").AsyncCache<{
+    export interface GlobalWorldStateData {
         raw: WorldState;
         syndicateMissionsRaw: RawSyndicateMission[];
         seasonInfoRaw: RawSeasonInfo | undefined;
-        sortieRaw: import("warframe").RawSortie | undefined;
-        invasionsRaw: import("warframe").RawInvasion[];
+        sortieRaw: RawSortie | undefined;
+        invasionsRaw: RawInvasion[];
         calendarRaw: RawCalendarSeason | undefined;
         eventsRaw: RawWorldEvent[];
         fissures: Fissure[];
         spFissures: Fissure[];
         rjFissures: Fissure[];
-    }>;
+    }
+    export function adaptFissure(fissure: ParsedFissure): Promise<Fissure>;
+    export function globalWorldStateFactory(json?: string): Promise<GlobalWorldStateData>;
+    export let globalWorldState: AsyncCache<GlobalWorldStateData>;
+    export function overrideGlobalWorldState(cache: AsyncCache<GlobalWorldStateData>): void;
+}
+declare module "warframe/infrastructure/wf/bounty-adapter" {
+    import type { BountyBoard, BountyLocation, BountyRewardRarity, OracleBountyCycle, RawSyndicateMission } from "warframe/types/index";
+    export const bountyLocationTag: Record<BountyLocation, string>;
+    /** Locations whose Jobs are empty in official WorldState; use browse.wf Oracle. */
+    export const oracleBountyLocations: Set<BountyLocation>;
+    /**
+     * Map drop probability to 铜/银/金 within one stage.
+     * Highest unique probability → bronze, lowest → gold, middle → silver.
+     * With only two buckets: highest → bronze, lower → silver.
+     */
+    export function rarityFromStageProbabilities(probability: number, uniqueSortedDesc: number[]): BountyRewardRarity;
+    export function resolveExportItemNameZh(sourceKey: string): string;
+    export function adaptBountyBoard(location: BountyLocation, mission: RawSyndicateMission | undefined): BountyBoard | undefined;
+    export function findRawSyndicateMission(missions: RawSyndicateMission[], location: BountyLocation): RawSyndicateMission | undefined;
+    export function formatOracleChallenge(challengePath: string): string;
+    export function adaptOracleBountyBoard(location: 'zariman' | 'cavia' | 'hex', cycle: OracleBountyCycle | undefined): BountyBoard | undefined;
+}
+declare module "warframe/services/wf-service/wf-service.alert" {
+    import type { AlertBoard, WarframeResult } from "warframe/types/index";
+    export function adaptAlerts(alerts?: readonly {
+        expiry?: Date;
+        mission?: {
+            nodeKey?: string;
+            typeKey?: string;
+            minEnemyLevel?: number;
+            maxEnemyLevel?: number;
+            nightmare?: boolean;
+            reward?: {
+                items?: string[];
+                countedItems?: Array<{
+                    type?: string;
+                    key?: string;
+                    count?: number;
+                }>;
+                credits?: number;
+            };
+        };
+    }[], now?: number): Promise<AlertBoard>;
+    export function getAlerts(): Promise<WarframeResult<AlertBoard>>;
+}
+declare module "warframe/data/wf/arbitrationSchedule" {
+    import type { ArbitrationShort } from "warframe/types/index";
+    export const arbitrationSchedule: ArbitrationShort[];
+}
+declare module "warframe/services/wf-service/wf-service.arbitration" {
+    import type { Arbitration, WarframeResult } from "warframe/types/index";
+    export function getArbitrations(day?: number): WarframeResult<Arbitration[]>;
+}
+declare module "warframe/data/wf/globalOracleBountyCycle" {
+    import type { AsyncCache, OracleBountyCycle } from "warframe/types/index";
+    export let globalOracleBountyCycle: AsyncCache<OracleBountyCycle | undefined>;
+    export function overrideGlobalOracleBountyCycle(cache: AsyncCache<OracleBountyCycle | undefined>): void;
+}
+declare module "warframe/services/wf-service/wf-service.bounty" {
+    import type { BountyBoard, BountyLocation, WarframeResult } from "warframe/types/index";
+    export function getBounty(location: BountyLocation): Promise<WarframeResult<BountyBoard>>;
+}
+declare module "warframe/infrastructure/wf/calendar-adapter" {
+    import type { CalendarBoard, RawCalendarSeason, RawMongoDate } from "warframe/types/index";
+    export function calendarTimestampMs(value?: RawMongoDate): number;
+    /** Strip Lotus color pipes and HTML-like markup tags. */
+    export function stripLotusMarkup(text: string): string;
+    export function adaptCalendar(raw: RawCalendarSeason | undefined, now?: number): CalendarBoard;
+}
+declare module "warframe/services/wf-service/wf-service.calendar" {
+    import type { CalendarBoard, RawCalendarSeason, WarframeResult } from "warframe/types/index";
+    export function adaptCalendar(raw: RawCalendarSeason | undefined, now?: number): CalendarBoard;
+    export function getCalendarFrom(snapshot?: {
+        raw?: unknown;
+        calendarRaw?: RawCalendarSeason;
+    }, now?: number): Promise<WarframeResult<CalendarBoard>>;
+    export function getCalendar(): Promise<WarframeResult<CalendarBoard>>;
+}
+declare module "warframe/services/wf-service/wf-service.circuit" {
+    export function getCircuitWeek(): {
+        currentIncarnons: number;
+        currentWarframes: number;
+        allIncarnons: string[][];
+        allWarframes: string[][];
+    };
+}
+declare module "warframe/services/wf-service/wf-service.environment" {
+    export function getEnvironment(): Promise<string>;
+}
+declare module "warframe/services/wf-service/wf-service.event" {
+    import type { EventBoard, RawWorldEvent, WarframeResult } from "warframe/types/index";
+    export function adaptEvents(rawEvents?: readonly RawWorldEvent[], now?: number): EventBoard;
+    export function getEventsFrom(snapshot?: {
+        raw?: unknown;
+        eventsRaw?: RawWorldEvent[];
+    }, now?: number): Promise<WarframeResult<EventBoard>>;
+    export function getEvents(): Promise<WarframeResult<EventBoard>>;
+}
+declare module "warframe/services/wf-service/wf-service.fissure" {
+    import type { Fissure, WarframeResult } from "warframe/types/index";
+    export function getFissures(): Promise<WarframeResult<Fissure[]>>;
+    export function getSteelPathFissures(): Promise<WarframeResult<Fissure[]>>;
+    export function getRailjackFissures(): Promise<WarframeResult<Fissure[]>>;
+}
+declare module "warframe/services/wf-service/wf-service.invasion" {
+    import type { InvasionBoard, RawInvasion, WarframeResult } from "warframe/types/index";
+    export function adaptInvasions(rawInvasions: RawInvasion[]): Promise<InvasionBoard>;
+    export function getInvasionsFrom(snapshot?: {
+        raw?: unknown;
+        invasionsRaw?: RawInvasion[];
+    }): Promise<WarframeResult<InvasionBoard>>;
+    export function getInvasions(): Promise<WarframeResult<InvasionBoard>>;
+}
+declare module "warframe/infrastructure/wf/nightwave-adapter" {
+    import type { NightwaveBoard, RawSeasonInfo } from "warframe/types/index";
+    export function adaptNightwave(raw: RawSeasonInfo, now?: number): NightwaveBoard;
+}
+declare module "warframe/services/wf-service/wf-service.nightwave" {
+    import type { NightwaveBoard, RawSeasonInfo, WarframeResult } from "warframe/types/index";
+    export function resolveNightwave(raw: RawSeasonInfo | undefined, now?: number): WarframeResult<NightwaveBoard>;
+    export function getNightwave(): Promise<WarframeResult<NightwaveBoard>>;
 }
 declare module "warframe/data/wf/relics" {
     import type { Relic } from "warframe/types/index";
     export const relics: Record<string, Relic>;
 }
+declare module "warframe/services/wf-service/wf-service.relic" {
+    import type { Relic, WarframeResult } from "warframe/types/index";
+    export function getRelic(input: string): Promise<WarframeResult<Relic>>;
+}
+declare module "warframe/infrastructure/wf/riven-export-adapter" {
+    import type { RivenCalculationAttribute, RivenWeaponType } from "warframe/types/wf/riven";
+    import type { RivenExportDefinition } from "warframe/types/wf/riven-export";
+    import type { RivenAttributeUnit } from "warframe/types/wfm";
+    export const rivenDefinitionTypes: Record<string, RivenWeaponType>;
+    export interface RivenCalculationStat extends RivenCalculationAttribute {
+        gameRef: string;
+        key: string;
+        name: string;
+        englishName: string;
+        baseValue: number;
+        unit: RivenAttributeUnit;
+        spliced: boolean;
+        canBeBuff: boolean;
+        canBeCurse: boolean;
+        verified: boolean;
+        aliases: string[];
+    }
+    export function cleanRivenTemplate(template: string): string | undefined;
+    export function adaptRivenDefinitions(definitions: RivenExportDefinition[]): Record<string, RivenCalculationStat[]>;
+}
 declare module "warframe/data/wf/rivenBaseValues" {
-    export const rivenAttrValueDict: Record<string, Record<string, number>>;
+    export type RivenAttrValueDict = Record<string, Record<string, number>>;
+    export const rivenStatsByType: Record<string, import("warframe/infrastructure/wf/riven-export-adapter").RivenCalculationStat[]>;
+    export const rivenAttributes: import("warframe/infrastructure/wf/riven-export-adapter").RivenCalculationStat[];
+    export const rivenAttrValueDict: RivenAttrValueDict;
 }
 declare module "warframe/data/wf/rivenDisposition" {
     import type { RivenWeaponDisposition } from "warframe/types/index";
+    import type { RivenExportWeapon } from "warframe/types/wf/riven-export";
+    export function buildWeaponRivenDispositionDict(weapons: RivenExportWeapon[], namesZh: Record<string, string>, types: Record<string, string>): Record<string, RivenWeaponDisposition>;
     export const weaponRivenDispositionDict: Record<string, RivenWeaponDisposition>;
 }
 declare module "warframe/data/wf/rivenStatData" {
     import type { RivenStatFixFactorMap } from "warframe/types/index";
     export const rivenStatFixFactor: RivenStatFixFactorMap;
 }
-declare module "warframe/data/wf/sortie" {
-    export function getSortieModeName(): string;
-    export function getSortieEnemyLevels(index: number): {
-        minLevel: number;
-        maxLevel: number;
-    };
-}
 declare module "warframe/infrastructure/wfm-client" {
     import type { WfmApiClient, WfmFetcher, WfmPlugin } from 'wfm-api-client';
     /** Warframe-local: map request failures to `undefined` (not part of upstream client). */
@@ -969,23 +1144,6 @@ declare module "warframe/infrastructure/wfm-client" {
         setAccessToken: (token: string | undefined) => void;
     };
 }
-declare module "warframe/data/wfm/globalRivenAttribute" {
-    import type { AsyncCache, RivenAttribute } from "warframe/types/index";
-    export function globalRivenAttributeFactory(rivenAttributeData?: RivenAttribute[]): Promise<{
-        globalRivenAttributeList: RivenAttribute[];
-        globalRivenAttributeDict: Record<string, RivenAttribute>;
-    }>;
-    export let globalRivenAttribute: AsyncCache<{
-        globalRivenAttributeList: RivenAttribute[];
-        globalRivenAttributeDict: Record<string, RivenAttribute>;
-    }>;
-    export function overrideGlobalRivenAttribute(cache: AsyncCache<{
-        globalRivenAttributeList: RivenAttribute[];
-        globalRivenAttributeDict: {
-            [key: string]: RivenAttribute;
-        };
-    }>): void;
-}
 declare module "warframe/data/wfm/globalRivenItem" {
     import type { AsyncCache, RivenItem } from "warframe/types/index";
     export interface GlobalRivenItemWordPrefixCandidate {
@@ -1016,58 +1174,42 @@ declare module "warframe/infrastructure/ocr-api" {
     import type { OcrAPISecret } from "warframe/types/index";
     export function extractTextFromImage(image: string | Blob, secret: OcrAPISecret): Promise<string[] | undefined>;
 }
-declare module "warframe/infrastructure/wf/bounty-adapter" {
-    import type { BountyBoard, BountyLocation, BountyRewardRarity, OracleBountyCycle, RawSyndicateMission } from "warframe/types/index";
-    export const bountyLocationTag: Record<BountyLocation, string>;
-    /** Locations whose Jobs are empty in official WorldState; use browse.wf Oracle. */
-    export const oracleBountyLocations: Set<BountyLocation>;
-    /**
-     * Map drop probability to 铜/银/金 within one stage.
-     * Highest unique probability → bronze, lowest → gold, middle → silver.
-     * With only two buckets: highest → bronze, lower → silver.
-     */
-    export function rarityFromStageProbabilities(probability: number, uniqueSortedDesc: number[]): BountyRewardRarity;
-    export function resolveExportItemNameZh(sourceKey: string): string;
-    export function adaptBountyBoard(location: BountyLocation, mission: RawSyndicateMission | undefined): BountyBoard | undefined;
-    export function findRawSyndicateMission(missions: RawSyndicateMission[], location: BountyLocation): RawSyndicateMission | undefined;
-    export function formatOracleChallenge(challengePath: string): string;
-    export function adaptOracleBountyBoard(location: 'zariman' | 'cavia' | 'hex', cycle: OracleBountyCycle | undefined): BountyBoard | undefined;
-}
-declare module "warframe/infrastructure/wf/calendar-adapter" {
-    import type { CalendarBoard, RawCalendarSeason, RawMongoDate } from "warframe/types/index";
-    export function calendarTimestampMs(value?: RawMongoDate): number;
-    /** Strip Lotus color pipes and HTML-like markup tags. */
-    export function stripLotusMarkup(text: string): string;
-    export function adaptCalendar(raw: RawCalendarSeason | undefined, now?: number): CalendarBoard;
-}
-declare module "warframe/infrastructure/wf/nightwave-adapter" {
-    import type { NightwaveBoard, RawSeasonInfo } from "warframe/types/index";
-    export function adaptNightwave(raw: RawSeasonInfo, now?: number): NightwaveBoard;
-}
-declare module "warframe/services/wf-service/wf-service.event" {
-    import type { EventBoard, RawWorldEvent, WarframeResult } from "warframe/types/index";
-    export function adaptEvents(rawEvents?: readonly RawWorldEvent[], now?: number): EventBoard;
-    export function getEventsFrom(snapshot?: {
-        raw?: unknown;
-        eventsRaw?: RawWorldEvent[];
-    }, now?: number): Promise<WarframeResult<EventBoard>>;
-    export function getEvents(): Promise<WarframeResult<EventBoard>>;
-}
-declare module "warframe/services/wf-service/index" {
+declare module "warframe/services/wf-service/wf-service.riven" {
     import type { WeeklyRiven } from 'warframe-weekly-rivens';
-    import type { AlertBoard, Arbitration, ArchiMedea, ArchonHunt, BountyBoard, BountyLocation, CalendarBoard, Fissure, InvasionBoard, NightwaveBoard, OcrAPISecret, RawCalendarSeason, RawInvasion, RawSeasonInfo, RawSortie, RawSteelPathOfferings, Relic, RivenAttribute, RivenStatAnalyzeResult, RivenStatResult, Sortie, SteelEssenceBoard, VoidTrader, WarframeResult } from "warframe/types/index";
+    import type { OcrAPISecret, RivenStatAnalyzeResult, RivenStatResult, WarframeResult } from "warframe/types/index";
+    import type { RivenCalculationAttribute } from "warframe/types/wf/riven";
     import { weaponRivenDispositionDict } from "warframe/data/wf/rivenDisposition";
-    export { adaptEvents, getEvents, getEventsFrom } from "warframe/services/wf-service/wf-service.event";
-    export function getRelic(input: string): Promise<WarframeResult<Relic>>;
-    export function getArbitrations(day?: number): WarframeResult<Arbitration[]>;
-    export function adaptArchonHunt(source: {
-        boss: string;
-        missions?: Array<{
-            type: string;
-            node?: string;
-            nodeKey: string;
-        }>;
-    }): Promise<ArchonHunt>;
+    export function getAnalyzedRiven(secret: OcrAPISecret, url: string, variant?: string): Promise<WarframeResult<RivenStatAnalyzeResult>>;
+    export function filterWeeklyRivens(data: WeeklyRiven[], minPrice: number, minPop?: number): WeeklyRiven[];
+    export function getWeeklyRivens(minPrice: number): Promise<WeeklyRiven[]>;
+    export function getStaticRivenStats(weaponType: string, statType: string, disposition: number): Promise<WarframeResult<RivenStatResult>>;
+    export function getWeaponRivenDisposition(name: string): (typeof weaponRivenDispositionDict)[string] | undefined;
+    export function parseOCRResult(ocrResult: string[]): Promise<{
+        name: string;
+        attributes: {
+            attr: RivenCalculationAttribute;
+            value: number;
+            prefix: string;
+        }[];
+    } | undefined>;
+    export function analyzeRivenStat(parseResult: {
+        name: string;
+        attributes: {
+            attr: RivenCalculationAttribute;
+            value: number;
+            prefix: string;
+        }[];
+    }, variant?: string): WarframeResult<RivenStatAnalyzeResult>;
+}
+declare module "warframe/data/wf/sortie" {
+    export function getSortieModeName(): string;
+    export function getSortieEnemyLevels(index: number): {
+        minLevel: number;
+        maxLevel: number;
+    };
+}
+declare module "warframe/services/wf-service/wf-service.sortie" {
+    import type { RawSortie, Sortie, WarframeResult } from "warframe/types/index";
     export function adaptSortie(source: RawSortie, dates?: {
         activation?: Date;
         expiry?: Date;
@@ -1082,53 +1224,9 @@ declare module "warframe/services/wf-service/index" {
         sortieRaw?: RawSortie;
     }): Promise<WarframeResult<Sortie>>;
     export function getSortie(): Promise<WarframeResult<Sortie>>;
-    export function getWeekly(): Promise<WarframeResult<{
-        archonHunt: ArchonHunt;
-        deepArchimedea: ArchiMedea;
-        temporalArchimedea: ArchiMedea;
-    }>>;
-    export function resolveNightwave(raw: RawSeasonInfo | undefined, now?: number): WarframeResult<NightwaveBoard>;
-    export function getNightwave(): Promise<WarframeResult<NightwaveBoard>>;
-    export function getEnvironment(): Promise<string>;
-    export function getBounty(location: BountyLocation): Promise<WarframeResult<BountyBoard>>;
-    export function getCircuitWeek(): {
-        currentIncarnons: number;
-        currentWarframes: number;
-        allIncarnons: string[][];
-        allWarframes: string[][];
-    };
-    export function adaptInvasions(rawInvasions: RawInvasion[]): Promise<InvasionBoard>;
-    export function getInvasionsFrom(snapshot?: {
-        raw?: unknown;
-        invasionsRaw?: RawInvasion[];
-    }): Promise<WarframeResult<InvasionBoard>>;
-    export function getInvasions(): Promise<WarframeResult<InvasionBoard>>;
-    export function adaptAlerts(alerts?: readonly {
-        expiry?: Date;
-        mission?: {
-            nodeKey?: string;
-            typeKey?: string;
-            minEnemyLevel?: number;
-            maxEnemyLevel?: number;
-            nightmare?: boolean;
-            reward?: {
-                items?: string[];
-                countedItems?: Array<{
-                    type?: string;
-                    key?: string;
-                    count?: number;
-                }>;
-                credits?: number;
-            };
-        };
-    }[], now?: number): Promise<AlertBoard>;
-    export function getAlerts(): Promise<WarframeResult<AlertBoard>>;
-    export function adaptCalendar(raw: RawCalendarSeason | undefined, now?: number): CalendarBoard;
-    export function getCalendarFrom(snapshot?: {
-        raw?: unknown;
-        calendarRaw?: RawCalendarSeason;
-    }, now?: number): Promise<WarframeResult<CalendarBoard>>;
-    export function getCalendar(): Promise<WarframeResult<CalendarBoard>>;
+}
+declare module "warframe/services/wf-service/wf-service.steel-essence" {
+    import type { RawSteelPathOfferings, SteelEssenceBoard, WarframeResult } from "warframe/types/index";
     export function adaptSteelEssence(raw?: RawSteelPathOfferings, now?: number): Promise<SteelEssenceBoard>;
     export function getSteelEssenceFrom(snapshot?: {
         raw?: {
@@ -1136,31 +1234,51 @@ declare module "warframe/services/wf-service/index" {
         };
     }, now?: number): Promise<WarframeResult<SteelEssenceBoard>>;
     export function getSteelEssence(): Promise<WarframeResult<SteelEssenceBoard>>;
-    export function getFissures(): Promise<WarframeResult<Fissure[]>>;
-    export function getSteelPathFissures(): Promise<WarframeResult<Fissure[]>>;
-    export function getRailjackFissures(): Promise<WarframeResult<Fissure[]>>;
-    export function getAnalyzedRiven(secret: OcrAPISecret, url: string): Promise<WarframeResult<RivenStatAnalyzeResult>>;
+}
+declare module "warframe/services/wf-service/wf-service.void-trader" {
+    import type { VoidTrader, WarframeResult } from "warframe/types/index";
     export function getVoidTrader(): Promise<WarframeResult<VoidTrader>>;
-    export function filterWeeklyRivens(data: WeeklyRiven[], minPrice: number, minPop?: number): WeeklyRiven[];
-    export function getWeeklyRivens(minPrice: number): Promise<WeeklyRiven[]>;
-    export function getStaticRivenStats(weaponType: string, statType: string, disposition: number): Promise<WarframeResult<RivenStatResult>>;
-    export function getWeaponRivenDisposition(name: string): (typeof weaponRivenDispositionDict)[string] | undefined;
-    export function parseOCRResult(ocrResult: string[]): Promise<{
-        name: string;
-        attributes: {
-            attr: RivenAttribute;
-            value: number;
-            prefix: string;
-        }[];
-    } | undefined>;
-    export function analyzeRivenStat(parseResult: {
-        name: string;
-        attributes: {
-            attr: RivenAttribute;
-            value: number;
-            prefix: string;
-        }[];
-    }): WarframeResult<RivenStatAnalyzeResult>;
+}
+declare module "warframe/data/wf/archonHunt" {
+    export function getArchonHuntModeName(): string;
+    export function getArchonHuntEnemyLevels(index: number): {
+        minLevel: number;
+        maxLevel: number;
+    };
+}
+declare module "warframe/services/wf-service/wf-service.weekly" {
+    import type { ArchiMedea, ArchonHunt, WarframeResult } from "warframe/types/index";
+    export function adaptArchonHunt(source: {
+        boss: string;
+        missions?: Array<{
+            type: string;
+            node?: string;
+            nodeKey: string;
+        }>;
+    }): Promise<ArchonHunt>;
+    export function getWeekly(): Promise<WarframeResult<{
+        archonHunt: ArchonHunt;
+        deepArchimedea: ArchiMedea;
+        temporalArchimedea: ArchiMedea;
+    }>>;
+}
+declare module "warframe/services/wf-service/index" {
+    export { adaptAlerts, getAlerts } from "warframe/services/wf-service/wf-service.alert";
+    export { getArbitrations } from "warframe/services/wf-service/wf-service.arbitration";
+    export { getBounty } from "warframe/services/wf-service/wf-service.bounty";
+    export { adaptCalendar, getCalendar, getCalendarFrom } from "warframe/services/wf-service/wf-service.calendar";
+    export { getCircuitWeek } from "warframe/services/wf-service/wf-service.circuit";
+    export { getEnvironment } from "warframe/services/wf-service/wf-service.environment";
+    export { adaptEvents, getEvents, getEventsFrom } from "warframe/services/wf-service/wf-service.event";
+    export { getFissures, getRailjackFissures, getSteelPathFissures, } from "warframe/services/wf-service/wf-service.fissure";
+    export { adaptInvasions, getInvasions, getInvasionsFrom } from "warframe/services/wf-service/wf-service.invasion";
+    export { getNightwave, resolveNightwave } from "warframe/services/wf-service/wf-service.nightwave";
+    export { getRelic } from "warframe/services/wf-service/wf-service.relic";
+    export { analyzeRivenStat, filterWeeklyRivens, getAnalyzedRiven, getStaticRivenStats, getWeaponRivenDisposition, getWeeklyRivens, parseOCRResult, } from "warframe/services/wf-service/wf-service.riven";
+    export { adaptSortie, getSortie, getSortieFrom } from "warframe/services/wf-service/wf-service.sortie";
+    export { adaptSteelEssence, getSteelEssence, getSteelEssenceFrom, } from "warframe/services/wf-service/wf-service.steel-essence";
+    export { getVoidTrader } from "warframe/services/wf-service/wf-service.void-trader";
+    export { adaptArchonHunt, getWeekly } from "warframe/services/wf-service/wf-service.weekly";
 }
 declare module "warframe/data/wfm/globalItem" {
     import type { AsyncCache, ItemShort } from "warframe/types/index";
@@ -1239,9 +1357,31 @@ declare module "warframe/services/wfm-service/wfm-service.item-matcher" {
 }
 declare module "warframe/data/wfm/globalDucatnator" {
     import type { AsyncCache, Ducatnator } from "warframe/types/index";
+    interface DucatnatorSnapshot {
+        hour: Ducatnator[];
+        day?: Ducatnator[];
+    }
+    export function globalDucatnatorIDDictFactory(data?: DucatnatorSnapshot): Promise<Record<string, Ducatnator> | undefined>;
     export let globalDucatnatorIDDict: AsyncCache<Record<string, Ducatnator> | undefined>;
     export function overrideGlobalDucatnatorIDDict(cache: AsyncCache<Record<string, Ducatnator> | undefined>): void;
 }
+declare module "warframe/data/wfm/globalRivenAttribute" {
+    import type { AsyncCache, RivenAttribute } from "warframe/types/index";
+    export function globalRivenAttributeFactory(rivenAttributeData?: RivenAttribute[]): Promise<{
+        globalRivenAttributeList: RivenAttribute[];
+        globalRivenAttributeDict: Record<string, RivenAttribute>;
+    }>;
+    export let globalRivenAttribute: AsyncCache<{
+        globalRivenAttributeList: RivenAttribute[];
+        globalRivenAttributeDict: Record<string, RivenAttribute>;
+    }>;
+    export function overrideGlobalRivenAttribute(cache: AsyncCache<{
+        globalRivenAttributeList: RivenAttribute[];
+        globalRivenAttributeDict: {
+            [key: string]: RivenAttribute;
+        };
+    }>): void;
+}
 declare module "warframe/services/wfm-service/wfm-service.riven-item-matcher" {
     import type { GlobalRivenItemWordPrefixCandidate } from "warframe/data/wfm/globalRivenItem";
     import type { RivenItem } from "warframe/types/index";
@@ -1283,9 +1423,9 @@ declare module "warframe/services/wfm-service/index" {
     export const primedModHistory: import("warframe").AsyncCache<PrimedModHistoryItem[]>;
 }
 declare module "warframe/services/world-state-refresh" {
+    import type { GlobalWorldStateData } from "warframe/data/wf/globalWorldState";
     import type { VoidTraderItem, WFRegionShort } from "warframe/types/index";
-    import { globalWorldState } from "warframe/data/wf/globalWorldState";
-    export type WorldStateSnapshot = Awaited<ReturnType<typeof globalWorldState.get>>;
+    export type WorldStateSnapshot = GlobalWorldStateData;
     export type WorldStateNotification = {
         type: 'fissure';
         id: string;
@@ -1364,6 +1504,9 @@ declare module "i18n" {
         readonly 'riven.dispositionError': "裂罅倾向错误";
         readonly 'riven.weaponTypeError': "武器类型错误";
         readonly 'riven.statTypeError': "词条类型错误";
+        readonly 'riven.unverifiedStat': "{stat}的显示换算尚未确认，暂不提供数值分析。";
+        readonly 'riven.variantRequired': "组合枪的主副武器倾向不同，请使用 riven -v primary 或 riven -v secondary 指定形态。";
+        readonly 'riven.variantError': "组合枪形态应为 primary（主武器）或 secondary（副武器）。";
         readonly 'riven.invalidParams': "请输入正确参数";
         readonly 'riven.noWeeklyData': "没有找到符合条件的紫卡参考数据";
         readonly 'wfm.inputItemName': "请输入物品名称";
@@ -1451,7 +1594,9 @@ declare module "commands/wf" {
         steelPathFissureCommand: (_action: Argv) => Promise<string>;
         railjackFissureCommand: (_action: Argv) => Promise<string>;
         relicCommand: (_action: Argv, input: string) => Promise<string>;
-        rivenCommand: (_action: Argv, input: Dict) => Promise<string>;
+        rivenCommand: (_action: Argv<never, never, unknown[], {
+            variant?: string;
+        }>, input: Dict) => Promise<string>;
         rivenStatCommand: (_action: Argv, weaponType: string, statType: string, disposition: number) => Promise<string>;
         weeklyCommand: (_action: Argv) => Promise<string>;
         nightwaveCommand: (_action: Argv) => Promise<string>;