@cs2dak/maps 0.2.1 → 1.0.0

package/src/default-positions.ts

@@ -0,0 +1,266 @@
+import { getCalloutTendencies, getPrimaryCalloutRegion, type TacticalRegion } from "./callout-names.js";
+
+export interface DefaultPositionGroup {
+  /** 展示名（社区叫法），如 "A1"。 */
+  name: string;
+  /** 归并到该 group 的原始 callout id 列表。 */
+  callouts: string[];
+}
+
+export interface SideDefaults {
+  /** positionGroupId -> group（有序：决定 basis 展示顺序）。 */
+  groups: Record<string, DefaultPositionGroup>;
+}
+
+export interface MapDefaults {
+  /** T 默认位：按开局默认展开方向划分，一个 group 可覆盖连续且战术含义一致的多个 callout。 */
+  t: SideDefaults;
+  /** CT 默认位：按具体防守站位划分，尽量一个 group 对应一个明确位置。 */
+  ct: SideDefaults;
+}
+
+export type DefaultPositionSide = "t" | "ct";
+
+export interface DefaultPositionGroupMatch extends DefaultPositionGroup {
+  id: string;
+}
+
+export interface TacticalLocation {
+  callout: string | null;
+  tendencies: readonly TacticalRegion[];
+  primaryRegion: TacticalRegion | null;
+  positionGroupId: string | null;
+  isDefaultPosition: boolean;
+}
+
+export const DEFAULT_POSITION_GROUPS: Record<string, MapDefaults> = {
+  de_ancient: {
+    t: {
+      groups: {
+        t_outside: { name: "匪口", callouts: ["Outside"] },
+        a_hall: { name: "A厅", callouts: ["MainHall"] },
+        mid: { name: "中路/跳台", callouts: ["TSideUpper", "Middle"] },
+        b_outer: { name: "B外", callouts: ["Ruins"] },
+        b_short: { name: "B小", callouts: ["TSideLower"] },
+      },
+    },
+    ct: {
+      groups: {
+        a_site: { name: "A包", callouts: ["BombsiteA"] },
+        donut: { name: "甜甜圈", callouts: ["SideHall"] },
+        mid: { name: "中路", callouts: ["Middle"] },
+        b_site: { name: "B包", callouts: ["BombsiteB"] },
+        b_alley: { name: "B底线", callouts: ["Alley"] },
+        vip: { name: "VIP", callouts: ["House"] },
+        black_house: { name: "黑屋", callouts: ["SideEntrance"] },
+      },
+    },
+  },
+  de_anubis: {
+    t: {
+      groups: {
+        b_long: { name: "B外", callouts: ["Ruins", "OutsideLong"] },
+        mid_bridge: { name: "中桥", callouts: ["Bridge"] },
+        street: { name: "匪梯", callouts: ["Street", "TStairs"] },
+        canal: { name: "水下", callouts: ["Canal"] },
+        t_upper: { name: "匪跳", callouts: ["TSideUpper"] },
+      },
+    },
+    ct: {
+      groups: {
+        a_main: { name: "A厅", callouts: ["Main"] },
+        a_site: { name: "A包", callouts: ["BombsiteA"] },
+        a_connector: { name: "A连", callouts: ["Walkway"] },
+        a_heaven: { name: "天堂", callouts: ["Heaven"] },
+        mid: { name: "中路", callouts: ["Middle"] },
+        mid_doors: { name: "中门", callouts: ["MidDoors"] },
+        connector: { name: "黑屋", callouts: ["Connector"] },
+        b_site: { name: "B包", callouts: ["BombsiteB"] },
+        back_b: { name: "B包台上", callouts: ["BackofB"] },
+        b_bricks: { name: "B连阳光房", callouts: ["Bricks"] },
+        b_connector: { name: "B连", callouts: ["PalaceInterior"] },
+      },
+    },
+  },
+  de_dust2: {
+    t: {
+      groups: {
+        a_doors: { name: "A门外/A门", callouts: ["OutsideLong", "LongDoors"] },
+        top_mid: { name: "中远", callouts: ["TopofMid"] },
+        b1: { name: "B1", callouts: ["LowerTunnel"] },
+        b_tunnels: { name: "B洞", callouts: ["OutsideTunnel", "UpperTunnel"] },
+      },
+    },
+    ct: {
+      groups: {
+        a_long: { name: "A大", callouts: ["LongA"] },
+        pit: { name: "大坑", callouts: ["Pit"] },
+        catwalk: { name: "A小", callouts: ["Catwalk", "ShortStairs", "ExtendedA"] },
+        mid_doors: { name: "中门", callouts: ["MidDoors"] },
+        ct_spawn: { name: "警家", callouts: ["CTSpawn", "UnderA"] },
+        b_site: { name: "B包", callouts: ["BombsiteB"] },
+        b_doors: { name: "B门", callouts: ["BDoors"] },
+      },
+    },
+  },
+  de_inferno: {
+    t: {
+      groups: {
+        banana: { name: "香蕉道", callouts: ["Banana"] },
+        t_mid: { name: "匪口/中路", callouts: ["LowerMid", "TRamp", "Middle"] },
+        second_mid: { name: "侧道", callouts: ["SecondMid"] },
+        apartments: { name: "二楼", callouts: ["BackAlley", "Apartments", "Upstairs"] },
+      },
+    },
+    ct: {
+      groups: {
+        a_site: { name: "A包", callouts: ["BombsiteA"] },
+        pit: { name: "大坑", callouts: ["Pit"] },
+        quad: { name: "马棚", callouts: ["Quad"] },
+        arch: { name: "连接/拱门", callouts: ["Arch"] },
+        library: { name: "书房", callouts: ["Library"] },
+        top_mid: { name: "中路", callouts: ["TopofMid"] },
+        apartments: { name: "二楼", callouts: ["Apartments"] },
+        balcony: { name: "阳台", callouts: ["Balcony"] },
+        b_site: { name: "B包", callouts: ["BombsiteB"] },
+        ruins: { name: "教堂/警家", callouts: ["Ruins"] },
+        banana: { name: "香蕉道", callouts: ["Banana"] },
+      },
+    },
+  },
+  de_mirage: {
+    t: {
+      groups: {
+        a_ramp: { name: "A1", callouts: ["PalaceAlley", "TRamp"] },
+        a_palace: { name: "A二楼", callouts: ["PalaceInterior"] },
+        top_mid: { name: "匪口/中远", callouts: ["SideAlley", "TopofMid"] },
+        underpass: { name: "下水道", callouts: ["Underpass"] },
+        b_apps: { name: "B二楼", callouts: ["House", "BackAlley", "Apartments"] },
+      },
+    },
+    ct: {
+      groups: {
+        a_site: { name: "A包", callouts: ["BombsiteA"] },
+        stairs: { name: "跳台", callouts: ["Stairs"] },
+        jungle: { name: "Jungle", callouts: ["Jungle"] },
+        vip: { name: "VIP", callouts: ["SnipersNest"] },
+        connector: { name: "拱门", callouts: ["Connector"] },
+        catwalk: { name: "B小", callouts: ["Catwalk"] },
+        ladder: { name: "黑屋", callouts: ["Ladder"] },
+        b_site: { name: "B包", callouts: ["BombsiteB"] },
+        truck: { name: "白车", callouts: ["Truck"] },
+        market: { name: "超市", callouts: ["Shop"] },
+      },
+    },
+  },
+  de_nuke: {
+    t: {
+      groups: {
+        outside: { name: "外场", callouts: ["Outside", "Roof", "Silo"] },
+        lobby: { name: "匪厅", callouts: ["Lobby", "Squeaky", "Trophy", "Vending"] },
+      },
+    },
+    ct: {
+      groups: {
+        outside: { name: "外场", callouts: ["Outside"] },
+        garage: { name: "大仓", callouts: ["Garage"] },
+        mini: { name: "正门", callouts: ["Mini"] },
+        a_site: { name: "A包", callouts: ["BombsiteA"] },
+        rafters: { name: "三楼横梁", callouts: ["Rafters"] },
+        heaven: { name: "三楼", callouts: ["Heaven"] },
+        hut: { name: "黄房", callouts: ["Hut"] },
+        ramp: { name: "铁板", callouts: ["Ramp"] },
+        admin: { name: "铁板三楼下", callouts: ["Admin"] },
+      },
+    },
+  },
+  de_overpass: {
+    t: {
+      groups: {
+        underpass: { name: "下水道", callouts: ["Tunnels"] },
+        fountain: { name: "喷泉/游乐园", callouts: ["Fountain", "Playground"] },
+        b_long: { name: "B外/长管", callouts: ["Alley", "Canal"] },
+        short_pipe: { name: "短管/工地", callouts: ["Pipe", "Water"] },
+      },
+    },
+    ct: {
+      groups: {
+        restroom: { name: "厕所", callouts: ["Restroom", "UpperPark", "LowerPark"] },
+        a_site: { name: "A包", callouts: ["BombsiteA"] },
+        b_site: { name: "B包", callouts: ["BombsiteB"] },
+        walkway: { name: "ABC", callouts: ["Walkway"] },
+        snipers_nest: { name: "B二楼", callouts: ["SnipersNest"] },
+        water: { name: "工地", callouts: ["Water"] },
+        construction: { name: "B小", callouts: ["Construction"] },
+        connector: { name: "下水道连接", callouts: ["Connector"] },
+      },
+    },
+  },
+};
+
+function sideDefaults(mapName: string, side: DefaultPositionSide): SideDefaults | null {
+  return DEFAULT_POSITION_GROUPS[mapName]?.[side] ?? null;
+}
+
+function calloutInGroups(defaults: SideDefaults | null, callout: string): string | null {
+  if (!defaults) return null;
+  for (const [positionGroupId, group] of Object.entries(defaults.groups)) {
+    if (group.callouts.includes(callout)) return positionGroupId;
+  }
+  return null;
+}
+
+export function positionGroupOf(mapName: string, side: DefaultPositionSide, callout: string): string | null {
+  return calloutInGroups(sideDefaults(mapName, side), callout);
+}
+
+export function getDefaultPositionGroup(
+  mapName: string,
+  side: DefaultPositionSide,
+  callout: string,
+): DefaultPositionGroupMatch | null {
+  const defaults = sideDefaults(mapName, side);
+  const id = calloutInGroups(defaults, callout);
+  if (!defaults || !id) return null;
+  return { id, ...defaults.groups[id] };
+}
+
+export interface PositionGroupDisplay {
+  id: string;
+  displayName: string;
+  officialName: string | null;
+  resolved: boolean;
+}
+
+/** Product-neutral display adapter. Unknown ids stay explicit instead of leaking internal ids as labels. */
+export function positionGroupDisplay(mapName: string, side: DefaultPositionSide, positionGroupId: string): PositionGroupDisplay {
+  const group = sideDefaults(mapName, side)?.groups[positionGroupId];
+  return group
+    ? { id: positionGroupId, displayName: group.name, officialName: group.callouts[0] ?? null, resolved: true }
+    : { id: positionGroupId, displayName: "未映射位置", officialName: null, resolved: false };
+}
+
+/** 只组合 callout 标签与手工默认位置组；推进、争夺、终点等动态语义由 core 时间线推导。 */
+export function classifyTacticalLocation(
+  mapName: string,
+  side: DefaultPositionSide,
+  callout: string | null,
+): TacticalLocation {
+  if (!callout) {
+    return {
+      callout: null,
+      tendencies: [],
+      primaryRegion: null,
+      positionGroupId: null,
+      isDefaultPosition: false,
+    };
+  }
+  const positionGroupId = positionGroupOf(mapName, side, callout);
+  return {
+    callout,
+    tendencies: getCalloutTendencies(mapName, callout) ?? [],
+    primaryRegion: getPrimaryCalloutRegion(mapName, callout),
+    positionGroupId,
+    isDefaultPosition: positionGroupId != null,
+  };
+}

