@bettergi/types 0.1.14 → 0.1.16

package/types/BetterGenshinImpact/Core/Script/Dependence/Model/SoloTask.d.ts

@@ -3,23 +3,84 @@ import type {
   HostType,
   ReferenceTypeTrait
 } from "../../../../../Microsoft/ClearScript/HostType";
-import "../../../../../Microsoft/ClearScript/ScriptObject";
+import "../../../../GameTask/Common/Job/CountInventoryItemParam";
+import "../../../../GameTask/Model/GameUI/GridScreenName";
 
 /**
- * 独立任务注册名
+ * 任务名 → SoloTask.Config（唯一真源；配置一律 inline，无额外 type 名）
+ * @see Dispatcher.RunTask switch / BuildFromSoloTaskConfig
+ * @since 0.43.1
+ */
+export type SoloTaskConfigMap = {
+  /** 自动七圣召唤  */
+  AutoGeniusInvokation: {
+    /** 七圣策略文本；空则回退 UI 设置 */
+    strategy?: string;
+  };
+  /** 自动伐木 */
+  AutoWood: void;
+  /** 自动战斗 */
+  AutoFight: void;
+  /** 自动秘境 */
+  AutoDomain: void;
+  /** 自动首领 */
+  AutoBoss: void;
+  /** 自动钓鱼 */
+  AutoFishing: {
+    wholeProcessTimeoutSeconds?: number;
+    throwRodTimeOutTimeoutSeconds?: number;
+    /**
+     * 钓鱼时间策略
+     * - 0 全天
+     * - 1 白天
+     * - 2 夜晚
+     * - 3 不调
+     */
+    fishingTimePolicy?: 0 | 1 | 2 | 3 | number;
+    /** 关键节拍是否保存截图（调试用）；默认 false */
+    saveScreenshotOnKeyTick?: boolean;
+  };
+  /** 自动烹饪 */
+  AutoCook: void;
+  /** 自动吃药 */
+  AutoEat: {
+    foodName?: string | null;
+    /**
+     * 料理类型
+     * - 0 恢复类料理
+     * - 1 攻击类料理
+     * - 2 冒险类料理
+     * - 3 防御类料理
+     * - 4 药剂
+     * - 5 其他
+     */
+    foodEffectType?: 0 | 1 | 2 | 3 | 4 | 5 | number;
+  };
+  /** 统计背包物品 */
+  CountInventoryItem: {
+    /**  gridScreenName 必填 */
+    gridScreenName:
+      | BetterGenshinImpact.GameTask.Common.Job.CountInventoryItemParam["gridScreenName"]
+      | number
+      | BetterGenshinImpact.GameTask.Model.GameUI.GridScreenName;
+    /** itemName 与 itemNames 互斥 */
+    itemName?: string | null;
+    itemNames?: readonly string[] | string[];
+  };
+};
+
+/**
+ * 独立任务注册名 = map key；`(string & {})` 保留未知扩展
  * @since 0.46.0
  */
-export type SoloTaskName =
-  | "AutoGeniusInvokation" // 自动七圣召唤
-  | "AutoWood" // 自动伐木
-  | "AutoFight" // 自动战斗
-  | "AutoDomain" // 自动秘境
-  | "AutoBoss" // 自动首领
-  | "AutoFishing" // 自动钓鱼
-  | "AutoCook" // 自动烹饪
-  | "AutoEat" // 自动食用
-  | "CountInventoryItem" // 统计背包物品
-  | (string & {});
+export type SoloTaskName = keyof SoloTaskConfigMap | (string & {});
+
+export type SoloTaskConfigForName<TName extends SoloTaskName> =
+  TName extends keyof SoloTaskConfigMap
+    ? SoloTaskConfigMap[TName] extends void
+      ? undefined
+      : SoloTaskConfigMap[TName]
+    : Record<string, unknown>;
 
 /**
  * 独立任务
@@ -34,32 +95,43 @@ export interface SoloTask extends ClrHostValue {
    */
   name: SoloTaskName;
   /**
-   * 独立任务配置
+   * 独立任务配置（CLR 存 `object?`，JS 侧 plain object）
    * @since 0.43.1
    */
