@kar-mi/spirit-vale-tools-combat 3.3.5

package/dist/live-combat.d.ts

@@ -0,0 +1,80 @@
+import type { FishNetActorIdentityEvent } from "./actor-directory.ts";
+import type { FishNetCombatEvent } from "./combat-tracker.ts";
+import type { FishNetDpsEncounterSnapshot } from "./snapshot.ts";
+export interface MeterRow {
+    displayName: string;
+    actorIds: number[];
+    amount: number;
+    rate: number;
+    hits: number;
+    firstAtMs?: number;
+    lastAtMs?: number;
+}
+export interface MeterEncounterSnapshot {
+    id: string;
+    startedAtMs: number;
+    lastEventAtMs: number;
+    endedAtMs?: number;
+    durationMs: number;
+    total: number;
+    rate: number;
+    rows: MeterRow[];
+    /** The same encounter rendered with the detail the DPS snapshot carries: per-skill rows, timeline buckets, crit rates, contribution shares and the personal row. */
+    detail: FishNetDpsEncounterSnapshot;
+}
+export interface CombatEncounterRecord {
+    dps: FishNetDpsEncounterSnapshot;
+    tps: MeterEncounterSnapshot;
+    hps: MeterEncounterSnapshot;
+}
+export interface LiveCombatOptions {
+    /** Decay constant for every meter's current rate. Defaults to 2.5 seconds. */
+    currentTauSeconds?: number;
+    timelinePoints?: number;
+    retainedFinishedEncounters?: number;
+    idleGapMs?: number;
+    minimumDurationMs?: number;
+    /** Names the local player, so every meter can resolve its `personal` row. */
+    personalName?: string;
+    /** Selects the local player by actor id, overriding {@link personalName} when set. */
+    personalActorId?: number;
+    onEncounterFinished?: (encounter: CombatEncounterRecord) => void | Promise<void>;
+}
+export interface LiveCombatState {
+    revision: number;
+    current?: CombatEncounterRecord;
+    latestFinished?: CombatEncounterRecord;
+}
+/** Bounded live combat state for overlays and other polling consumers. */
+export declare class LiveCombatService {
+    private readonly reducer;
+    private readonly currentTauSeconds;
+    private readonly minimumDurationMs;
+    private readonly retainedFinishedEncounters;
+    private readonly onEncounterFinished?;
+    private readonly tanked;
+    private readonly healing;
+    private meterId?;
+    private lastEventAtMs?;
+    /** The finished encounter is retained as aggregates rather than a rendered record, so changing the personal actor re-renders it too. */
+    private latestFinished?;
+    private personalName;
+    private personalActorId?;
+    private revision;
+    constructor(options?: LiveCombatOptions);
+    consumeIdentity(event: FishNetActorIdentityEvent, observedAtMs: number): void;
+    private identityChanged;
+    consumeCombat(event: FishNetCombatEvent, observedAtMs: number): void;
+    setPersonalName(personalName: string): void;
+    setPersonalActorId(personalActorId: number | undefined): void;
+    getPersonalActorId(): number | undefined;
+    /** Advances the idle clock. */
+    advance(observedAtMs: number): void;
+    reset(observedAtMs: number): void;
+    getState(nowMs?: number): LiveCombatState;
+    private ensureMeter;
+    private recordMeterEvent;
+    private finishMeter;
+    private renderRecord;
+}
+//# sourceMappingURL=live-combat.d.ts.map

package/dist/live-combat.d.ts.map

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

package/dist/live-log.d.ts

