ark-stronghold-protocol/server/sim/content/support/meta.js

// server/sim/content/support/meta.js — prep-side helpers shared by content wave B (docs/META.md registry API).
//
// registerSupportMeta(registry) is called once from bonds.js → registerMeta. It installs
//   global:contentb_info   onBattleStart: writes `ev.input.contentInfo` (read in battles with support.contentInfo()):
//     { round, kind, shopLevel, funds,
//       handUnits  pieces in the 整备区 (hand, 10 slots; operators, items and summon stacks),
//       handChess  operators in the hand,
//       roundStats { refreshes, buys, sells, spent, gainedChess, arts }   (this round's prep, ps.round),
//       matchBands band ids of every alive player (this player first), plus a retained Touch team grant,
//       teammates  [{ playerId, bandId }] of the other alive players }
// Global handlers run first in every dispatch, so band / bond / garrison / item handlers of the same onBattleStart can
// read or extend `ev.input.contentInfo`.
//
// Meta helpers (pure functions of a handler ctx):
//   metaBonds(ctx, pieceView)   bonds of a piece incl. 变形同构体 grants
//   distinctTiers(ctx, pred)    distinct chess tiers on the board among pieces matching pred
//   frontPiece / behindPiece    board neighbours ("身前一格" = one step along the piece's direction `dir`, default
//                               RIGHT = col + 1; board piece views carry `dir`, sim/dir.js)

import { frontOf } from '../../dir.js';

export function registerSupportMeta(registry) {
  registry.global('contentb_info', {
    onBattleStart(ctx, ev) {
      if (!ev || !ev.input || typeof ev.input !== 'object') return;
      const hand = ctx.hand();
      const rs = ctx.roundStats();
      const mates = ctx.teammates();
      const matchBands = [ctx.bandId(), ...mates.map(t => t.bandId())].filter(Boolean);
      // [ASSUMED] 外勤医疗 is a team grant for this match, not an aura revoked when its holder is eliminated.
      // Other team strategies and the teammate contexts still require a living player.
      if (ctx.teamMedicGranted?.() && !matchBands.includes('band_amedic')) matchBands.push('band_amedic');
      ev.input.contentInfo = {
        round: ctx.round,
        kind: ev.kind ?? null,
        shopLevel: ctx.shopLevel(),
        funds: ctx.funds(),
        handUnits: hand.filter(Boolean).length,
        handChess: hand.filter((p) => p && p.kind === 'chess').length,
        roundStats: {
          refreshes: rs.refreshes | 0, buys: rs.buys | 0, sells: rs.sells | 0, spent: rs.spent | 0,
          gainedChess: rs.gainedChess | 0, arts: rs.arts | 0,
        },
        matchBands,
        teammates: mates.map((t) => ({ playerId: t.playerId, bandId: t.bandId() })),
      };
    },
  });
}

/** Bonds of a piece view (own + 变形同构体 grants), as the match counts them. */
export function metaBonds(ctx, piece) {
  if (!piece || piece.kind !== 'chess') return [];
  const fresh = Number.isInteger(piece.uid) && piece.uid > 0 ? ctx.piece(piece.uid) : null;
  const p = fresh && fresh.kind === 'chess' ? fresh : piece;
  const rec = ctx.chessRecord(p.id);
  return withGrants(ctx, p, rec && Array.isArray(rec.bonds) ? rec.bonds.slice() : []);
}

function withGrants(ctx, piece, bonds) {
  const items = Array.isArray(piece.items) ? piece.items : [];
  if (items.length < 2) return bonds;
  const recs = items.map((it) => ctx.gd.item(it.id)).filter(Boolean);
  if (!recs.some((r) => r.canGiveBond)) return bonds;
  const out = bonds.slice();
  for (const r of recs) if (!r.canGiveBond && typeof r.giveBondId === 'string' && ctx.gd.bond(r.giveBondId) && !out.includes(r.giveBondId)) out.push(r.giveBondId);
  return out;
}

/** Distinct tiers of board chess matching `pred(pieceView)`. */
export function distinctTiers(ctx, pred = () => true) {
  const tiers = new Set();
  for (const p of ctx.board()) if (p && p.kind === 'chess' && pred(p)) tiers.add(p.tier ?? ctx.gd.tierOf(p.id));
  return tiers;
}

/** Board piece at (row, col) or null. */
export function boardPieceAt(ctx, row, col) {
  for (const p of ctx.board()) if (p.row === row && p.col === col) return p;
  return null;
}
/** Board piece `k` tiles in front of a board piece, along its direction (`p.dir`, default RIGHT: col + k). */
export const frontPiece = (ctx, p, k = 1) => {
  if (!p || !Number.isInteger(p.row) || !Number.isInteger(p.col)) return null;
  const [r, c] = frontOf(p.row, p.col, p.dir, k);
  return boardPieceAt(ctx, r, c);
};
export const behindPiece = (ctx, p, k = 1) => frontPiece(ctx, p, -k);