-  config: unknown;
+  config:
+    | Exclude<SoloTaskConfigMap[keyof SoloTaskConfigMap], void>
+    | Record<string, unknown>
+    | null
+    | undefined;
 }
 
 declare global {
   namespace BetterGenshinImpact.Core.Script.Dependence.Model {
     type SoloTask = import("./SoloTask").SoloTask;
+    type SoloTaskConfigForName<TName extends SoloTaskName> =
+      import("./SoloTask").SoloTaskConfigForName<TName>;
+    type SoloTaskConfigMap = import("./SoloTask").SoloTaskConfigMap;
+    type SoloTaskName = import("./SoloTask").SoloTaskName;
   }
 }
 
 export interface SoloTaskHostType extends HostType<SoloTask, ReferenceTypeTrait> {
   /**
-   * 构造实例
-   * @param name 独立任务名称
+   * 仅名称
    * @since 0.43.1
    */
   new (name: SoloTaskName): SoloTask;
+
   /**
-   * 构造实例
-   * @param name 独立任务名称
-   * @param config 独立任务配置对象
+   * 名称 + 配置（按任务名收窄）
    * @since 0.43.1
    */
-  new (name: SoloTaskName, config: Microsoft.ClearScript.ScriptObject): SoloTask;
+  new <TName extends SoloTaskName>(
+    name: TName,
+    config: SoloTaskConfigForName<TName> extends undefined
+      ? Record<string, unknown> | undefined
+      : SoloTaskConfigForName<TName>
+  ): SoloTask;
 }
 
 export {};

package/types/BetterGenshinImpact/GameTask/AutoBoss/AutoBossConfig.d.ts

@@ -6,6 +6,64 @@ import type {
 } from "../../../Microsoft/ClearScript/HostType";
 import "../../../System/ComponentModel/INotifyPropertyChanged";
 import "../../../System/ComponentModel/INotifyPropertyChanging";
+import type { CombatStrategyName } from "../AutoFight/AutoFightConfig";
+
+/**
+ * 自动首领讨伐支持的 Boss 名称
+ * 来源：上游 `AutoBossData.CountryToBosses` 扁平列表（启动时 `IsSupportedBoss` 校验）
+ * @since 0.62.0
+ */
+export type BossName =
+  // 蒙德
+  | "急冻树"
+  | "无相之雷"
+  | "守望者·堕天"
+  // 璃月
+  | "爆炎树"
+  | "纯水精灵"
+  | "古岩龙蜥"
+  | "无相之岩"
+  | "遗迹巨蛇"
+  | "隐山猊兽"
+  // 稻妻
+  | "无相之火"
+  | "恒常机关阵列"
+  | "雷音权现"
+  | "魔偶剑鬼"
+  | "无相之水"
+  // 须弥
+  | "掣电树"
+  | "半永恒统辖矩阵"
+  | "翠翎恐蕈"
+  | "风蚀沙虫"
+  | "无相之草"
+  | "深罪浸礼者"
+  | "兆载永劫龙兽"
+  // 枫丹
+  | "歌裴莉娅的葬送"
+  | "科培琉司的劫罚"
+  | "实验性场力发生装置"
+  | "魔像督军"
+  | "千年珍珠骏麟"
+  | "水形幻人"
+  | "铁甲熔火帝皇"
+  // 纳塔
+  | "金焰绒翼龙暴君"
+  | "灵觉隐修的迷者"
+  | "秘源机兵·构型械"
+  | "秘源机兵·统御械"
+  | "熔岩辉龙像"
+  | "深邃摹结株"
+  | "贪食匿叶龙山王"
+  // 挪德卡莱
+  | "蕴光月守宫"
+  | "深黯魇语之主"
+  | "超重型陆巡舰·机动战垒"
+  | "霜夜巡天灵主"
+  | "蕴光月幻蝶"
+  | "重拳出击鸭"
+  | "" // 未指定
+  | (string & {});
 
 /**
  * 自动首领讨伐的持久化配置，由独立任务页使用
@@ -31,10 +89,10 @@ export interface AutoBossConfig
     System.ComponentModel.INotifyPropertyChangingInput {
   readonly [autoBossConfigBrand]: true;
   /**
-   * 需要讨伐的 Boss 名称
+   * 需要讨伐的 Boss 名称；空字符串表示未指定，启动前须为受支持名单内名称
    * @since 0.62.0
    */
-  bossName: string;
+  bossName: BossName;
   /**
    * 每轮领奖后是否先返回七天神像，再重新前往 Boss
    * @since 0.62.0
@@ -64,7 +122,7 @@ export interface AutoBossConfig
    * 战斗策略名称，`根据队伍自动选择` 表示按当前队伍匹配策略
    * @since 0.62.0
    */