@@ -0,0 +1,50 @@
+import type { JsonlTailReadResult, LiveLogSessionFollowerOptions } from "@kar-mi/spirit-vale-tools-logging";
+import type { FishNetActorIdentityEvent } from "./actor-directory.ts";
+import type { FishNetCombatEvent } from "./combat-tracker.ts";
+export interface TimedDpsLogEvent {
+    event: FishNetActorIdentityEvent | FishNetCombatEvent;
+    observedAtMs: number;
+}
+export interface DpsLogBatch {
+    events: TimedDpsLogEvent[];
+    invalidLines: number;
+    missing: boolean;
+    reset: boolean;
+    /** Whether this batch carries anything a consumer has to act on. */
+    changed: boolean;
+    /** Bumped once per changed batch, so a consumer can skip re-projecting on an unchanged one. */
+    revision: number;
+    path?: string;
+    sessionId?: string;
+}
+/** Incrementally reads an actively-written combat JSON Lines file. */
+export declare class DpsLogFollower {
+    private readonly ticksPerSecond;
+    private readonly reader;
+    private recordedAtOriginMs?;
+    private lastObservedAtMs;
+    private originTick?;
+    private lastTick?;
+    private revision;
+    constructor(path: string, ticksPerSecond?: number);
+    poll(): Promise<DpsLogBatch>;
+    consumeRead({ missing, reset, lines }: JsonlTailReadResult): DpsLogBatch;
+    private consume;
+    private observedAt;
+    private resetState;
+}
+export type DpsSessionLogFollowerOptions = Pick<LiveLogSessionFollowerOptions<DpsLogFollower, DpsLogBatch>, "fallbackPollMs" | "debounceMs" | "persistent"> & {
+    ticksPerSecond?: number;
+};
+/** Follows whichever combat session is named by the shared current-stream pointer. */
+export declare class DpsSessionLogFollower {
+    private readonly inner;
+    constructor(logDirectory?: string, ticksPerSecond?: number, options?: DpsSessionLogFollowerOptions);
+    /** Follows the stream without polling: the returned follower wakes on a watcher event and yields only batches that carry something. */
+    static watch(logDirectory?: string, options?: DpsSessionLogFollowerOptions): DpsSessionLogFollower;
+    poll(): Promise<DpsLogBatch>;
+    next(): Promise<DpsLogBatch>;
+    [Symbol.asyncIterator](): AsyncIterator<DpsLogBatch>;
+    close(): void;
+}
+//# sourceMappingURL=live-log.d.ts.map

package/dist/live-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-log.d.ts","sourceRoot":"","sources":["../src/live-log.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAC5G,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,yBAAyB,GAAG,kBAAkB,CAAC;IACtD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,+FAA+F;IAC/F,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sEAAsE;AACtE,qBAAa,cAAc;IAQC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAPzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,kBAAkB,CAAC,CAAS;IACpC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAK;IAErB,YAAY,IAAI,EAAE,MAAM,EAAmB,cAAc,SAAK,EAE7D;IAEK,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAEjC;IAED,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,mBAAmB,GAAG,WAAW,CASvE;IAED,OAAO,CAAC,OAAO;IA8Bf,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,UAAU;CAMnB;AAED,MAAM,MAAM,4BAA4B,GACtC,IAAI,CAAC,6BAA6B,CAAC,cAAc,EAAE,WAAW,CAAC,EAAE,gBAAgB,GAAG,YAAY,GAAG,YAAY,CAAC,GAC9G;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhC,sFAAsF;AACtF,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsD;IAE5E,YAAY,YAAY,CAAC,EAAE,MAAM,EAAE,cAAc,SAAK,EAAE,OAAO,GAAE,4BAAiC,EAgBjG;IAED,uIAAuI;IACvI,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,4BAAiC,GAAG,qBAAqB,CAErG;IAED,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAE3B;IAED,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAE3B;IAED,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC,CAEnD;IAED,KAAK,IAAI,IAAI,CAEZ;CACF"}

package/dist/position-tracker.d.ts