package/src/geometry-assets.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, it } from "vitest";
+import { getMapGeometry, getMapNav } from "./geometry-assets.js";
+import { ACTIVE_DUTY_MAPS } from "./zones.js";
+
+describe("map geometry assets", () => {
+  it("ships compact nav assets for every active duty map", () => {
+    for (const mapName of ACTIVE_DUTY_MAPS) {
+      const nav = getMapNav(mapName);
+      expect(nav?.mapName).toBe(mapName);
+      expect(nav?.areas.length, mapName).toBeGreaterThan(100);
+      expect(nav?.areas.some((area) => area.neighbors.length > 0), mapName).toBe(true);
+    }
+  });
+
+  it("exposes geometry with explicit visibility source status", () => {
+    const geometry = getMapGeometry("de_dust2");
+    expect(geometry?.nav.mapName).toBe("de_dust2");
+    expect(geometry?.sources.nav).toBe("awpy-nav-json");
+    expect(geometry?.sources.visibility).toBe("missing");
+    expect(getMapGeometry("de_cache")).toBeNull();
+  });
+});

package/src/geometry-assets.ts

@@ -0,0 +1,57 @@
+import ancientNav from "../map-nav/de_ancient.nav.json" with { type: "json" };
+import anubisNav from "../map-nav/de_anubis.nav.json" with { type: "json" };
+import dust2Nav from "../map-nav/de_dust2.nav.json" with { type: "json" };
+import infernoNav from "../map-nav/de_inferno.nav.json" with { type: "json" };
+import mirageNav from "../map-nav/de_mirage.nav.json" with { type: "json" };
+import nukeNav from "../map-nav/de_nuke.nav.json" with { type: "json" };
+import overpassNav from "../map-nav/de_overpass.nav.json" with { type: "json" };
+import type { CompactNav } from "./nav.js";
+import type { TriangleBvh } from "./visibility.js";
+import type { ActiveDutyMap } from "./zones.js";
+
+export interface MapGeometry {
+  mapName: string;
+  nav: CompactNav;
+  visibility?: TriangleBvh;
+  sources: {
+    nav: "awpy-nav-json";
+    visibility: "awpy-tri-bvh" | "missing";
+  };
+}
+
+export const MAP_NAV_ASSETS: Record<ActiveDutyMap, CompactNav> = {
+  de_ancient: ancientNav as CompactNav,
+  de_anubis: anubisNav as CompactNav,
+  de_dust2: dust2Nav as CompactNav,
+  de_inferno: infernoNav as CompactNav,
+  de_mirage: mirageNav as CompactNav,
+  de_nuke: nukeNav as CompactNav,
+  de_overpass: overpassNav as CompactNav,
+};
+
+export function getMapNav(mapName: string): CompactNav | null {
+  if (mapName in MAP_NAV_ASSETS) {
+    return MAP_NAV_ASSETS[mapName as ActiveDutyMap];
+  }
+  return null;
+}
+
+/**
+ * 获取指定地图的完整几何资产（nav + visibility）。
+ * visibility 在 .tri 文件可用时自动加载 BVH（Node.js 环境），
+ * 浏览器环境通过 tri-assets 的 dynamic import 降级为 "missing"。
+ */
+export function getMapGeometry(mapName: string, triBvh?: TriangleBvh | null): MapGeometry | null {
+  const nav = getMapNav(mapName);
+  if (!nav) return null;
+  const visibility = triBvh ?? undefined;
+  return {
+    mapName,
+    nav,
+    visibility,
+    sources: {
+      nav: "awpy-nav-json",
+      visibility: visibility ? "awpy-tri-bvh" : "missing",
+    },
+  };
+}

