sganggs
1f29b8a3d0
The band -> bond derivation moves out of GameData into shared/bandBonds.js, which tools/build-data.mjs runs per band to write bands.json bondIds (regenerated with --offline; 9 bands are tied, the build checks the ids). GameData.bandBondIds reads the field, so the server and the client share one source. DATA.md documents the field; the test checks the helper on synthetic bands and that the data matches it.
48 lines
2.8 KiB
JavaScript
48 lines
2.8 KiB
JavaScript
// shared/bandBonds.js — the bonds a strategy (band) is built around, read from the band's own data (DESIGN §21.26).
|
|
// Pure (no Node APIs). tools/build-data.mjs runs it once per band and writes the result as data/bands.json `bondIds` —
|
|
// the one field both sides read: the server (match/gamedata.js GameData.bandBondIds → bot.js botPickBand never takes a
|
|
// band whose bond the mode switches off) and the client (screens/bandDraft.js marks such a band 本局禁用, gameLogic
|
|
// bandOffBonds). A band is tied to:
|
|
// * the bonds its text names in <…> — the official note "在<X>部分干员缺席时体验可能不完整" names that bond too; a
|
|
// bracketed name that is no bond (<寻呼模块>, <画卷>, <鸭爵> …) adds nothing;
|
|
// * the bond ids and bond pools its effect's blackboards name (bb / bbStr string values, comma lists included):
|
|
// 克莱门莎's `bond_id` egirShip, 玛恩纳's `bond` kazimierzShip, 潘格尼尼's `pool` pool_char_later → choices.json
|
|
// `pools[pool].bond` lateranoShip; a pool without a bond adds nothing.
|
|
|
|
const isObj = (v) => !!v && typeof v === 'object';
|
|
|
|
/**
|
|
* Bond ids a band is tied to, in the order of `bonds`.
|
|
* @param {{ desc?: string, buffs?: Array<{ bb?: object, bbStr?: object }> }|null|undefined} band bands.json record
|
|
* @param {{ bonds: Record<string, { name?: string }>|Array<{ bondId: string, name?: string }>,
|
|
* pools?: Record<string, { bond?: string }>|null }} ctx bonds.json (map or list) and choices.json `pools`
|
|
* @returns {string[]}
|
|
*/
|
|
export function bandBondIds(band, { bonds, pools = null } = {}) {
|
|
const list = Array.isArray(bonds) ? bonds.filter(isObj).map((b) => [b.bondId, b]) : Object.entries(isObj(bonds) ? bonds : {});
|
|
const ids = list.map(([id]) => id).filter((id) => typeof id === 'string');
|
|
if (!isObj(band) || !ids.length) return [];
|
|
const known = new Set(ids);
|
|
const byName = new Map(list.filter(([, b]) => isObj(b) && typeof b.name === 'string').map(([id, b]) => [b.name, id]));
|
|
const found = new Set();
|
|
for (const [, name] of String(band.desc || '').matchAll(/<([^<>]+)>/g)) {
|
|
const id = byName.get(name.trim());
|
|
if (id) found.add(id);
|
|
}
|
|
const poolOf = (k) => (isObj(pools) && Object.hasOwn(pools, k) && isObj(pools[k]) ? pools[k] : null);
|
|
for (const buff of Array.isArray(band.buffs) ? band.buffs : []) {
|
|
for (const board of [buff && buff.bb, buff && buff.bbStr]) {
|
|
if (!isObj(board)) continue;
|
|
for (const v of Object.values(board)) {
|
|
if (typeof v !== 'string') continue;
|
|
for (const part of v.split(',').map((s) => s.trim())) {
|
|
if (known.has(part)) found.add(part);
|
|
const pool = poolOf(part);
|
|
if (pool && typeof pool.bond === 'string' && known.has(pool.bond)) found.add(pool.bond);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return ids.filter((id) => found.has(id));
|
|
}
|