@@ -0,0 +1,43 @@
+import type { DecodedFishNetPacket } from "@kar-mi/spirit-vale-tools-capture";
+import type { FishNetActorDirectory } from "./actor-directory.ts";
+export interface FishNetPosition {
+    x: number;
+    y: number;
+    z: number;
+    /** Yaw (radians, about the world up axis) the object was last known to be facing. */
+    heading?: number;
+}
+export interface FishNetPositionEvent {
+    kind: "position";
+    tick: number;
+    objectId: number;
+    position: FishNetPosition;
+    /** Display name of the object's owner, when the actor directory knows one. */
+    displayName?: string;
+    /** True when this object is the local player's, per the identity the caller supplied. */
+    self: boolean;
+}
+export interface FishNetPositionTrackerOptions {
+    /** Names positions. The directory is not driven from here — feed it the same packets. */
+    directory?: FishNetActorDirectory;
+}
+/** Tracks where every observed object is. */
+export declare class FishNetPositionTracker {
+    private readonly options;
+    private readonly positions;
+    private localObjectId?;
+    constructor(options?: FishNetPositionTrackerOptions);
+    /** Marks which object is the local player's, as decided by the caller's existing identity source. */
+    setLocalObjectId(objectId: number | undefined): void;
+    /** Last known position of the local player's object, when one has been established. */
+    self(): FishNetPosition | undefined;
+    get(objectId: number): FishNetPosition | undefined;
+    snapshot(): Array<{
+        objectId: number;
+        position: FishNetPosition;
+    }>;
+    reset(): void;
+    consume(packet: DecodedFishNetPacket): FishNetPositionEvent[];
+    private event;
+}
+//# sourceMappingURL=position-tracker.d.ts.map

package/dist/position-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-tracker.d.ts","sourceRoot":"","sources":["../src/position-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,eAAe,CAAC;IAC1B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,6BAA6B;IAC5C,yFAAyF;IACzF,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACnC;AAED,6CAA6C;AAC7C,qBAAa,sBAAsB;IAIrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,aAAa,CAAC,CAAS;IAE/B,YAA6B,OAAO,GAAE,6BAAkC,EAAI;IAE5E,qGAAqG;IACrG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEnD;IAED,uFAAuF;IACvF,IAAI,IAAI,eAAe,GAAG,SAAS,CAElC;IAED,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEjD;IAED,QAAQ,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,eAAe,CAAA;KAAE,CAAC,CAEjE;IAED,KAAK,IAAI,IAAI,CAGZ;IAED,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,CAkC5D;IAED,OAAO,CAAC,KAAK;CAWd"}

package/dist/reducers/damage.d.ts