package/src/index.ts

@@ -1,4 +1,32 @@
 export * from "./zones.js";
+export * from "./zone-assets.js";
+export * from "./routes.js";
+export * from "./route-assets.js";
+export * from "./site-entry-chokes.js";
+export * from "./site-entry-lexicon.js";
+export * from "./geometry-assets.js";
+export * from "./nav.js";
+export * from "./visibility.js";
+export * from "./radar-grid.js";
+export * from "./lineups.js";
+export * from "./default-positions.js";
+export * from "./position-candidates.js";
+export {
+  CALLOUT_DICT, CALLOUT_MAPS,
+  calloutBelongsToRegion, calloutCn,
+  getCalloutDefinition, getCalloutTendencies, getPrimaryCalloutRegion,
+  type CalloutNameEntry, type TacticalRegion,
+} from "./callout-names.js";
+export {
+  calloutAt,
+  calloutNear,
+  type CalloutGrid,
+  type CalloutGridCell,
+  type CalloutGridMeta,
+  type CalloutAtResult,
+  type CalloutNearOptions,
+  type CalloutNearResult,
+} from "./callout-grid.js";
 
 export interface MapCalibration {
   mapName: string;
@@ -32,6 +60,19 @@ export function getMapCalibration(mapName: string): MapCalibration | null {
   return MAP_CALIBRATIONS[mapName] ?? null;
 }
 
+export type MapLevel = "upper" | "lower";
+
+/** 该地图是否有上下双层雷达（de_nuke / de_vertigo）。 */
+export function hasLowerLevel(calibration: MapCalibration): boolean {
+  return calibration.lowerLevelMaxUnits != null;
+}
+
+/** 按 z 高度判定实体属于上层还是下层；单层地图恒为 "upper"。 */
+export function levelAt(z: number, calibration: MapCalibration): MapLevel {
+  if (calibration.lowerLevelMaxUnits == null) return "upper";
+  return z < calibration.lowerLevelMaxUnits ? "lower" : "upper";
+}
+
 export function worldToRadar(
   point: { x: number; y: number },
   calibration: MapCalibration

package/src/lineups.test.ts

@@ -0,0 +1,95 @@
+import { describe, expect, it } from "vitest";
+import { buildLineupClusters } from "./lineups.js";
+
+const throwAt = (roundNumber: number, tick: number, x: number, effectX = 500) => ({
+  entryId: "d1",
+  freezeEndTick: 0,
+  roundNumber,
+  grenade: "smoke",
+  throwerIndex: 0,
+  throwTick: tick,
+  throwPosition: { x, y: 0, z: 0 },
+  effectPosition: { x: effectX, y: 0, z: 0 }
+});
+
+describe("buildLineupClusters", () => {
+  it("聚合相近投掷并保留按时间排序的投掷证据", () => {
+    const clusters = buildLineupClusters({
+      mapName: "de_mirage",
+      grenades: [throwAt(3, 3000, 10), throwAt(1, 1000, 0), throwAt(5, 5000, 2000, 3000)],
+      roundWinners: new Map([["d1:1", "teamA"], ["d1:3", "teamB"], ["d1:5", "teamA"]]),
+      throwerTeam: () => "teamA"
+    });
+    expect(clusters).toHaveLength(2);
+    const main = clusters[0]!;
+    expect(main.count).toBe(2);
+    expect(main.roundNumbers).toEqual([1, 3]);
+    expect(main.throws).toEqual([
+      { entryId: "d1", roundNumber: 1, tick: 1000, practicePose: null },
+      { entryId: "d1", roundNumber: 3, tick: 3000, practicePose: null }
+    ]);
+    expect(main.winRatePercent).toBe(50);
+  });
+
+  it("无队伍/胜负信息时胜率为 null", () => {
+    const clusters = buildLineupClusters({ mapName: "de_mirage", grenades: [throwAt(1, 1000, 0)] });
+    expect(clusters[0]!.winRatePercent).toBeNull();
+  });
+
+  it("默认 strict 会区分相同落点但站位偏差大的投掷", () => {
+    const clusters = buildLineupClusters({
+      mapName: "de_mirage",
+      grenades: [
+        throwAt(1, 1000, 0, 500),
+        throwAt(2, 2000, 180, 720)
+      ]
+    });
+
+    expect(clusters).toHaveLength(2);
+  });
+
+  it("loose 只按落点聚合，用于统计大致打哪里", () => {
+    const clusters = buildLineupClusters({
+      mapName: "de_mirage",
+      mode: "loose",
+      grenades: [
+        throwAt(1, 1000, 0, 500),
+        throwAt(2, 2000, 180, 620)
+      ]
+    });
+
+    expect(clusters).toHaveLength(1);
+    expect(clusters[0]!.count).toBe(2);
+  });
+
+  it("保留练习命令所需的玩家站位视角证据", () => {
+    const practicePose = { position: { x: 10, y: 20, z: 30 }, yaw: 90, pitch: -12 };
+    const clusters = buildLineupClusters({
+      mapName: "de_mirage",
+      grenades: [{ ...throwAt(1, 1000, 0, 500), practicePose }]
+    });
+
+    expect(clusters[0]!.throws[0]).toEqual({
+      entryId: "d1",
+      roundNumber: 1,
+      tick: 1000,
+      practicePose
+    });
+  });
+
+  it("聚合 effectPosition 对应的落点 callout", () => {
+    const clusters = buildLineupClusters({
+      mapName: "de_mirage",
+      grenades: [
+        { ...throwAt(1, 1000, 0, 500), effectCallout: "BombsiteA", effectCalloutConfidence: 0.82, effectCalloutSamples: 12 },
+        { ...throwAt(2, 2000, 10, 520), effectCallout: "BombsiteA", effectCalloutConfidence: 0.76, effectCalloutSamples: 8 },
+        { ...throwAt(3, 3000, 20, 540), effectCallout: "Ramp", effectCalloutConfidence: 0.9, effectCalloutSamples: 20 },
+      ]
+    });
+
+    expect(clusters).toHaveLength(1);
+    expect(clusters[0]!.effectCallout).toBe("BombsiteA");
+    expect(clusters[0]!.effectCalloutConfidence).toBeCloseTo(0.79);
+    expect(clusters[0]!.effectCalloutSamples).toBe(20);
+  });
+});