-  strategyName: string;
+  strategyName: CombatStrategyName;
   /**
    * 讨伐前需要切换到的队伍名称，为空时保持当前队伍
    * @since 0.62.0
@@ -85,6 +143,7 @@ export interface AutoBossConfig
 declare global {
   namespace BetterGenshinImpact.GameTask.AutoBoss {
     type AutoBossConfig = import("./AutoBossConfig").AutoBossConfig;
+    type BossName = import("./AutoBossConfig").BossName;
   }
 }
 

package/types/BetterGenshinImpact/GameTask/AutoBoss/AutoBossParam.d.ts

@@ -4,7 +4,9 @@ import type {
   ReferenceTypeTrait
 } from "../../../Microsoft/ClearScript/HostType";
 import type { VoidResult } from "../../../Microsoft/ClearScript/VoidResult";
+import type { CombatStrategyName } from "../AutoFight/AutoFightConfig";
 import "../Model/BaseTaskParam";
+import type { BossName } from "./AutoBossConfig";
 import "./AutoBossConfig";
 import "./AutoBossTask";
 
@@ -32,15 +34,15 @@ export interface AutoBossParam extends Omit<
 > {
   readonly [autoBossParamBrand]: true;
   /**
-   * 需要讨伐的 Boss 名称
+   * 需要讨伐的 Boss 名称；空字符串表示未指定，启动前须为受支持名单内名称
    * @since 0.62.0
    */
-  bossName: string;
+  bossName: BossName;
   /**
    * 界面中选择的战斗策略名称；无自定义策略路径时会同步更新实际策略路径
    * @since 0.62.0
    */
-  strategyName: string;
+  strategyName: CombatStrategyName;
   /**
    * 实际用于解析自动战斗脚本的路径，脚本可直接设置该路径以覆盖界面选择
    * @since 0.62.0
@@ -106,7 +108,7 @@ export interface AutoBossParam extends Omit<
    * @since 0.62.0
    */
   setCombatStrategyPath(): VoidResult;