@@ -0,0 +1,168 @@
+import { EwmaRate } from "@kar-mi/spirit-vale-tools-metrics";
+import type { FishNetActorIdentityEvent } from "../actor-directory.ts";
+import type { FishNetCombatDamageEvent, FishNetCombatDeathEvent, FishNetCombatEvent } from "../combat-tracker.ts";
+import type { BucketSeries } from "./timeline.ts";
+export declare const DEFAULT_MINIMUM_DURATION_MS = 1000;
+/** Current DPS is an exponentially-weighted rate rather than a flat window of recent hits. */
+export declare const DEFAULT_CURRENT_TAU_SECONDS = 2.5;
+export interface CombatIdentity {
+    displayName: string;
+    archetype?: number;
+    ownerConnectionId?: number;
+    uid?: string;
+}
+export interface SkillAggregate {
+    sourceId: string;
+    sourceLabel: string;
+    damage: number;
+    hits: number;
+    criticalHits: number;
+}
+/** Per-actor totals for one encounter. */
+export interface ActorAggregate {
+    actorId: number;
+    actorIds: number[];
+    displayName?: string;
+    archetype?: number;
+    ownerConnectionId?: number;
+    uid?: string;
+    activeIdentity: boolean;
+    damage: number;
+    firstDamageAtMs?: number;
+    lastDamageAtMs?: number;
+    hits: number;
+    criticalHits: number;
+    kills: number;
+    targetIds: Set<number>;
+    targetDamage: Map<number, number>;
+    /** Enemy target id -> skill id -> outgoing damage attributed to this actor lifetime. */
+    enemySkills: Map<number, Map<string, EnemySkillStats>>;
+    skills: Map<string, SkillAggregate>;
+    encounterSeries: BucketSeries;
+    actorSeries: BucketSeries;
+    /** Exponentially-weighted recent rate behind `currentDps`. Two numbers, whatever the encounter length. */
+    currentRate: EwmaRate;
+}
+export interface EnemySkillStats {
+    sourceLabel: string;
+    damage: number;
+    hits: number;
+    criticalHits: number;
+}
+export interface DeathHitRecord {
+    /** Milliseconds before the death; zero is the lethal hit. */
+    beforeDeathMs: number;
+    attackerActorId: number;
+    attackerLabel: string;
+    attackerIsMonster: boolean;
+    sourceLabel: string;
+    damage: number;
+    critical: boolean;
+}
+export interface DeathRecord {
+    victimName: string;
+    targetId: number;
+    diedAtMs: number;
+    totalDamage: number;
+    hits: DeathHitRecord[];
+}
+export interface EncounterAggregate {
+    id: string;
+    startedAtMs: number;
+    lastDamageAtMs: number;
+    endedAtMs?: number;
+    actors: ActorAggregate[];
+    activeActors: Map<number, ActorAggregate>;
+    /** First time each enemy was hit, which orders the enemy picker. */
+    enemyFirstSeenAtMs: Map<number, number>;
+    /** Enemy display names, captured when the hit lands rather than looked up when the encounter is written. */
+    enemyNames: Map<number, string>;
+    deaths: DeathRecord[];
+}
+export interface DamageReducerOptions {
+    idleGapMs?: number;
+    /** Decay constant for `currentDps`. Defaults to {@link DEFAULT_CURRENT_TAU_SECONDS}. */
+    currentTauSeconds?: number;
+    /** Caps buckets per series; the read model leaves this unbounded to keep full resolution. */
+    maxTimelineBuckets?: number;
+    /** Supplies the encounter id when one begins. Defaults to a sequential counter. */
+    createEncounterId?: (startedAtMs: number) => string;
+    onEncounterFinished?: (encounter: EncounterAggregate) => void;
+}
+/** Windows combat events into encounters and accumulates per-actor totals. */
+/** Marks an activation record the capture coordinator uses to publish a monster's display name. */
+export declare const MOB_IDENTITY_PREFIX = "__spiritvaleMobIdentity:";
+export declare class DamageReducer {
+    readonly identities: Map<number, CombatIdentity>;
+    readonly mobIdentities: Map<number, string>;
+    current?: EncounterAggregate;
+    /** Recent positive hits per target, trimmed to the death lookback. */
+    readonly recentHits: Map<number, {
+        atMs: number;
+        hit: DeathHitRecord;
+    }[]>;
+    private lastSweepAtMs?;
+    private readonly idleGapMs;
+    private readonly currentTauSeconds;
+    private readonly maxTimelineBuckets;
+    private readonly createEncounterId;
+    private readonly onEncounterFinished?;
+    private nextEncounter;
+    constructor(options?: DamageReducerOptions);
+    /** Adopts an encounter left open by an earlier indexing pass. */
+    resume(encounter: EncounterAggregate): void;
+    consumeIdentity(event: FishNetActorIdentityEvent, _observedAtMs: number): void;
+    consumeCombat(event: FishNetCombatEvent, observedAtMs: number): void;
+    /** Finalizes an encounter that has been idle long enough. */
+    advance(observedAtMs: number): void;
+    /** Finalizes the current encounter; the next qualifying hit starts a new one. */
+    reset(observedAtMs: number): void;
+    private finish;
+    /** Keeps the rolling window of recent positive hits per target that the death log draws from. */
+    private trackRecentHit;
+    /**
+     * Trims every target to the lookback immediately, regardless of when the last sweep ran.
+     *
+     * Used before persisting the map: the periodic sweep leaves up to two windows in memory, but only
+     * one is ever read back, and the persisted copy is rewritten on every batch.
+     */
+    pruneRecentHits(observedAtMs: number): void;
+    /**
+     * Drops targets whose hits have all aged out.
+     *
+     * {@link trackRecentHit} only trims the target it is currently touching, so a target hit once and
+     * never again would otherwise be retained for the rest of the session. Runs at most once per
+     * lookback window of log time, which makes it a rare pass over a map that stays small.
+     */
+    private sweepRecentHits;
+    /** Records a player's identity, evicting the least recently seen once the cap is reached. */
+    private rememberIdentity;
+    /** Records a monster's display name, evicting the least recently seen once the cap is reached. */
+    private rememberMobIdentity;
+    /** Attributes a hit to the open encounter's enemy breakdown and, on death, its log. */
+    private recordEncounterHit;
+    private actorFor;
+}
+/** One positive hit's contribution to a row, shared by the damage reducer and the tanked/healing meters. */
+export interface RecordedHit {
+    value: number;
+    atMs: number;
+    critical: boolean;
+    sourceId: string;
+    sourceLabel: string;
+}
+/**
+ * Folds one hit into an actor's totals, both bucket series, its current-rate estimator and its
+ * per-skill row. Target attribution stays with the caller: the damage reducer counts enemies it can
+ * distinguish from party members, while the meters count their hit's counterpart unconditionally.
+ */
+export declare function recordHit(actor: ActorAggregate, hit: RecordedHit, maxTimelineBuckets: number): void;
+/** Rejected at construction rather than when the first actor is created, so a bad value fails fast. */
+export declare function positiveTau(value: number): number;
+export declare function createActor(actorId: number, encounterStartedAtMs: number, currentRate?: number | EwmaRate): ActorAggregate;
+/**
+ * The enemy breakdown and death log count a wider set than the DPS aggregation: any positive hit,
+ * regardless of team or self-targeting, minus deaths that merely restate a damage event.
+ */
+export declare function isPositiveHit(event: FishNetCombatDamageEvent | FishNetCombatDeathEvent): boolean;
+//# sourceMappingURL=damage.d.ts.map

