@kar-mi/spirit-vale-tools-character 0.5.0

package/README.md

@@ -0,0 +1,28 @@
+# @kar-mi/spirit-vale-tools-character
+
+Spirit Vale character decoding and stat calculation utilities.
+
+## Install
+
+```sh
+bun add @kar-mi/spirit-vale-tools-character
+```
+
+## Usage
+
+```ts
+import { FishNetCharacterTracker, calculateCharacterStats } from "@kar-mi/spirit-vale-tools-character";
+
+const tracker = new FishNetCharacterTracker();
+tracker.subscribe((state) => console.log(state));
+
+// packet: CapturedFishNetPacket from @kar-mi/spirit-vale-tools-capture
+tracker.consume(packet);
+
+const stats = calculateCharacterStats(42, { STR: 30, VIT: 25, AGI: 20, DEX: 18, INT: 5, LUK: 12 });
+for (const stat of stats) {
+  console.log(stat.label, stat.value);
+}
+```
+
+See the [package guide](https://github.com/kar-mi/spirit-vale-tools/blob/main/docs/packages.md) for registry setup and usage.

package/dist/decoder.d.ts

@@ -0,0 +1,16 @@
+import { resolveFishNetItem } from "@kar-mi/spirit-vale-tools-items";
+import type { CharacterSnapshot } from "./types.ts";
+export interface DecodedCharacterUpdate {
+    updateType: number;
+    snapshot: CharacterSnapshot;
+    currentWeight?: number;
+}
+export declare function resolveCharacterArchetypeId(name: string): number | undefined;
+export declare function decodeCharacterRpcPayload(payload: Buffer, includesUpdateType: boolean, now?: Date): DecodedCharacterUpdate;
+/**
+ * Recomputes every derived substat field (name, scaled value, percent flag) from the raw
+ * type + roll using the current tables. Stored snapshots persist values baked by whatever
+ * build decoded them, so they must never be trusted for display or calculation.
+ */
+export declare function rescaleSubstats(snapshot: CharacterSnapshot, resolveItem?: typeof resolveFishNetItem): CharacterSnapshot;
+//# sourceMappingURL=decoder.d.ts.map

package/dist/decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder.d.ts","sourceRoot":"","sources":["../src/decoder.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAGrE,OAAO,KAAK,EAA8E,iBAAiB,EAAoB,MAAM,YAAY,CAAC;AAalJ,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,OAAa,GAAG,sBAAsB,CAsEhI;AAiLD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,WAAW,GAAE,OAAO,kBAAuC,GAAG,iBAAiB,CAa3I"}

package/dist/formulas.d.ts

@@ -0,0 +1,18 @@
+import { resolveFishNetItem } from "@kar-mi/spirit-vale-tools-items";
+import { resolveFishNetSkill } from "@kar-mi/spirit-vale-tools-skills";
+import type { CharacterArtifact, CharacterAttributes, CharacterEquipment, CharacterHealingTraits, CharacterSkill, CharacterSnapshot, CharacterStatBreakdown, CharacterSubstat, GearStatTotal } from "./types.ts";
+export declare function calculateCharacterStats(level: number, baseAttributes: CharacterAttributes, substats?: readonly CharacterSubstat[], archetypes?: readonly string[]): CharacterStatBreakdown[];
+/** Resolves catalogued item definitions; injectable so tests can supply synthetic data. */
+export type ItemResolver = typeof resolveFishNetItem;
+export type SkillResolver = typeof resolveFishNetSkill;
+export declare function aggregateGearSubstats(equipment: readonly CharacterEquipment[], artifacts: readonly CharacterArtifact[], resolveItem?: ItemResolver): GearStatTotal[];
+/** Combines rolled stats with the catalogued innate effects of items, cards, artifacts, and gems. */
+export declare function materializeGearStats(equipment: readonly CharacterEquipment[], artifacts: readonly CharacterArtifact[], resolveItem?: ItemResolver): CharacterSubstat[];
+/** Converts passive-skill effects into stat inputs at their learned level. */
+export declare function materializeSkillStats(skills: readonly CharacterSkill[], resolveSkill?: SkillResolver): CharacterSubstat[];
+/** Resolves the healing mechanics visible in a local character snapshot. */
+export declare function resolveCharacterHealingTraits(snapshot: CharacterSnapshot, resolveItem?: ItemResolver, resolveSkill?: SkillResolver): CharacterHealingTraits;
+/** Mirrors Formula.GetWeightLimit: base capacity, level growth, then flat stat 101 bonuses. */
+export declare function calculateWeightLimit(snapshot: CharacterSnapshot, resolveItem?: ItemResolver, resolveSkill?: SkillResolver): number;
+export declare function calculateAdvancedGearStats(totals: readonly GearStatTotal[]): CharacterStatBreakdown[];
+//# sourceMappingURL=formulas.d.ts.map

package/dist/formulas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formulas.d.ts","sourceRoot":"","sources":["../src/formulas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA0B,MAAM,iCAAiC,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,cAAc,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AASjN,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,mBAAmB,EAAE,QAAQ,GAAE,SAAS,gBAAgB,EAAO,EAAE,UAAU,GAAE,SAAS,MAAM,EAAO,GAAG,sBAAsB,EAAE,CAIpM;AAED,2FAA2F;AAC3F,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC;AACrD,MAAM,MAAM,aAAa,GAAG,OAAO,mBAAmB,CAAC;AAEvD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,EAAE,SAAS,EAAE,SAAS,iBAAiB,EAAE,EAAE,WAAW,GAAE,YAAiC,GAAG,aAAa,EAAE,CASxL;AAED,qGAAqG;AACrG,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,EAAE,SAAS,EAAE,SAAS,iBAAiB,EAAE,EAAE,WAAW,GAAE,YAAiC,GAAG,gBAAgB,EAAE,CAmB1L;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,EAAE,YAAY,GAAE,aAAmC,GAAG,gBAAgB,EAAE,CAQ9I;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,GAAE,YAAiC,EAC9C,YAAY,GAAE,aAAmC,GAChD,sBAAsB,CASxB;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,GAAE,YAAiC,EAC9C,YAAY,GAAE,aAAmC,GAChD,MAAM,CAMR;AAuBD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,sBAAsB,EAAE,CAarG"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { decodeCharacterRpcPayload, rescaleSubstats, resolveCharacterArchetypeId } from "./decoder.ts";
+export { aggregateGearSubstats, calculateCharacterStats, calculateWeightLimit, materializeGearStats, materializeSkillStats, resolveCharacterHealingTraits } from "./formulas.ts";
+export { decodeCharacterRecordSync, decodeCharacterSpawnRecords } from "./record-decoder.ts";
+export { FishNetCharacterTracker } from "./tracker.ts";
+export { FishNetInspectRoster } from "./inspect-roster.ts";
+export type { InspectedCharacter } from "./inspect-roster.ts";
+export { PERCENT_STATS, STAT_NAMES } from "./stat-names.ts";
+export { ATTRIBUTE_NAMES } from "./types.ts";
+export type { CharacterAttributeName, CharacterAttributes, CharacterArtifact, CharacterEquipment, CharacterHealingTraits, CharacterIdentity, GearStatTotal, CharacterRecordValues, CharacterSubstat, CharacterSnapshot, CharacterSkill, CharacterSkillEffect, CharacterRefinableItem, CharacterStatBreakdown, CharacterViewState, CharacterWeight, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AACvG,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AACjL,OAAO,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,GAChB,MAAM,YAAY,CAAC"}