delta-force-core 0.1.2 → 0.2.1

package/dist/engine.js

@@ -0,0 +1,141 @@
+// =====================================================
+// delta-force-core 引擎
+//
+// 官方数据 + 用户覆盖层 → 统一的抽签 / 查询接口
+// =====================================================
+import { OPERATORS } from './data/operators.js';
+import { WEAPONS } from './data/weapons.js';
+import { EQUIPMENT } from './data/equipment.js';
+import { AMMO } from './data/ammo.js';
+// -----------------------------------------------------
+// 内部工具
+// -----------------------------------------------------
+function pick(list) {
+    if (list.length === 0)
+        throw new Error('[delta-force-core] 待抽取的列表为空');
+    return list[Math.floor(Math.random() * list.length)];
+}
+/** undefined 视为 true（缺省允许普通模式） */
+function matchAllowNormal(filter, value) {
+    if (filter === undefined)
+        return true;
+    return (value ?? true) === filter;
+}
+function pickFromTiers(tiers, options = {}) {
+    const { tier, allowNormal } = options;
+    const valid = tiers.filter((t) => (tier === undefined || t.tier === tier) && matchAllowNormal(allowNormal, t.allowNormal));
+    if (valid.length === 0) {
+        throw new Error(`[delta-force-core] 没有符合条件的装备等级（tier=${tier ?? '*'}，allowNormal=${allowNormal ?? '*'}）`);
+    }
+    return pick(valid.flatMap((t) => t.items));
+}
+function findInTiers(tiers, id) {
+    for (const t of tiers) {
+        const hit = t.items.find((i) => i.id === id);
+        if (hit)
+            return hit;
+    }
+    return undefined;
+}
+// -----------------------------------------------------
+// createEngine
+// -----------------------------------------------------
+export function createEngine(options = {}) {
+    const { qualityOverride = {}, aliasOverride = {}, tagOverride = {} } = options;
+    // ---------- 数据视图 ----------
+    const getOperators = () => OPERATORS;
+    const getWeapons = () => WEAPONS;
+    const getAmmo = () => AMMO;
+    const getEquipment = () => EQUIPMENT;
+    const listAllOperators = () => OPERATORS.flatMap((g) => g.operators);
+    const listAllWeapons = () => WEAPONS.flatMap((g) => g.weapons);
+    // ---------- 抽签 ----------
+    function getRandomOperator(category) {
+        if (!category)
+            return pick(listAllOperators());
+        const group = OPERATORS.find((g) => g.category === category);
+        if (!group) {
+            throw new Error(`[delta-force-core] 未找到兵种分类 "${category}"，可用：${OPERATORS.map((g) => g.category).join(' / ')}`);
+        }
+        return pick(group.operators);
+    }
+    function getRandomWeapon(opt = {}) {
+        const { category, quality, allowNormal } = opt;
+        const pool = [];
+        for (const group of WEAPONS) {
+            if (category && group.category !== category)
+                continue;
+            for (const w of group.weapons) {
+                if (!matchAllowNormal(allowNormal, w.allowNormal))
+                    continue;
+                if (quality && qualityOverride[w.id] !== quality)
+                    continue;
+                pool.push(w);
+            }
+        }
+        if (pool.length === 0) {
+            throw new Error(`[delta-force-core] 没有符合条件的武器（category=${category ?? '*'}，quality=${quality ?? '*'}，allowNormal=${allowNormal ?? '*'})`);
+        }
+        return pick(pool);
+    }
+    function getRandomAmmo(opt = {}) {
+        const { caliber } = opt;
+        const pool = caliber ? AMMO.filter((a) => a.caliber === caliber) : AMMO.slice();
+        return pick(pool);
+    }
+    const getRandomArmor = (o) => pickFromTiers(EQUIPMENT.armors, o);
+    const getRandomHelmet = (o) => pickFromTiers(EQUIPMENT.helmets, o);
+    const getRandomBackpack = (o) => pickFromTiers(EQUIPMENT.backpacks, o);
+    const getRandomChestRig = (o) => pickFromTiers(EQUIPMENT.chest_rigs, o);
+    function getRandomLoadout(o = {}) {
+        const { allowNormal } = o;
+        return {
+            operator: getRandomOperator(),
+            weapon: getRandomWeapon({ allowNormal }),
+            armor: getRandomArmor({ allowNormal }),
+            helmet: getRandomHelmet({ allowNormal }),
+            backpack: getRandomBackpack(),
+            chestRig: getRandomChestRig(),
+        };
+    }
+    // ---------- 查询 ----------
+    const findOperatorById = (id) => listAllOperators().find((o) => o.id === id);
+    const findWeaponById = (id) => listAllWeapons().find((w) => w.id === id);
+    const findAmmoById = (id) => AMMO.find((a) => a.id === id);
+    const findArmorById = (id) => findInTiers(EQUIPMENT.armors, id);
+    const findHelmetById = (id) => findInTiers(EQUIPMENT.helmets, id);
+    const findBackpackById = (id) => findInTiers(EQUIPMENT.backpacks, id);
+    const findChestRigById = (id) => findInTiers(EQUIPMENT.chest_rigs, id);
+    const findWeaponsByCaliber = (caliber) => listAllWeapons().filter((w) => w.caliber === caliber);
+    const findAmmoByCaliber = (caliber) => AMMO.filter((a) => a.caliber === caliber);
+    function findWeaponByAlias(alias) {
+        const hit = Object.entries(aliasOverride).find(([, list]) => list.includes(alias));
+        if (!hit)
+            return undefined;
+        return findWeaponById(hit[0]);
+    }
+    // ---------- 用户层 ----------
+    const getWeaponQuality = (id) => qualityOverride[id];
+    const getAliases = (id) => aliasOverride[id] ?? [];
+    const getTags = (id) => tagOverride[id] ?? [];
+    const listOperatorCategories = () => OPERATORS.map((g) => g.category);
+    const listWeaponCategories = () => WEAPONS.map((g) => g.category);
+    return {
+        // 数据视图
+        getOperators, getWeapons, getAmmo, getEquipment,
+        // 抽签
+        getRandomOperator, getRandomWeapon, getRandomAmmo,
+        getRandomArmor, getRandomHelmet, getRandomBackpack, getRandomChestRig,
+        getRandomLoadout,
+        // 查询
+        findOperatorById, findWeaponById, findAmmoById,
+        findArmorById, findHelmetById, findBackpackById, findChestRigById,
+        findWeaponsByCaliber, findAmmoByCaliber, findWeaponByAlias,
+        // 用户层
+        getWeaponQuality, getAliases, getTags,
+        // 列表
+        listOperatorCategories, listWeaponCategories,
+        listAllOperators, listAllWeapons,
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,42 +1,10 @@
-import type { Operator, Weapon, ArmorItem, BackpackItem, ChestRigItem, Loadout, WeaponOptions, LoadoutOptions } from './types.js';
-export * from './data.js';
+import type { Engine } from './types.js';
 export * from './types.js';
-/**
- * 随机抽取一名干员。
- *
- * @param category 兵种分类（"突击兵" | "支援兵" | "工程兵" | "侦察兵"）。不传则从全部干员中抽取。
- * @throws 当传入的分类不存在或该分类下没有干员时抛错。
- *
- * @example
- *   getRandomOperator();               // 任意干员
- *   getRandomOperator('突击兵');        // 只从突击兵里抽
- */
-export declare function getRandomOperator(category?: string): Operator;
-/**
- * 随机抽取一把武器，支持按武器分类 / 品质 / 普通模式可用性过滤。
- *
- * @example
- *   getRandomWeapon();                                        // 任意武器
- *   getRandomWeapon({ category: '突击步枪' });                 // 只抽突击步枪
- *   getRandomWeapon({ quality: '金色' });                      // 只抽金色
- *   getRandomWeapon({ allowNormal: true });                   // 只抽普通模式可用的
- *   getRandomWeapon({ category: '狙击步枪', quality: '金色' });
- */
-export declare function getRandomWeapon(options?: WeaponOptions): Weapon;
-/** 随机防具 */
-export declare function getRandomArmor(allowNormal?: boolean): ArmorItem;
-/** 随机头盔 */
-export declare function getRandomHelmet(allowNormal?: boolean): ArmorItem;
-/** 随机背包 */
-export declare function getRandomBackpack(): BackpackItem;
-/** 随机弹挂 */
-export declare function getRandomChestRig(): ChestRigItem;
-/**
- * 随机生成一套完整的战术配置。
- *
- * @example
- *   const loadout = getRandomLoadout();
- *   const normalLoadout = getRandomLoadout({ allowNormal: true });
- */
-export declare function getRandomLoadout(options?: LoadoutOptions): Loadout;
+export { OPERATORS } from './data/operators.js';
+export { WEAPONS } from './data/weapons.js';
+export { EQUIPMENT } from './data/equipment.js';
+export { AMMO } from './data/ammo.js';
+export { createEngine } from './engine.js';
+export declare const defaultEngine: Engine;
+export declare const getOperators: () => readonly import("./types.js").OperatorCategory[], getWeapons: () => readonly import("./types.js").WeaponCategory[], getAmmo: () => readonly import("./types.js").Ammo[], getEquipment: () => import("./types.js").Equipment, getRandomOperator: (category?: string) => import("./types.js").Operator, getRandomWeapon: (options?: import("./types.js").WeaponOptions) => import("./types.js").Weapon, getRandomAmmo: (options?: import("./types.js").AmmoOptions) => import("./types.js").Ammo, getRandomArmor: (options?: import("./types.js").TierOptions) => import("./types.js").EquipmentItem, getRandomHelmet: (options?: import("./types.js").TierOptions) => import("./types.js").EquipmentItem, getRandomBackpack: (options?: import("./types.js").TierOptions) => import("./types.js").EquipmentItem, getRandomChestRig: (options?: import("./types.js").TierOptions) => import("./types.js").EquipmentItem, getRandomLoadout: (options?: import("./types.js").LoadoutOptions) => import("./types.js").Loadout, findOperatorById: (id: string) => import("./types.js").Operator | undefined, findWeaponById: (id: string) => import("./types.js").Weapon | undefined, findAmmoById: (id: string) => import("./types.js").Ammo | undefined, findArmorById: (id: string) => import("./types.js").EquipmentItem | undefined, findHelmetById: (id: string) => import("./types.js").EquipmentItem | undefined, findBackpackById: (id: string) => import("./types.js").EquipmentItem | undefined, findChestRigById: (id: string) => import("./types.js").EquipmentItem | undefined, findWeaponsByCaliber: (caliber: string) => import("./types.js").Weapon[], findAmmoByCaliber: (caliber: string) => import("./types.js").Ammo[], findWeaponByAlias: (alias: string) => import("./types.js").Weapon | undefined, getWeaponQuality: (weaponId: string) => import("./types.js").WeaponQuality | undefined, getAliases: (id: string) => readonly string[], getTags: (id: string) => readonly string[], listOperatorCategories: () => string[], listWeaponCategories: () => string[], listAllOperators: () => import("./types.js").Operator[], listAllWeapons: () => import("./types.js").Weapon[];
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,QAAQ,EAER,MAAM,EACN,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAkC3B;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAY7D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAsBnE;AAsBD,WAAW;AACX,wBAAgB,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAE/D;AAED,WAAW;AACX,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAEhE;AAED,WAAW;AACX,wBAAgB,iBAAiB,IAAI,YAAY,CAEhD;AAED,WAAW;AACX,wBAAgB,iBAAiB,IAAI,YAAY,CAEhD;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAWtE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGzC,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAQ,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAW,gBAAgB,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,eAAO,MAAM,aAAa,EAAE,MAAuB,CAAC;AAEpD,eAAO,MAEL,YAAY,0DACZ,UAAU,wDACV,OAAO,8CACP,YAAY,wCAGZ,iBAAiB,wDACjB,eAAe,iFACf,aAAa,6EACb,cAAc,sFACd,eAAe,sFACf,iBAAiB,sFACjB,iBAAiB,sFACjB,gBAAgB,mFAGhB,gBAAgB,6DAChB,cAAc,2DACd,YAAY,yDACZ,aAAa,kEACb,cAAc,kEACd,gBAAgB,kEAChB,gBAAgB,kEAChB,oBAAoB,sDACpB,iBAAiB,oDACjB,iBAAiB,8DAGjB,gBAAgB,wEAChB,UAAU,qCACV,OAAO,qCAGP,sBAAsB,kBACtB,oBAAoB,kBACpB,gBAAgB,yCAChB,cAAc,qCACC,CAAC"}

package/dist/index.js

@@ -1,133 +1,33 @@
 // =====================================================
 // delta-force-core 主入口
+//
+// 默认引擎 = 官方数据 + 空覆盖层
+// 懒人一行可用：import { getRandomWeapon } from 'delta-force-core'
+// 高级用法：  import { createEngine }   from 'delta-force-core'
 // =====================================================
-import { OPERATORS, WEAPONS, EQUIPMENT } from './data.js';
-// 重新导出数据与类型，方便 `import { OPERATORS } from 'delta-force-core'`
-export * from './data.js';
+import { createEngine } from './engine.js';
+// ---------- 类型 ----------
 export * from './types.js';
-// -----------------------------------------------------
-// 内部工具
-// -----------------------------------------------------
-/** 从数组里随机取一个元素 */
-function pick(list) {
-    if (list.length === 0)
-        throw new Error('[delta-force-core] 待抽取的列表为空');
-    return list[Math.floor(Math.random() * list.length)];
-}
-/** 把分类数组里所有条目拉平 */
-function flatten(groups, key) {
-    return groups.flatMap((g) => g[key]);
-}
-/** 通用 allowNormal 过滤（undefined 表示不过滤） */
-function matchAllowNormal(allowNormal, value) {
-    if (allowNormal === undefined)
-        return true;
-    // 未标注 allowNormal 的默认视为 true（允许普通模式）
-    return (value ?? true) === allowNormal;
-}
-// -----------------------------------------------------
-// 1. 随机干员
-// -----------------------------------------------------
-/**
- * 随机抽取一名干员。
- *
- * @param category 兵种分类（"突击兵" | "支援兵" | "工程兵" | "侦察兵"）。不传则从全部干员中抽取。
- * @throws 当传入的分类不存在或该分类下没有干员时抛错。
- *
- * @example
- *   getRandomOperator();               // 任意干员
- *   getRandomOperator('突击兵');        // 只从突击兵里抽
- */
-export function getRandomOperator(category) {
-    if (!category) {
-        return pick(flatten(OPERATORS, 'operators'));
-    }
-    const group = OPERATORS.find((g) => g.category === category);
-    if (!group) {
-        throw new Error(`[delta-force-core] 未找到兵种分类 "${category}"，可用分类：${OPERATORS.map((g) => g.category).join(' / ')}`);
-    }
-    return pick(group.operators);
-}
-// -----------------------------------------------------
-// 2. 随机武器
-// -----------------------------------------------------
-/**
- * 随机抽取一把武器，支持按武器分类 / 品质 / 普通模式可用性过滤。
- *
- * @example
- *   getRandomWeapon();                                        // 任意武器
- *   getRandomWeapon({ category: '突击步枪' });                 // 只抽突击步枪
- *   getRandomWeapon({ quality: '金色' });                      // 只抽金色
- *   getRandomWeapon({ allowNormal: true });                   // 只抽普通模式可用的
- *   getRandomWeapon({ category: '狙击步枪', quality: '金色' });
- */
-export function getRandomWeapon(options = {}) {
-    const { category, quality, allowNormal } = options;
-    const pool = [];
-    for (const group of WEAPONS) {
-        if (category && group.category !== category)
-            continue;
-        for (const weapon of group.weapons) {
-            if (quality && weapon.quality !== quality)
-                continue;
-            if (!matchAllowNormal(allowNormal, weapon.allowNormal))
-                continue;
-            pool.push(weapon);
-        }
-    }
-    if (pool.length === 0) {
-        throw new Error(`[delta-force-core] 没有符合条件的武器（category=${category ?? '*'}，quality=${quality ?? '*'}，allowNormal=${allowNormal ?? '*'})`);
-    }
-    return pick(pool);
-}
-// -----------------------------------------------------
-// 3. 随机装备（内部 / 也可单独导出）
-// -----------------------------------------------------
-function pickFromTiers(tiers, allowNormal, field = 'items') {
-    // 先按 allowNormal 过滤等级
-    const validTiers = tiers.filter((t) => matchAllowNormal(allowNormal, t.allowNormal));
-    if (validTiers.length === 0) {
-        throw new Error('[delta-force-core] 没有符合条件的装备等级');
-    }
-    // 再把所有条目拉平抽取
-    const pool = validTiers.flatMap((t) => t[field]);
-    return pick(pool);
-}
-/** 随机防具 */
-export function getRandomArmor(allowNormal) {
-    return pickFromTiers(EQUIPMENT.armors, allowNormal);
-}
-/** 随机头盔 */
-export function getRandomHelmet(allowNormal) {
-    return pickFromTiers(EQUIPMENT.helmets, allowNormal);
-}
-/** 随机背包 */
-export function getRandomBackpack() {
-    return pickFromTiers(EQUIPMENT.backpacks);
-}
-/** 随机弹挂 */
-export function getRandomChestRig() {
-    return pickFromTiers(EQUIPMENT.chest_rigs);
-}
-// -----------------------------------------------------
-// 4. 随机完整战术配置
-// -----------------------------------------------------
-/**
- * 随机生成一套完整的战术配置。
- *
- * @example
- *   const loadout = getRandomLoadout();
- *   const normalLoadout = getRandomLoadout({ allowNormal: true });
- */
-export function getRandomLoadout(options = {}) {
-    const { allowNormal } = options;
-    return {
-        operator: getRandomOperator(),
-        weapon: getRandomWeapon({ allowNormal }),
-        armor: getRandomArmor(allowNormal),
-        helmet: getRandomHelmet(allowNormal),
-        backpack: getRandomBackpack(),
-        chestRig: getRandomChestRig(),
-    };
-}
+// ---------- 官方数据（只读） ----------
+export { OPERATORS } from './data/operators.js';
+export { WEAPONS } from './data/weapons.js';
+export { EQUIPMENT } from './data/equipment.js';
+export { AMMO } from './data/ammo.js';
+// ---------- 引擎工厂 ----------
+export { createEngine } from './engine.js';
+// -----------------------------------------------------
+// 默认引擎：官方数据 + 空覆盖层
+// -----------------------------------------------------
+export const defaultEngine = createEngine();
+export const { 
+// 数据视图
+getOperators, getWeapons, getAmmo, getEquipment, 
+// 抽签
+getRandomOperator, getRandomWeapon, getRandomAmmo, getRandomArmor, getRandomHelmet, getRandomBackpack, getRandomChestRig, getRandomLoadout, 
+// 查询
+findOperatorById, findWeaponById, findAmmoById, findArmorById, findHelmetById, findBackpackById, findChestRigById, findWeaponsByCaliber, findAmmoByCaliber, findWeaponByAlias, 
+// 用户层
+getWeaponQuality, getAliases, getTags, 
+// 列表
+listOperatorCategories, listWeaponCategories, listAllOperators, listAllWeapons, } = defaultEngine;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,uBAAuB;AACvB,wDAAwD;AAExD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAa1D,8DAA8D;AAC9D,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAE3B,wDAAwD;AACxD,OAAO;AACP,wDAAwD;AAExD,kBAAkB;AAClB,SAAS,IAAI,CAAI,IAAkB;IACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,mBAAmB;AACnB,SAAS,OAAO,CACd,MAAoB,EACpB,GAAW;IAEX,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,yCAAyC;AACzC,SAAS,gBAAgB,CACvB,WAAgC,EAChC,KAA0B;IAE1B,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3C,qCAAqC;IACrC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,WAAW,CAAC;AACzC,CAAC;AAED,wDAAwD;AACxD,UAAU;AACV,wDAAwD;AAExD;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAiB;IACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,OAAO,CAAmB,SAAS,EAAE,WAAW,CAAe,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,+BAA+B,QAAQ,UAAU,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAChG,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC;AAED,wDAAwD;AACxD,UAAU;AACV,wDAAwD;AAExD;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,UAAyB,EAAE;IACzD,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEnD,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ;YAAE,SAAS;QAEtD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO;gBAAE,SAAS;YACpD,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC;gBAAE,SAAS;YACjE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,yCAAyC,QAAQ,IAAI,GAAG,YAAY,OAAO,IAAI,GAAG,gBAAgB,WAAW,IAAI,GAAG,GAAG,CACxH,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC;AAED,wDAAwD;AACxD,uBAAuB;AACvB,wDAAwD;AAExD,SAAS,aAAa,CACpB,KAAmB,EACnB,WAAqB,EACrB,QAAgB,OAAO;IAEvB,sBAAsB;IACtB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IACrF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,aAAa;IACb,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC;AAED,WAAW;AACX,MAAM,UAAU,cAAc,CAAC,WAAqB;IAClD,OAAO,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACtD,CAAC;AAED,WAAW;AACX,MAAM,UAAU,eAAe,CAAC,WAAqB;IACnD,OAAO,aAAa,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACvD,CAAC;AAED,WAAW;AACX,MAAM,UAAU,iBAAiB;IAC/B,OAAO,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,WAAW;AACX,MAAM,UAAU,iBAAiB;IAC/B,OAAO,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,wDAAwD;AACxD,cAAc;AACd,wDAAwD;AAExD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA0B,EAAE;IAC3D,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEhC,OAAO;QACL,QAAQ,EAAE,iBAAiB,EAAE;QAC7B,MAAM,EAAE,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;QACxC,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC;QAClC,MAAM,EAAE,eAAe,CAAC,WAAW,CAAC;QACpC,QAAQ,EAAE,iBAAiB,EAAE;QAC7B,QAAQ,EAAE,iBAAiB,EAAE;KAC9B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,uBAAuB;AACvB,EAAE;AACF,qBAAqB;AACrB,4DAA4D;AAC5D,2DAA2D;AAC3D,wDAAwD;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,2BAA2B;AAC3B,cAAc,YAAY,CAAC;AAE3B,iCAAiC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAQ,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAW,gBAAgB,CAAC;AAE3C,6BAA6B;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,wDAAwD;AACxD,mBAAmB;AACnB,wDAAwD;AACxD,MAAM,CAAC,MAAM,aAAa,GAAW,YAAY,EAAE,CAAC;AAEpD,MAAM,CAAC,MAAM;AACX,OAAO;AACP,YAAY,EACZ,UAAU,EACV,OAAO,EACP,YAAY;AAEZ,KAAK;AACL,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB;AAEhB,KAAK;AACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB;AAEjB,MAAM;AACN,gBAAgB,EAChB,UAAU,EACV,OAAO;AAEP,KAAK;AACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,GAAG,aAAa,CAAC"}

package/dist/types.d.ts

@@ -1,92 +1,119 @@
-/** 干员 */
+/** 品质 —— 官方数据不提供，由用户层评估 */
+export type WeaponQuality = '绿色' | '蓝色' | '紫色' | '金色';
 export interface Operator {
     id: string;
     name: string;
-    features: string;
+    features?: string;
+    description?: string;
+    image?: string;
 }
-/** 干员分类（如：突击兵 / 支援兵 / 工程兵 / 侦察兵） */
 export interface OperatorCategory {
     category: string;
     operators: Operator[];
 }
-/** 武器 */
 export interface Weapon {
     id: string;
     name: string;
-    /** 品质：绿色 / 蓝色 / 紫色 / 金色 */
-    quality: string;
-    /** 是否允许在普通模式使用 */
-    allowNormal: boolean;
+    caliber?: string;
+    baseDamage?: number;
+    description?: string;
+    image?: string;
+    /** 是否允许在普通模式使用（缺省视为 true） */
+    allowNormal?: boolean;
 }
-/** 武器分类（如：突击步枪 / 冲锋枪 / ...） */
 export interface WeaponCategory {
     category: string;
     weapons: Weapon[];
 }
-/** 防具 / 头盔条目 */
-export interface ArmorItem {
-    id: string;
-    name: string;
-    features?: string;
-    comment?: string;
-}
-/** 防具 / 头盔 等级分组 */
-export interface ArmorTier {
-    tier: number;
-    /** 是否允许在普通模式使用（缺省视为允许） */
-    allowNormal?: boolean;
-    items: ArmorItem[];
-}
-/** 背包条目 */
-export interface BackpackItem {
+export interface Ammo {
     id: string;
     name: string;
-    comment?: string;
-}
-/** 背包等级分组 */
-export interface BackpackTier {
-    tier: number;
-    items: BackpackItem[];
+    /** 口径，如 '5.56x45mm' */
+    caliber: string;
+    description?: string;
+    image?: string;
 }
-/** 弹挂条目 */
-export interface ChestRigItem {
+export interface EquipmentItem {
     id: string;
     name: string;
+    features?: string;
     comment?: string;
+    description?: string;
+    image?: string;
 }
-/** 弹挂等级分组 */
-export interface ChestRigTier {
+export interface EquipmentTier {
     tier: number;
-    items: ChestRigItem[];
+    allowNormal?: boolean;
+    items: EquipmentItem[];
 }
-/** 装备总览 */
 export interface Equipment {
-    armors: ArmorTier[];
-    helmets: ArmorTier[];
-    backpacks: BackpackTier[];
-    chest_rigs: ChestRigTier[];
+    armors: EquipmentTier[];
+    helmets: EquipmentTier[];
+    backpacks: EquipmentTier[];
+    chest_rigs: EquipmentTier[];
 }
-/** 一套完整战术配置 */
 export interface Loadout {
     operator: Operator;
     weapon: Weapon;
-    armor: ArmorItem;
-    helmet: ArmorItem;
-    backpack: BackpackItem;
-    chestRig: ChestRigItem;
+    armor: EquipmentItem;
+    helmet: EquipmentItem;
+    backpack: EquipmentItem;
+    chestRig: EquipmentItem;
+}
+/** 用户偏好覆盖层（全部可选） */
+export interface EngineOptions {
+    /** 用户对武器品质的评估：weaponId → 品质 */
+    qualityOverride?: Record<string, WeaponQuality>;
+    /** 别名：entityId → 别名数组（可用于查询） */
+    aliasOverride?: Record<string, string[]>;
+    /** 个人标签：entityId → 标签数组（纯元数据，不影响抽签） */
+    tagOverride?: Record<string, string[]>;
 }
-/** getRandomWeapon 过滤选项 */
 export interface WeaponOptions {
-    /** 武器大类，如 "突击步枪" */
     category?: string;
-    /** 品质，如 "金色" / "紫色" / "蓝色" / "绿色" */
-    quality?: string;
-    /** true 只返回普通模式可用；false 只返回普通模式不可用；undefined 全部返回 */
+    /** 需要引擎启用了 qualityOverride 才有意义 */
+    quality?: WeaponQuality;
+    allowNormal?: boolean;
+}
+export interface TierOptions {
+    tier?: number;
     allowNormal?: boolean;
 }
-/** getRandomLoadout 选项 */
+export interface AmmoOptions {
+    caliber?: string;
+}
 export interface LoadoutOptions {
-    /** 是否只使用普通模式可用的装备（武器 / 护甲 / 头盔） */
     allowNormal?: boolean;
 }
+export interface Engine {
+    getOperators(): readonly OperatorCategory[];
+    getWeapons(): readonly WeaponCategory[];
+    getAmmo(): readonly Ammo[];
+    getEquipment(): Equipment;
+    getRandomOperator(category?: string): Operator;
+    getRandomWeapon(options?: WeaponOptions): Weapon;
+    getRandomAmmo(options?: AmmoOptions): Ammo;
+    getRandomArmor(options?: TierOptions): EquipmentItem;
+    getRandomHelmet(options?: TierOptions): EquipmentItem;
+    getRandomBackpack(options?: TierOptions): EquipmentItem;
+    getRandomChestRig(options?: TierOptions): EquipmentItem;
+    getRandomLoadout(options?: LoadoutOptions): Loadout;
+    findOperatorById(id: string): Operator | undefined;
+    findWeaponById(id: string): Weapon | undefined;
+    findAmmoById(id: string): Ammo | undefined;
+    findArmorById(id: string): EquipmentItem | undefined;
+    findHelmetById(id: string): EquipmentItem | undefined;
+    findBackpackById(id: string): EquipmentItem | undefined;
+    findChestRigById(id: string): EquipmentItem | undefined;
+    findWeaponsByCaliber(caliber: string): Weapon[];
+    findAmmoByCaliber(caliber: string): Ammo[];
+    findWeaponByAlias(alias: string): Weapon | undefined;
+    getWeaponQuality(weaponId: string): WeaponQuality | undefined;
+    getAliases(id: string): readonly string[];
+    getTags(id: string): readonly string[];
+    listOperatorCategories(): string[];
+    listWeaponCategories(): string[];
+    listAllOperators(): Operator[];
+    listAllWeapons(): Weapon[];
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,SAAS;AACT,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,SAAS;AACT,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,+BAA+B;AAC/B,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mBAAmB;AACnB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,WAAW;AACX,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,eAAe;AACf,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,0BAA0B;AAC1B,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}