package/dist/reducers/damage.d.ts.map

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

package/dist/reducers/meter.d.ts

@@ -0,0 +1,29 @@
+import type { FishNetActorIdentityEvent } from "../actor-directory.ts";
+import type { FishNetCombatEvent } from "../combat-tracker.ts";
+import type { CombatIdentity, EncounterAggregate } from "./damage.ts";
+/** Which side of an encounter a meter measures. */
+export type MeterKind = "tanked" | "healing";
+export interface MeterReducerOptions {
+    kind: MeterKind;
+    /** Decay constant for the meter's current rate. Defaults to {@link DEFAULT_CURRENT_TAU_SECONDS}. */
+    currentTauSeconds?: number;
+    maxTimelineBuckets?: number;
+}
+export declare class MeterReducer {
+    readonly kind: MeterKind;
+    current?: EncounterAggregate;
+    private readonly currentTauSeconds;
+    private readonly maxTimelineBuckets;
+    constructor(options: MeterReducerOptions);
+    /** Starts the meter's own aggregate for an encounter the damage reducer has opened. */
+    begin(id: string, startedAtMs: number): EncounterAggregate;
+    /** Adopts an aggregate left open by an earlier indexing pass. */
+    resume(encounter: EncounterAggregate): void;
+    finish(endedAtMs: number): EncounterAggregate | undefined;
+    reset(): void;
+    /** Keeps a display name current on a row that is already accumulating. */
+    consumeIdentity(event: FishNetActorIdentityEvent): void;
+    consumeCombat(event: FishNetCombatEvent, observedAtMs: number, identities: ReadonlyMap<number, CombatIdentity>): void;
+    private apply;
+}
+//# sourceMappingURL=meter.d.ts.map