-  setCombatStrategyPath(strategyName: string | null): VoidResult;
+  setCombatStrategyPath(strategyName: CombatStrategyName | null): VoidResult;
 }
 
 declare global {

package/types/BetterGenshinImpact/GameTask/AutoDomain/AutoDomainParam.d.ts

@@ -7,7 +7,9 @@ import type {
 } from "../../../Microsoft/ClearScript/HostType";
 import type { VoidResult } from "../../../Microsoft/ClearScript/VoidResult";
 import "../../../System/Collections/Generic/List";
+import type { CombatStrategyName } from "../AutoFight/AutoFightConfig";
 import "../Model/BaseTaskParam";
+import type { ArtifactStar, DomainName, ResinName, SundaySelectedValue } from "./AutoDomainTask";
 import "./AutoDomainTask";
 
 /**
@@ -54,15 +56,15 @@ export interface AutoDomainParam extends Omit<
    */
   partyName: string;
   /**
-   * 需要刷取的秘境名称
+   * 需要刷取的秘境名称；空字符串表示未指定
    * @since 0.52.0
    */
-  domainName: string;
+  domainName: DomainName;
   /**
-   * 周日秘境奖励选项
+   * 周日 / 限时全开秘境奖励选项序号；空字符串表示不指定
    * @since 0.52.0
    */
-  sundaySelectedValue: string;
+  sundaySelectedValue: SundaySelectedValue;
   /**
    * 是否在结束后自动分解圣遗物
    * @since 0.52.0
@@ -72,7 +74,7 @@ export interface AutoDomainParam extends Omit<
    * 分解圣遗物的最大星级，取值 1–4，默认 `4`
    * @since 0.52.0
    */
-  maxArtifactStar: string;
+  maxArtifactStar: ArtifactStar;
   /**
    * 是否启用指定树脂使用次数模式
    * @since 0.52.0
@@ -82,7 +84,7 @@ export interface AutoDomainParam extends Omit<
    * 使用树脂的优先级列表，默认浓缩树脂优先于原粹树脂
    * @since 0.52.0
    */
-  resinPriorityList: System.Collections.Generic.List<string>;
+  resinPriorityList: System.Collections.Generic.List<ResinName>;
   /**
    * 使用原粹树脂刷取副本的次数
    * @since 0.52.0
@@ -131,15 +133,15 @@ export interface AutoDomainParam extends Omit<
    * @since 0.52.0
    */
   setCombatStrategyPath(): string;
-  setCombatStrategyPath(strategyName: string | null): string;
+  setCombatStrategyPath(strategyName: CombatStrategyName | null): string;
   /**
    * 设置使用树脂的优先级列表
    * @param priorities 树脂名称数组，顺序即优先级
    * @returns ClearScript 宿主空结果
    * @since 0.52.0
    */
-  setResinPriorityList(priorities: HostArray<string>): VoidResult;
-  setResinPriorityList(...priorities: string[]): VoidResult;
+  setResinPriorityList(priorities: HostArray<ResinName>): VoidResult;
+  setResinPriorityList(...priorities: ResinName[]): VoidResult;
 }
 
 declare global {

package/types/BetterGenshinImpact/GameTask/AutoDomain/AutoDomainTask.d.ts

@@ -19,6 +19,63 @@ import "./AutoDomainParam";
 export type ResinName =
   "浓缩树脂" | "原粹树脂" | "原粹树脂20" | "原粹树脂40" | "须臾树脂" | "脆弱树脂" | (string & {});
 
+/**
+ * 分解圣遗物最大星级（字符串）；上游 `int.TryParse` 后按 1–4 使用
+ * @since 0.52.0
+ */
+export type ArtifactStar = "1" | "2" | "3" | "4" | (string & {});
+
+/**
+ * 可自动刷取的秘境名称
+ * 来源：`MapLazyAssets` 从 `tp.json` 提取的 BlessDomain / ForgeryDomain / MasteryDomain 点位名
+ * @since 0.52.0
+ */
+export type DomainName =
+  | "铭记之谷"
+  | "忘却之峡"
+  | "仲夏庭园"
+  | "塞西莉亚苗圃"
+  | "无妄引咎密宫"
+  | "太山府"
+  | "震雷连山密宫"
+  | "孤云凌霄之处"
+  | "华池岩岫"
+  | "芬德尼尔之顶"
+  | "山脊守望"
+  | "菫色之庭"
+  | "椛染之庭"
+  | "砂流之庭"
+  | "沉眠之庭"
+  | "昏识塔"
+  | "缘觉塔"
+  | "有顶塔"
+  | "岩中幽谷"
+  | "赤金的城墟"
+  | "熔铁的孤塞"
+  | "深潮的余响"
+  | "苍白的遗荣"
+  | "罪祸的终末"
+  | "临瀑之城"
+  | "褪色的剧场"
+  | "蕴火的幽墟"
+  | "深古瞭望所"
+  | "虹灵的净土"
+  | "荒废砌造坞"
+  | "无光的深都"
+  | "霜凝的机枢"
+  | "失落的月庭"
+  | "月童的库藏"
+  | "山风的荆冕"
+  | "" // 未指定
+  | (string & {});
+
+/**
+ * 周日 / 限时全开秘境奖励选项序号
+ * UI 列表为 `""` / `1` / `2` / `3`；任务内 `switch` 仅处理 1–3
+ * @since 0.52.0
+ */
+export type SundaySelectedValue = "" | "1" | "2" | "3" | (string & {});
+
 /**
  * 自动秘境独立任务
  * @since 0.52.0
@@ -51,6 +108,10 @@ export interface AutoDomainTask
 declare global {
   namespace BetterGenshinImpact.GameTask.AutoDomain {
     type AutoDomainTask = import("./AutoDomainTask").AutoDomainTask;
+    type ArtifactStar = import("./AutoDomainTask").ArtifactStar;
+    type DomainName = import("./AutoDomainTask").DomainName;
+    type ResinName = import("./AutoDomainTask").ResinName;
+    type SundaySelectedValue = import("./AutoDomainTask").SundaySelectedValue;
   }
 }
 

package/types/BetterGenshinImpact/GameTask/AutoFight/AutoFightConfig.d.ts

@@ -17,6 +17,28 @@ export type OnlyPickEliteDropsMode =
   | "DisableAutoPickupForNonElite" // 非精英关闭自动拾取
   | (string & {});
 
+/**
+ * 战斗策略名称；`根据队伍自动选择` 表示按当前队伍匹配策略目录，其余为 `User/AutoFight` 下策略文件名（不含扩展名）
+ * @since 0.52.0
+ */
+export type CombatStrategyName = "根据队伍自动选择" | (string & {});
+
+/**
+ * 战斗策略文件种类标识
+ * 与上游 `AutoFightParam.ResolveStrategyPath` 返回的第二项对齐：优先命中 `.json`，否则回退 `.txt`；自动选队目录亦标为 `txt`
+ * @since 0.52.0
+ */
+export type StrategyFileKind =
+  | "json" // JSON 战斗策略
+  | "txt" // 文本 / 简易策略（含「根据队伍自动选择」目录）
+  | (string & {});
+
+/**
+ * 队伍内角色槽位序号（字符串），从 1 开始；空字符串表示不指定
+ * @since 0.52.0
+ */
+export type PartySlotIndex = "1" | "2" | "3" | "4" | "" | (string & {});
+
 /**
  * 自动战斗配置
  * @since 0.52.0
@@ -89,7 +111,7 @@ export interface AutoFightConfig
    * 盾奶位角色队伍序号，从 1 开始，空字符串表示不指定
    * @since 0.52.0
    */
-  guardianAvatar: string;
+  guardianAvatar: PartySlotIndex;
   /**
    * 是否跳过盾奶位自身的战斗策略脚本
    * @since 0.52.0
@@ -134,7 +156,7 @@ export interface AutoFightConfig
    * 战斗策略名称，`根据队伍自动选择` 表示按当前队伍匹配策略
    * @since 0.52.0
    */
-  strategyName: string;
+  strategyName: CombatStrategyName;
   /**
    * 是否启用游泳脱困检测
    * @since 0.52.0
@@ -248,6 +270,10 @@ declare global {
 declare global {
   namespace BetterGenshinImpact.GameTask.AutoFight {
     type AutoFightConfig = import("./AutoFightConfig").AutoFightConfig;
+    type CombatStrategyName = import("./AutoFightConfig").CombatStrategyName;
+    type OnlyPickEliteDropsMode = import("./AutoFightConfig").OnlyPickEliteDropsMode;
+    type PartySlotIndex = import("./AutoFightConfig").PartySlotIndex;
+    type StrategyFileKind = import("./AutoFightConfig").StrategyFileKind;
   }
 }
 

package/types/BetterGenshinImpact/GameTask/AutoFight/AutoFightParam.d.ts

@@ -8,7 +8,12 @@ import type { VoidResult } from "../../../Microsoft/ClearScript/VoidResult";
 import "../../../System/ValueTuple";
 import "../Model/BaseTaskParam";
 import "./AutoFightConfig";
-import type { OnlyPickEliteDropsMode } from "./AutoFightConfig";
+import type {
+  CombatStrategyName,
+  OnlyPickEliteDropsMode,
+  PartySlotIndex,
+  StrategyFileKind
+} from "./AutoFightConfig";
 import "./AutoFightTask";
 
 /**
@@ -101,7 +106,7 @@ export interface AutoFightParam extends Omit<
    * 盾奶位角色队伍序号，从 1 开始，空字符串表示不指定
    * @since 0.52.0
    */
-  guardianAvatar: string;
+  guardianAvatar: PartySlotIndex;
   /**
    * 是否跳过盾奶位自身的战斗策略脚本
    * @since 0.52.0
@@ -149,7 +154,7 @@ export interface AutoFightParam extends Omit<
    * @since 0.52.0
    */
   setCombatStrategyPath(): VoidResult;
-  setCombatStrategyPath(strategyName: string | null): VoidResult;
+  setCombatStrategyPath(strategyName: CombatStrategyName | null): VoidResult;
   /**
    * 从当前全局自动战斗配置填充默认参数
    * @returns ClearScript 宿主空结果
@@ -243,7 +248,7 @@ export interface AutoFightParamHostType extends HostType<AutoFightParam, Referen
    * @since 0.52.0
    */
   new (): AutoFightParam;
-  new (strategyName: string | null): AutoFightParam;
+  new (strategyName: CombatStrategyName | null): AutoFightParam;
   /**
    * 是否启用游泳脱困检测
    * @since 0.52.0
@@ -252,10 +257,12 @@ export interface AutoFightParamHostType extends HostType<AutoFightParam, Referen
   /**
    * 解析策略文件路径，优先检测 `.json`，未命中则回退 `.txt`
    * @param strategyName 策略名称（不含扩展名）
-   * @returns 完整路径与类型标识组成的元组，类型为 `json` 或 `txt`
+   * @returns 完整路径与策略文件种类组成的元组
    * @since 0.52.0
    */
-  resolveStrategyPath(strategyName: string): System.ValueTuple<string, string>;
+  resolveStrategyPath(
+    strategyName: CombatStrategyName
+  ): System.ValueTuple<string, StrategyFileKind>;
   readonly FightFinishDetectConfig: AutoFightParam_FightFinishDetectConfigHostType;
 }