osrs-tools 2.9.2 → 2.9.3

package/README.md

@@ -1,15 +1,16 @@
-# OSRS Tools
+# OSRS Tools
 
 [![NPM Version](https://img.shields.io/npm/v/osrs-tools.svg?style=for-the-badge)](https://www.npmjs.com/package/osrs-tools)
 [![Downloads](https://img.shields.io/npm/dm/osrs-tools.svg?style=for-the-badge)](https://www.npmjs.com/package/osrs-tools)
-[![TypeScript](https://img.shields.io/badge/TypeScript-4.9+-blue.svg?style=for-the-badge)](https://www.typescriptlang.org)
+[![CI](https://img.shields.io/github/actions/workflow/status/jamescer/osrs-tools/ci.yml?branch=master&style=for-the-badge&label=CI)](https://github.com/jamescer/osrs-tools/actions/workflows/ci.yml)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg?style=for-the-badge)](https://www.typescriptlang.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
 [![Node Version](https://img.shields.io/node/v/osrs-tools.svg?style=for-the-badge)](https://nodejs.org)
 [![Test Coverage](https://img.shields.io/codecov/c/github/jamescer/osrs-tools.svg?style=for-the-badge)](https://codecov.io/gh/jamescer/osrs-tools)
 
 > A comprehensive TypeScript library for Old School RuneScape (OSRS) data, tools, and game modeling.
 
-📦 **Type-safe**   🚀 **Well-tested**   📚 **Game-aware**   🔄 **Actively maintained**
+**Type-safe**   **Zero runtime dependencies**   **CJS + ESM**   **Tree-shakeable**   **Well-tested**
 
 ## Table of Contents
 
@@ -17,7 +18,7 @@
 - [Installation](#installation)
 - [Features](#features)
 - [Usage](#usage)
-- [API Highlights](#api-highlights)
+- [API Reference](#api-reference)
 - [Development](#development)
 - [Contributing](#contributing)
 - [Support](#support)
@@ -25,26 +26,29 @@
 
 ## Overview
 
-`osrs-tools` provides OSRS developers with:
+`osrs-tools` gives OSRS developers a fully-typed model of the game, covering:
 
-- a full quest and requirement system
+- full quest and requirement system with 189+ quests and miniquests
 - account data modeling for skills, bosses, clues, and progression
-- achievement diary lookups
-- clue scroll reward simulation
-- item model asset references
-- slayer master, task, and reward utilities
-- guild and league support
-- skill metadata helpers and validation utilities
-- custom validation error handling
-
-This library is built for bots, analytics, web apps, and toolchains that need OSRS game logic and data.
+- achievement diary lookups for all 10 regions, with a `DiaryTool` for account-based progress checks
+- Combat Achievements: all 637 tasks across six tiers, with a `CombatAchievementTool` for points and reward-tier progress
+- clue scroll reward simulation with wiki-accurate odds
+- item data model with combat stats and clue/quest item registries
+- slayer masters, tasks, reward unlocks/extends/buys, and point tables
+- hunter guild, rumours, and master progression
+- skill metadata, experience tables, and combat helpers
+- league support (Demonic Pacts, Raging Echoes)
+- custom `ValidationError` for consistent error handling
+
+This library is built for analytics, web apps, and toolchains that need OSRS game logic and data. It ships as dual CommonJS/ESM with bundled type definitions, has a single runtime dependency (`tslib`), and is marked side-effect free for tree-shaking.
 
 ## Installation
 
 ### Prerequisites
 
-- Node.js 16.x or higher
-- TypeScript 4.9+
+- Node.js 18.x or higher
+
+TypeScript is not required to consume this package — it ships compiled JavaScript with bundled `.d.ts` type definitions — but is recommended to get full type-checking in your own project.
 
 ### Install
 
@@ -52,28 +56,24 @@ This library is built for bots, analytics, web apps, and toolchains that need OS
 npm install osrs-tools
 ```
 
-For account-related features using external hiscore JSON:
-
-```bash
-npm install osrs-json-hiscores
-```
-
 ## Features
 
 - Quest system with all OSRS quests and recursive requirement checking
-- `OsrsAccount` parsing from JSON and skill / score lookups
-- Achievement diaries and diary requirement inspection
-- Clue Scroll reward table simulation with mimic and master clue handling
-- Item modeling and 3D asset path exports
-- Slayer masters, tasks, unlocks, extends, buys, and reward calculators
-- Guild/hunter utilities for hunter progression
-- League modules such as `DemonicPactsLeague` and `RagingEchoesLeague`
-- Skill metadata utilities, combat-level helpers, and validation functions
-- Custom `ValidationError` for consistent error handling
+- `OsrsAccount` skill, score, and combat level lookups
+- Achievement diaries with full task and requirement breakdowns via `DiaryTool`
+- Combat Achievements: all 637 tasks, reward-tier unlocks, and points calculation via `CombatAchievementTool`
+- Clue scroll casket simulation with tier-specific tables and mimic handling
+- Item model with combat stats, alch values, and quest/clue item flags
+- Slayer masters (Turael through Krystilia), task weights, point tables, reward utilities
+- Hunter guild rumours, masters, and locations
+- League modules for Demonic Pacts and Raging Echoes
+- Skill metadata helpers (24 skills including Sailing) and experience tables
+- Requirement classes covering levels, quests, items, combat, location, and more
+- `ValidationError` for uniform error handling across the library
 
 ## Usage
 
-### Core Import Example
+### Core Import
 
 ```typescript
 import {
@@ -81,7 +81,6 @@ import {
   OsrsAccount,
   ClueScrollHelper,
   Item,
-  yellowPartyhatModelPath,
   ValidationError,
 } from "osrs-tools";
 
@@ -95,83 +94,187 @@ const account = OsrsAccount.fromJson({
 });
 
 const questTool = new QuestTool(account);
-const dragonSlayer = QuestTool.getQuestByName("Dragon Slayer");
+const dragonSlayer = QuestTool.getQuestByName("Dragon Slayer I");
 const canComplete = questTool.canCompleteQuest(dragonSlayer);
 
-console.log("Dragon Slayer requirements", dragonSlayer?.requirements);
+console.log("Requirements:", dragonSlayer?.requirements);
 console.log("Can complete?", canComplete);
-console.log("Model path:", yellowPartyhatModelPath);
 ```
 
-### Subpackage Imports
+### Subpath Imports
 
 ```typescript
 import { QuestTool, DragonSlayerI } from "osrs-tools/quest";
 import { Duradel, getMasterByName } from "osrs-tools/slayer";
-import { OsrsAccount } from "osrs-tools/account";
-import diaries, { getDiaryByName, getAllDiaries } from "osrs-tools/diary";
-import { ClueScrollHelper } from "osrs-tools/tools";
-import { validateSkillLevel, getSkillMetadata } from "osrs-tools/utils";
-import { yellowPartyhatModelPath } from "osrs-tools/models/yellowPartyhat";
+import { OsrsAccount, Skill } from "osrs-tools/account";
+import diaries, { getDiaryByName, getAllDiaries, DiaryTool } from "osrs-tools/diary";
+import { CombatAchievementTool, ALL_COMBAT_ACHIEVEMENT_TASKS } from "osrs-tools/combat-achievements";
+import { getExperienceForLevel, getLevelForExperience } from "osrs-tools/tools";
+import { validateSkillLevel, getSkillsByCategory } from "osrs-tools/utils";
+```
+
+## API Reference
+
+### Quest System (`osrs-tools/quest`)
+
+- `QuestTool` — account-based quest completion checks and quest registry
+- `QuestTool.getQuestByName(name)` — look up a quest by name
+- `QuestList`, `MiniQuestList` — full quest and miniquest registries
+- `QuestDifficulty`, `QuestLength`, `QuestStatus` — enums for quest metadata
+- 189+ individual quest classes (e.g., `DragonSlayerI`, `AKingdomDivided`)
+- Requirement classes:
+  - `LevelRequirement` — skill level with optional boost support
+  - `SlayerLevelRequirement` — slayer-specific level checks
+  - `CombatLevelRequirement` — combat level gate
+  - `QuestRequirement` — quest completion dependency
+  - `ItemRequirement` — item with quantity, consumption, alternatives, and bankable flags
+  - `LocationRequirement` — geographic access requirement
+  - `QuestPointRequirement` — quest point gate
+  - `SlayerUnlockRequirement` — slayer unlock dependency
+
+### Account Modeling (`osrs-tools/account`)
+
+- `OsrsAccount.fromJson(json)` — parse an account from hiscores-style JSON
+- Skill access via `Skill` enum (24 skills: Attack, Defence, Strength, Hitpoints, Ranged, Prayer, Magic, Woodcutting, Fishing, Firemaking, Crafting, Smithing, Mining, Herblore, Agility, Thieving, Slayer, Farming, Runecraft, Hunter, Construction, Cooking, Fletching, Sailing)
+- `SKILL_METADATA` — per-skill metadata including category, maxLevel, and isBoostable
+
+### Achievement Diaries (`osrs-tools/diary`)
+
+- `diaries` default export — all diaries
+- `getDiaryByName(name)` — look up a diary by region name
+- `getAllDiaries()` — array of all 10 regional diaries
+- Regions: Ardougne, Desert, Fremennik, Kandarin, Karamja, Kourend & Kebos, Lumbridge & Draynor, Morytania, Varrock, Wilderness
+- Each diary includes Easy/Medium/Hard/Elite tasks with full requirement breakdowns
+- `DiaryTool` — account-bound task checks:
+  - `canCompleteTask(task)` / `canCompleteLevel(level)` — checks Level/Quest/CombatLevel/QuestPoint requirements
+  - `getCompletableTasks(source)` / `getRemainingTasks(source)` — accepts a full `Diary` or a single `DiaryLevel`
+  - `getDiaryProgress(diary)` — completable/remaining/total breakdown per tier
+
+### Combat Achievements (`osrs-tools/combat-achievements`)
+
+- All 637 tasks across six tiers (Easy 41 / Medium 60 / Hard 85 / Elite 162 / Master 168 / Grandmaster 121), sourced from the OSRS Wiki
+- `ALL_COMBAT_ACHIEVEMENT_TASKS`, `EASY_COMBAT_ACHIEVEMENTS` ... `GRANDMASTER_COMBAT_ACHIEVEMENTS` — task lists per tier
+- `getCombatAchievementByName(name)`, `getCombatAchievementsByTier(tier)`, `getCombatAchievementsByMonster(monster)`
+- `COMBAT_ACHIEVEMENT_REWARD_TIERS` — the 6 cumulative point thresholds (41/161/416/1064/1904/2630) and their reward text
+- `CombatAchievementTool`:
+  - `hasEngagedMonster(task)` — best-effort accessibility signal from the account's boss kill count; task completion itself isn't exposed via hiscores and can't be verified
+  - `getAccessibleTasks(tasks)` / `getInaccessibleTasks(tasks)`
+  - `calculatePoints(completedTaskNames)` — points for a caller-supplied list of completed task names
+  - `getUnlockedRewardTiers(points)` / `getNextRewardTier(points)`
+  - `getProgress(completedTaskNames)` — full per-tier breakdown plus unlocked/next reward tiers
+
+```typescript
+import { CombatAchievementTool } from "osrs-tools/combat-achievements";
+
+const caTool = new CombatAchievementTool(account);
+const progress = caTool.getProgress(["Barrows Novice", "Noxious Foe"]);
+console.log(progress.totalPoints, progress.nextRewardTier?.tier);
 ```
 
-## API Highlights
+### Clue Scroll Simulation
+
+Available from the main `osrs-tools` import:
 
-### Quest System
+```typescript
+import { ClueScrollHelper } from "osrs-tools";
 
-- `QuestTool` for account-based quest completion checks
-- `getQuestByName(name)` to look up quest data
-- `QuestList`, `MiniQuestList`, and full quest registry
-- requirement types including level and quest dependencies
+const result = ClueScrollHelper.openCasket("hard");
+console.log(result.items, result.mimicTriggered);
+```
 
-### Account Modeling
+- `ClueScrollHelper.openCasket(tier)` — simulate a casket opening with wiki-accurate odds
+- Tiers: `beginner`, `easy`, `medium`, `hard`, `elite`, `master`
+- `CasketReward` interface: `{ items, count, masterClue, mimicTriggered, mimicGuaranteed, mimicBonusItem }`
 
-- `OsrsAccount.fromJson(json)` loads account and hiscores-style data
-- access skills, skill details, combat level, and quest points
-- boss score, clue score, bounty hunter, league points, and deadman points lookup
+### Items
 
-### Achievement Diaries
+Available from the main `osrs-tools` import:
 
-- `diaries` default export for all diaries
-- `getDiaryByName(name)` to locate a diary
-- `getAllDiaries()` for listing all diaries
+- `Item` — item data model with combat stats (attack/defence stab/slash/crush/magic/ranged, melee/ranged/magic bonuses, prayer), alch values, weight, tradeable/equipable/stackable flags
+- `ClueRewards` — item registries for clue scroll reward tables
+- `QuestItems` — item registry for quest-related items
 
-### Clue Scroll Simulation
+### Slayer System (`osrs-tools/slayer`)
 
-- `ClueScrollHelper.openCasket(tier)` simulates casket rewards
-- tier-specific reward tables for beginner through master clues
-- mimic roll and master clue handling
-- item canonicalization and quantity resolution
+#### Masters
 
-### Item Models
+| Class | `getMasterByName` key |
+| --- | --- |
+| `Turael` | `"Turael"` |
+| `Spria` | `"Spria"` |
+| `Mazchna` | `"Mazchna"` |
+| `Vannaka` | `"Vannaka"` |
+| `Chaeldar` | `"Chaeldar"` |
+| `KonarQuoMaten` | `"Konar quo Maten"` |
+| `Nieve` | `"Nieve"` |
+| `Duradel` | `"Duradel"` |
+| `Krystilia` | `"Krystilia"` |
 
-- `Item` data model and item asset helpers
-- `yellowPartyhatModelPath` and `getItemModelPath("yellowPartyhat")`
-- `osrs-tools/models/*` export path for shipped assets
+#### Registry Utilities
 
-### Slayer System
+- `getMasterByName(name)` — look up a master by name
+- `getAllMasters()` — all slayer masters
+- `getMastersByMinimumLevel(level)` — masters accessible at a given combat level
+- `getMastersByProgression()` — masters ordered by progression
+- `getRandomMasterForLevel(level)` — random master appropriate for a level
 
-- core classes: `SlayerMaster`, `Task`, `Assignment`
-- named masters such as `Turael`, `Spria`, `Mazchna`, `Vannaka`, `Chaeldar`, `KonarQuoMaten`, `Nieve`, `Duradel`, `Krystilia`
-- utility helpers: `getMasterByName`, `getAllMasters`, `getMastersByMinimumLevel`, `getMastersByProgression`, `getRandomMasterForLevel`
-- reward utilities: `SlayerUnlock`, `SlayerExtend`, `SlayerBuy`, and cost calculators
-- task weights, experience tables, and quantity presets
+#### Rewards
+
+- `SlayerUnlock`, `SlayerExtend`, `SlayerBuy` — reward classes
+- `SLAYER_UNLOCKS`, `SLAYER_EXTENDS`, `SLAYER_BUYS` — full data sets
+- `getUnlockByName`, `getUnlocksByCostRange`, `calculateUnlocksCost`
+- `getExtendByName`, `getExtendsForTask`
+- `getBuyByItem`, `getBuysByCostRange`, `getBuysByRequirement`, `calculateBuysCost`
+
+#### Data & Constants
+
+- `POINTS_TABLE` — point rewards per master and streak
+- `SLAYER_EXP_RATES`, `STANDARD_TASK_WEIGHTS`, `TASK_QUANTITY_PRESETS`, `EXTENDED_QUANTITY_PRESETS`
+- `SlayerLocation`, `SlayerBoss`, `MonsterType` enums
+
+### Experience Tools (`osrs-tools/tools`)
+
+- `getExperienceForLevel(level: number): number` — XP required to reach a level
+- `getLevelForExperience(xp: number): number` — level at a given XP total
+- `LEVEL_TO_EXPERIENCE: Record<number, number>` — full XP table (levels 1–99)
 
 ### Guilds
 
-- hunter guild exports and guild-specific helpers
-- hunter progression modeling and requirement support
+Available from the main `osrs-tools` import:
+
+#### Hunter Guild
+
+- `HunterGuild` — guild class
+- `HunterGuildMaster` — master NPC with progression data
+- `HunterGuildMasterName` — enum of master names
+- `HunterRumour` — rumour entry with location and loot
+- `Rumours` — full rumour registry
+- `RumourLocation` — location data for rumours
 
 ### Leagues
 
-- league-specific exports for OSRS limited-time modes
-- `DemonicPactsLeagueAreas`, `RagingEchoesLeague`, and league model data
+Available from the main `osrs-tools` import:
+
+- `League` interface — relics, reward tiers, and relic tiers
+- `Relic` — selectable relic with passive bonuses
+- `RelicTier` — tier with XP/drop multipliers
+- `RewardTier` — milestone reward unlock
+- `DemonicPactsLeagueAreas` — area data for Demonic Pacts
+- `RagingEchoesLeague` — region and relic data for Raging Echoes
+- `LeagueRegion`, `NotableDrop`, `GenericLeagueRegion` enums
 
-### Skills & Validation
+### Validation & Skill Utilities (`osrs-tools/utils`)
 
-- skill metadata helpers: `getSkillMetadata`, `getAllSkills`, `getCombatSkills`
-- validation helpers: `validateSkillLevel`, `validateQuestPoints`, `validateCombatLevel`, `validateAccountName`
-- `ValidationError` thrown for invalid data
+- `validateSkillLevel(level: number, skillName: string): void` — throws `ValidationError` for invalid levels
+- `validateQuestPoints(points: number): void` — throws `ValidationError` for invalid point totals
+- `getSkillMetadata(skill: Skill | string): SkillMetadata | undefined`
+- `isValidSkill(skillName: string): boolean`
+- `isValidLevel(skill: Skill | string, level: number): boolean`
+- `getSkillsByCategory(category: "combat" | "gathering" | "production" | "support"): Skill[]`
+
+### Error Handling
+
+- `ValidationError` — extends `Error` with `fieldName: string`, `value: unknown`, and optional `context: Record<string, unknown>`
 
 ## Development
 
@@ -187,47 +290,67 @@ npm test
 
 ### Available Scripts
 
-| Command         | Description                 |
-| --------------- | --------------------------- |
-| `build`         | Compile TypeScript to dist/ |
-| `dev`           | Watch mode compilation      |
-| `test`          | Run test suite              |
-| `test:watch`    | Run tests in watch mode     |
-| `test:coverage` | Generate coverage report    |
-| `lint`          | Lint and fix code           |
-| `format`        | Format code with Prettier   |
+| Command                 | Description                           |
+| ----------------------- | ------------------------------------- |
+| `build`                 | Compile TypeScript to `dist/`         |
+| `build:npm`             | Build with publish tsconfig           |
+| `clean`                 | Remove `dist/` output directory       |
+| `dev`                   | Watch mode compilation                |
+| `test`                  | Run test suite                        |
+| `test:watch`            | Run tests in watch mode               |
+| `test:coverage`         | Generate coverage report              |
+| `coverage`              | Run coverage and upload to Codecov    |
+| `format`                | Format source and tests with Prettier |
+| `lint`                  | Lint and auto-fix with ESLint         |
+| `publish-test`          | Dry-run `npm publish`                 |
 
 ### Project Structure
 
-```
-source/                          # TypeScript source code
-├── index.ts                      # Main entry point
-├── runescape/
-│   ├── model/
-│   │   ├── account/             # Player account & skills
-│   │   ├── diaries/             # Achievement diaries
-│   │   ├── quest/               # Quest system
-│   │   │   ├── all/             # Individual quest classes
-│   │   │   └── index.ts         # Quest module export
-│   │   ├── slayer/              # Slayer system
-│   │   ├── Item/                # Item models
-│   │   └── npc/                 # NPC data
-│   ├── tools/                   # Utility tools (ClueScrollHelper, experience calc, etc.)
-│   ├── utils/                   # Helper utilities (validation, skill helpers)
-│   └── errors.ts                # Custom error types
-└── examples/                    # Usage examples
-
-test/                            # Jest test suite
+```text
+src/
+├── index.ts                          # Main entry point
+└── runescape/
+    ├── errors.ts                     # ValidationError
+    ├── model/
+    │   ├── Requirement.ts            # All requirement classes and RequirementType enum
+    │   ├── account/                  # OsrsAccount, Skill enum, SKILL_METADATA
+    │   │   └── skills/unlocks/       # AttackUnlocks, SkillUnlock
+    │   ├── clue/                     # ClueScrollHelper, ClueScrollRewards
+    │   ├── diaries/                  # 10 regional diary modules + DiaryTool
+    │   ├── combat-achievements/      # 637 tasks (6 tiers), reward tiers, CombatAchievementTool
+    │   ├── guilds/
+    │   │   └── hunter/               # HunterGuild, HunterGuildMaster, Rumours, RumourLocation
+    │   ├── items/                    # Item, ClueRewards, QuestItems
+    │   ├── leagues/                  # DemonicPactsLeague, RagingEchoesLeague, League interfaces
+    │   ├── quest/
+    │   │   ├── QuestTool.ts
+    │   │   ├── QuestList.ts
+    │   │   ├── MiniQuestList.ts
+    │   │   └── all/                  # 189+ individual quest classes
+    │   ├── skills/                   # Skill interface, attack and hunter skill modules
+    │   └── slayer/
+    │       ├── core/                 # SlayerMaster, Task, Assignment
+    │       ├── masters/              # 9 master classes + registry
+    │       ├── rewards/              # SlayerUnlock, SlayerExtend, SlayerBuy + data
+    │       └── tasks/                # Task constants and weights
+    ├── tools/
+    │   └── experience.ts             # getExperienceForLevel, getLevelForExperience, LEVEL_TO_EXPERIENCE
+    └── utils/
+        ├── validation.ts             # validateSkillLevel, validateQuestPoints
+        └── skillUtils.ts             # getSkillMetadata, isValidSkill, getSkillsByCategory, isValidLevel
+
+test/
 └── unit/
     ├── account/
     ├── diaries/
+    ├── combat-achievements/
     ├── quest/
     ├── slayer/
     ├── model/
     ├── tools/
     └── utils/
 
-dist/                            # Compiled output (generated by build)
+dist/                                 # Compiled output (generated by build)
 ```
 
 ## Contributing
@@ -238,11 +361,11 @@ We welcome contributions! We use [Conventional Commits](https://www.conventional
 
 1. Fork and clone the repository
 2. Create a branch (`feat/amazing-feature`)
-3. Make your changes
-4. Run tests (`npm test && npm run lint`)
+3. Make your changes and add tests
+4. Run `npm test && npm run lint`
 5. Commit with conventional format:
 
-   ```bash
+   ```text
    feat: add quest requirement validation
    fix: correct slayer task weights
    docs: update API documentation
@@ -253,17 +376,15 @@ We welcome contributions! We use [Conventional Commits](https://www.conventional
 ### Guidelines
 
 - Add tests for new features
-- Update documentation for changes
+- Update documentation for public API changes
 - Follow existing code style
 - Keep changes focused
 
 ## Support
 
-Need help or want to contribute?
-
 - [Report Issues](https://github.com/jamescer/osrs-tools/issues)
 - [Request Features](https://github.com/jamescer/osrs-tools/issues)
-- [Join Discussions](https://github.com/jamescer/osrs-tools/discussions)
+- [Discussions](https://github.com/jamescer/osrs-tools/discussions)
 
 ## License
 
@@ -273,4 +394,4 @@ Need help or want to contribute?
 
 - **Author**: [James Cerniglia](mailto:jamesmcerniglia@gmail.com)
 - **Contributors**: [View all contributors](https://github.com/jamescer/osrs-tools/graphs/contributors)
-- **Data Source**: [Old School RuneScape Wiki](https://oldschool.runescape.wiki/)
+- **Data Source**: [Old School RuneScape Wiki](https://oldschool.runescape.wiki/)

package/dist/examples/ClueScrollExample.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClueScrollExample.d.ts","sourceRoot":"","sources":["../../source/examples/ClueScrollExample.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
+{"version":3,"file":"ClueScrollExample.d.ts","sourceRoot":"","sources":["../../src/examples/ClueScrollExample.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/examples/ClueScrollExample.js

@@ -28,3 +28,4 @@ tiers.forEach(tier => {
     const itemNames = casket.items.map(item => item.name).join(', ');
     console.log(`${tier.charAt(0).toUpperCase() + tier.slice(1)} casket (${casket.count} items): ${itemNames}`);
 });
+//# sourceMappingURL=ClueScrollExample.js.map

package/dist/examples/ClueScrollExample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClueScrollExample.js","sourceRoot":"","sources":["../../src/examples/ClueScrollExample.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAE5E,oEAAoE;AACpE,MAAM,cAAc,GAAG,gBAAgB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/D,OAAO,CAAC,GAAG,CAAC,6BAA6B,cAAc,CAAC,KAAK,WAAW,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;AAEhG,sCAAsC;AACtC,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACvD,OAAO,CAAC,GAAG,CAAC,yBAAyB,UAAU,CAAC,KAAK,WAAW,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;AAEpF,iEAAiE;AACjE,MAAM,UAAU,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACrE,OAAO,CAAC,GAAG,CAAC,qCAAqC,UAAU,CAAC,MAAM,eAAe,EAAE,UAAU,CAAC,CAAC;AAE/F,gDAAgD;AAChD,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAC1F,OAAO,CAAC,GAAG,CAAC,4CAA4C,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAElI,+BAA+B;AAC/B,MAAM,MAAM,GAAG,gBAAgB,CAAC,aAAa,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AACzE,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE/D,iDAAiD;AACjD,MAAM,eAAe,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACpE,OAAO,CAAC,GAAG,CAAC,qCAAqC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC;AAE3E,oEAAoE;AACpE,MAAM,KAAK,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AACjF,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;IACnB,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,KAAK,YAAY,SAAS,EAAE,CAAC,CAAC;AAC9G,CAAC,CAAC,CAAC"}

package/dist/examples/ExampleQuest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExampleQuest.d.ts","sourceRoot":"","sources":["../../source/examples/ExampleQuest.ts"],"names":[],"mappings":""}
+{"version":3,"file":"ExampleQuest.d.ts","sourceRoot":"","sources":["../../src/examples/ExampleQuest.ts"],"names":[],"mappings":""}

package/dist/examples/ExampleQuest.js

@@ -17,3 +17,4 @@ if (quest) {
 else {
     console.log(`Quest "${questName}" not found.`);
 }
+//# sourceMappingURL=ExampleQuest.js.map

package/dist/examples/ExampleQuest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExampleQuest.js","sourceRoot":"","sources":["../../src/examples/ExampleQuest.ts"],"names":[],"mappings":"AACA,iCAAiC;AACjC,0CAA0C;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAE/D;;;GAGG;AAEH,oCAAoC;AACpC,MAAM,SAAS,GAAG,iBAAiB,CAAC;AACpC,MAAM,KAAK,GAAG,SAAS,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;AAElD,IAAI,KAAK,EAAE,CAAC;IACV,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AACnD,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CAAC,UAAU,SAAS,cAAc,CAAC,CAAC;AACjD,CAAC"}

package/dist/index.d.ts

@@ -6,6 +6,7 @@
  * - QuestTool: Quest system and utilities
  * - OsrsAccount: Player account management
  * - Diaries: Achievement diary system
+ * - CombatAchievementTool: Combat Achievements system
  * - ClueScrollHelper: Clue scroll utilities
  * - Item system and models
  * - Slayer system and masters
@@ -15,19 +16,19 @@
  * - import { ... } from 'osrs-tools/account' - Account and skill management
  * - import { ... } from 'osrs-tools/slayer' - Slayer system
  * - import { ... } from 'osrs-tools/diary' - Achievement diaries
+ * - import { ... } from 'osrs-tools/combat-achievements' - Combat Achievements
  * - import { ... } from 'osrs-tools/tools' - Utility tools
  * - import { ... } from 'osrs-tools/utils' - Helper utilities
  */
-export * from "./runescape/model/quest/QuestTool";
-export * from "./runescape/model/account/OsrsAccount";
-export * from "./runescape/model/diaries";
-export * from "./runescape/model/clue/ClueScrollHelper";
-export * from "./runescape/model/items";
-export * from "./runescape/model/leagues";
-export { SlayerMaster, Task, Assignment, Turael, Spria, Mazchna, Vannaka, Chaeldar, KonarQuoMaten, Nieve, Duradel, Krystilia, SlayerUnlock, SlayerExtend, SlayerBuy, SLAYER_UNLOCKS, SLAYER_EXTENDS, SLAYER_BUYS, SlayerLocation, SlayerBoss, POINTS_TABLE, getMasterByName, getAllMasters, getMastersByMinimumLevel, getMastersByProgression, } from "./runescape/model/slayer";
-export * from "./runescape/model/guilds";
-export * from "./runescape/model/leagues";
-export * from "./runescape/model/skills";
-export * from "./runescape/model/Requirement";
-export * from "./runescape/errors";
-//# sourceMappingURL=index.d.ts.map
+export * from './runescape/model/account/OsrsAccount';
+export * from './runescape/model/clue/ClueScrollHelper';
+export * from './runescape/model/combat-achievements';
+export * from './runescape/model/diaries';
+export * from './runescape/model/quest/QuestTool';
+export * from './runescape/model/items';
+export * from './runescape/model/leagues';
+export { Assignment, Chaeldar, Duradel, getAllMasters, getMasterByName, getMastersByMinimumLevel, getMastersByProgression, KonarQuoMaten, Krystilia, Mazchna, Nieve, POINTS_TABLE, SLAYER_BUYS, SLAYER_EXTENDS, SLAYER_UNLOCKS, SlayerBoss, SlayerBuy, SlayerExtend, SlayerLocation, SlayerMaster, SlayerUnlock, Spria, Task, Turael, Vannaka, } from './runescape/model/slayer';
+export * from './runescape/model/guilds';
+export * from './runescape/model/skills';
+export * from './runescape/errors';
+export * from './runescape/model/Requirement';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../source/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yCAAyC,CAAC;AAGxD,cAAc,yBAAyB,CAAC;AAIxC,cAAc,2BAA2B,CAAC;AAG1C,OAAO,EACL,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,MAAM,EACN,KAAK,EACL,OAAO,EACP,OAAO,EACP,QAAQ,EACR,aAAa,EACb,KAAK,EACL,OAAO,EACP,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,cAAc,EACd,cAAc,EACd,WAAW,EACX,cAAc,EACd,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAGlC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,0BAA0B,CAAC;AAGzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAGlD,cAAc,yBAAyB,CAAC;AAGxC,cAAc,2BAA2B,CAAC;AAG1C,OAAO,EACL,UAAU,EACV,QAAQ,EACR,OAAO,EACP,aAAa,EACb,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,SAAS,EACT,OAAO,EACP,KAAK,EACL,YAAY,EACZ,WAAW,EACX,cAAc,EACd,cAAc,EACd,UAAU,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,IAAI,EACJ,MAAM,EACN,OAAO,GACR,MAAM,0BAA0B,CAAC;AAGlC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@
  * - QuestTool: Quest system and utilities
  * - OsrsAccount: Player account management
  * - Diaries: Achievement diary system
+ * - CombatAchievementTool: Combat Achievements system
  * - ClueScrollHelper: Clue scroll utilities
  * - Item system and models
  * - Slayer system and masters
@@ -15,26 +16,26 @@
  * - import { ... } from 'osrs-tools/account' - Account and skill management
  * - import { ... } from 'osrs-tools/slayer' - Slayer system
  * - import { ... } from 'osrs-tools/diary' - Achievement diaries
+ * - import { ... } from 'osrs-tools/combat-achievements' - Combat Achievements
  * - import { ... } from 'osrs-tools/tools' - Utility tools
  * - import { ... } from 'osrs-tools/utils' - Helper utilities
  */
 // Core API exports - Most frequently used
-export * from "./runescape/model/quest/QuestTool";
-export * from "./runescape/model/account/OsrsAccount";
-export * from "./runescape/model/diaries";
-export * from "./runescape/model/clue/ClueScrollHelper";
+export * from './runescape/model/account/OsrsAccount';
+export * from './runescape/model/clue/ClueScrollHelper';
+export * from './runescape/model/combat-achievements';
+export * from './runescape/model/diaries';
+export * from './runescape/model/quest/QuestTool';
 // Item system
-export * from "./runescape/model/items";
+export * from './runescape/model/items';
 // Leagues
-export * from "./runescape/model/leagues";
-// Slayer system (refactored exports)
-export { SlayerMaster, Task, Assignment, Turael, Spria, Mazchna, Vannaka, Chaeldar, KonarQuoMaten, Nieve, Duradel, Krystilia, SlayerUnlock, SlayerExtend, SlayerBuy, SLAYER_UNLOCKS, SLAYER_EXTENDS, SLAYER_BUYS, SlayerLocation, SlayerBoss, POINTS_TABLE, getMasterByName, getAllMasters, getMastersByMinimumLevel, getMastersByProgression, } from "./runescape/model/slayer";
+export * from './runescape/model/leagues';
+// Slayer system
+export { Assignment, Chaeldar, Duradel, getAllMasters, getMasterByName, getMastersByMinimumLevel, getMastersByProgression, KonarQuoMaten, Krystilia, Mazchna, Nieve, POINTS_TABLE, SLAYER_BUYS, SLAYER_EXTENDS, SLAYER_UNLOCKS, SlayerBoss, SlayerBuy, SlayerExtend, SlayerLocation, SlayerMaster, SlayerUnlock, Spria, Task, Turael, Vannaka, } from './runescape/model/slayer';
 // Guilds system
-export * from "./runescape/model/guilds";
-// Leagues system
-export * from "./runescape/model/leagues";
+export * from './runescape/model/guilds';
 // Skills system
-export * from "./runescape/model/skills";
+export * from './runescape/model/skills';
 // Core requirement types
-export * from "./runescape/model/Requirement";
-export * from "./runescape/errors";
+export * from './runescape/errors';
+export * from './runescape/model/Requirement';

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,0CAA0C;AAC1C,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAElD,cAAc;AACd,cAAc,yBAAyB,CAAC;AAExC,UAAU;AACV,cAAc,2BAA2B,CAAC;AAE1C,gBAAgB;AAChB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,OAAO,EACP,aAAa,EACb,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,SAAS,EACT,OAAO,EACP,KAAK,EACL,YAAY,EACZ,WAAW,EACX,cAAc,EACd,cAAc,EACd,UAAU,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,IAAI,EACJ,MAAM,EACN,OAAO,GACR,MAAM,0BAA0B,CAAC;AAElC,gBAAgB;AAChB,cAAc,0BAA0B,CAAC;AAEzC,gBAAgB;AAChB,cAAc,0BAA0B,CAAC;AAEzC,yBAAyB;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC"}