package/dist/reducers/meter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter.d.ts","sourceRoot":"","sources":["../../src/reducers/meter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtE,mDAAmD;AACnD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,oGAAoG;IACpG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAE5C,YAAY,OAAO,EAAE,mBAAmB,EAIvC;IAED,uFAAuF;IACvF,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAYzD;IAED,iEAAiE;IACjE,MAAM,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAE1C;IAED,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAMxD;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,0EAA0E;IAC1E,eAAe,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAOtD;IAED,aAAa,CACX,KAAK,EAAE,kBAAkB,EACzB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,GAC9C,IAAI,CAKN;IAED,OAAO,CAAC,KAAK;CAoBd"}

package/dist/reducers/rows.d.ts

@@ -0,0 +1,37 @@
+import type { FishNetDpsEncounterSnapshot } from "../snapshot.ts";
+import type { ActorAggregate, EncounterAggregate } from "./damage.ts";
+export interface RenderOptions {
+    nowMs?: number;
+    minimumDurationMs?: number;
+    anonymousIdentityGraceMs?: number;
+    personalName?: string;
+    personalActorId?: number;
+}
+/** Renders an aggregate into an encounter snapshot. */
+export declare function renderEncounter(encounter: EncounterAggregate, options?: RenderOptions): FishNetDpsEncounterSnapshot;
+export interface DisplayActorAggregate {
+    rowId: string;
+    actor: ActorAggregate;
+}
+export interface DisplayActorOptions {
+    snapshotNowMs?: number;
+    anonymousIdentityGraceMs?: number;
+    personalActorId?: number;
+    /**
+     * Keeps every anonymous actor regardless of the grace period. The grace period stops a row
+     * flickering into the live meter before its identity arrives, which is a rendering concern; a
+     * caller reading totals wants the damage either way.
+     */
+    includeAllAnonymous?: boolean;
+}
+/** Applies the same identity merging and row visibility used by the rendered encounter. */
+export declare function displayActorAggregates(encounter: EncounterAggregate, options?: DisplayActorOptions): DisplayActorAggregate[];
+export declare function actorRowId(actor: ActorAggregate): string;
+/**
+ * The single identity key for a display name. NFC folds the two Unicode spellings of the same
+ * text onto one key - Hangul in particular arrives both precomposed and as conjoining jamo,
+ * which render identically but compare unequal and would otherwise split one player into two
+ * rows. `toLowerCase` rather than `toLocaleLowerCase` keeps the key independent of host locale.
+ */
+export declare function normalizeName(name: string): string;
+//# sourceMappingURL=rows.d.ts.map

package/dist/reducers/rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../src/reducers/rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,2BAA2B,EAA4C,MAAM,gBAAgB,CAAC;AAEhI,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAmB,MAAM,aAAa,CAAC;AAGvF,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,uDAAuD;AACvD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,kBAAkB,EAC7B,OAAO,GAAE,aAAkB,GAC1B,2BAA2B,CAoF7B;AAiDD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,2FAA2F;AAC3F,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,kBAAkB,EAC7B,OAAO,GAAE,mBAAwB,GAChC,qBAAqB,EAAE,CAEzB;AAsBD,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAMxD;AA0GD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/reducers/timeline.d.ts

@@ -0,0 +1,29 @@
+/** Width the legacy meter used for analysis buckets; the read model stores this resolution. */
+export declare const ANALYSIS_BUCKET_MS = 5000;
+export interface TimelinePoint {
+    /** Milliseconds elapsed since the series origin. */
+    elapsedMs: number;
+    /** Damage recorded during this time bucket. */
+    damage: number;
+    /** Damage recorded from the origin through this time bucket. */
+    cumulativeDamage: number;
+    /** Damage per second for this time bucket. */
+    dps: number;
+}
+/** Damage accumulated into fixed-width buckets as events arrive, instead of a per-hit array that is re-bucketed on every read. */
+export interface BucketSeries {
+    originMs: number;
+    widthMs: number;
+    buckets: number[];
+    /** Lowest bucket index changed since the last {@link takeDirtyFrom}, or `Infinity` when none is. */
+    dirtyFrom: number;
+}
+export declare function createSeries(originMs: number, widthMs?: number): BucketSeries;
+/** Claims the dirty range and marks the series clean, returning the lowest index a writer must persist from. */
+export declare function takeDirtyFrom(series: BucketSeries): number;
+export declare function addToSeries(series: BucketSeries, atMs: number, damage: number, maxBuckets?: number): void;
+/** Element-wise sum of two series that share an origin and width, e.g. when merging actor rows. */
+export declare function addSeries(target: BucketSeries, source: BucketSeries): void;
+/** Renders the series over `durationMs`: a leading zero point, then one point per bucket, padded with zeroes to cover the full duration. */
+export declare function seriesPoints(series: BucketSeries, durationMs: number): TimelinePoint[];
+//# sourceMappingURL=timeline.d.ts.map

package/dist/reducers/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/reducers/timeline.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,kIAAkI;AAClI,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oGAAoG;IACpG,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAqB,GAAG,YAAY,CAEzF;AAED,gHAAgH;AAChH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAI1D;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,SAA2B,GACpC,IAAI,CAUN;AAcD,mGAAmG;AACnG,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAa1E;AAED,4IAA4I;AAC5I,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CAiBtF"}

package/dist/replay-capture.d.ts

@@ -0,0 +1,24 @@
+import { FishNetActorDirectory } from "./actor-directory.ts";
+import type { FishNetActorIdentityEvent } from "./actor-directory.ts";
+import { FishNetCombatTracker } from "./combat-tracker.ts";
+import type { FishNetCombatEvent } from "./combat-tracker.ts";
+export interface CombatCaptureReplayOptions {
+    tracker: FishNetCombatTracker;
+    directory: FishNetActorDirectory;
+    /** Receives every decoded event in wire order, so a caller can drive reducers as it replays. */
+    onEvent?: (event: FishNetActorIdentityEvent | FishNetCombatEvent, observedAtMs: number) => void;
+}
+export interface CombatCaptureReplayResult {
+    datagrams: number;
+    combatEvents: number;
+    identityEvents: number;
+    invalidLines: number;
+    decodeWarnings: number;
+}
+/** Replays structured transport records without retaining endpoint metadata. */
+export declare function decodeCombatCaptureJsonLines(text: string, options: CombatCaptureReplayOptions): CombatCaptureReplayResult;
+/** Re-runs a raw packet capture through the combat trackers. */
+export declare function replayCombatCapture(path: string, options: CombatCaptureReplayOptions): Promise<CombatCaptureReplayResult>;
+/** Replays ordered capture-file splits through one FishNet decoder and one identity lifetime. */
+export declare function replayCombatCaptures(paths: readonly string[], options: CombatCaptureReplayOptions): Promise<CombatCaptureReplayResult>;
+//# sourceMappingURL=replay-capture.d.ts.map

package/dist/replay-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-capture.d.ts","sourceRoot":"","sources":["../src/replay-capture.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,qBAAqB,CAAC;IACjC,gGAAgG;IAChG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,GAAG,kBAAkB,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CACjG;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,gFAAgF;AAChF,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CAI3B;AAED,gEAAgE;AAChE,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAEpC;AAED,iGAAiG;AACjG,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAMpC"}

package/dist/replay-summary.d.ts

@@ -0,0 +1,14 @@
+export interface CombatReplaySummary {
+    encounters: number;
+    totalDamage: number;
+    durationMs: number;
+    invalidLines: number;
+}
+export interface CombatReplayInspection {
+    recordCount: number;
+    summary: string;
+}
+export declare function readCombatReplaySummary(path: string): Promise<CombatReplaySummary>;
+export declare function formatCombatReplaySummary(path: string): Promise<string>;
+export declare function inspectCombatReplaySummary(path: string): Promise<CombatReplayInspection>;
+//# sourceMappingURL=replay-summary.d.ts.map

package/dist/replay-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-summary.d.ts","sourceRoot":"","sources":["../src/replay-summary.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CASxF;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7E;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAG9F"}

package/dist/replay.d.ts

@@ -0,0 +1,11 @@
+import type { FishNetActorIdentityEvent } from "./actor-directory.ts";
+import type { FishNetCombatEvent } from "./combat-tracker.ts";
+import type { FishNetDpsEncounterSnapshot } from "./snapshot.ts";
+export interface DpsReplayResult {
+    snapshots: FishNetDpsEncounterSnapshot[];
+    invalidLines: number;
+}
+/** Loads combat JSON Lines without retaining raw records or file contents. */
+export declare function loadDpsReplay(path: string, personalName?: string): Promise<DpsReplayResult>;
+export declare function parseDpsLogRecord(type: string, data: Record<string, unknown>): FishNetActorIdentityEvent | FishNetCombatEvent | undefined | null;
+//# sourceMappingURL=replay.d.ts.map

package/dist/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI9D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAGjE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,8EAA8E;AAC9E,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,SAAK,GAAG,OAAO,CAAC,eAAe,CAAC,CAuC7F;AAwFD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,yBAAyB,GAAG,kBAAkB,GAAG,SAAS,GAAG,IAAI,CAOnE"}

package/dist/snapshot.d.ts

@@ -0,0 +1,67 @@
+/** The rendered shape of one encounter, shared by every producer of it: the live service, the history read model, and a whole-log replay. */
+export interface FishNetDpsSkillRow {
+    sourceId: string;
+    sourceLabel: string;
+    damage: number;
+    dps: number;
+    contribution: number;
+    hits: number;
+    criticalHits: number;
+    /** Critical hits as a fraction of total hits, when the skill has hit. */
+    critRate?: number;
+}
+export interface FishNetDpsTimelinePoint {
+    /** Milliseconds elapsed since the encounter began. */
+    elapsedMs: number;
+    /** Damage dealt during this time bucket. */
+    damage: number;
+    /** Damage dealt from encounter start through this time bucket. */
+    cumulativeDamage: number;
+    /** Damage per second for this time bucket. */
+    dps: number;
+}
+export interface FishNetDpsActorRow {
+    /** Stable identity for this rendered row, including merged and unidentified rows. */
+    rowId: string;
+    actorIds: number[];
+    displayName: string;
+    archetype?: number;
+    /** Milliseconds used as the DPS divisor and timeline span for this row. */
+    durationMs?: number;
+    /** Timestamp of this actor's most recent positive damage in the encounter. */
+    lastDamageAtMs?: number;
+    damage: number;
+    dps: number;
+    /** Recent damage per second: an exponentially-weighted rate, not a flat window of the last few seconds. */
+    currentDps: number;
+    contribution: number;
+    hits: number;
+    criticalHits: number;
+    /** Critical hits as a fraction of total hits, when the actor has hit. */
+    critRate?: number;
+    kills: number;
+    /** Number of distinct enemy object IDs damaged by this actor during the encounter. */
+    mobsHit: number;
+    skills: FishNetDpsSkillRow[];
+    timeline: FishNetDpsTimelinePoint[];
+    /** True when the row contains damage that has not been verified to a player identity. */
+    isUnidentified?: boolean;
+}
+export type FishNetPersonalMatch = "unconfigured" | "missing" | "matched" | "ambiguous";
+export interface FishNetDpsEncounterSnapshot {
+    id: string;
+    startedAtMs: number;
+    lastDamageAtMs: number;
+    endedAtMs?: number;
+    durationMs: number;
+    totalDamage: number;
+    partyDps: number;
+    partyCurrentDps: number;
+    actors: FishNetDpsActorRow[];
+    /** Actor ids on rows with no verified player identity. Each such actor keeps its own row. */
+    unidentifiedActorIds: number[];
+    personalName: string;
+    personalMatch: FishNetPersonalMatch;
+    personal?: FishNetDpsActorRow;
+}
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA,6IAA6I;AAC7I,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,2GAA2G;IAC3G,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IACpC,yFAAyF;IACzF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAExF,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,6FAA6F;IAC7F,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B"}