osrs-tools 2.5.2 → 2.5.3

package/dist/runescape/model/diaries/Diary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Diary.d.ts","sourceRoot":"","sources":["../../../../source/runescape/model/diaries/Diary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAelG,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;CACnB;AAiFD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAM9D;AAED,wBAAgB,aAAa,IAAI,KAAK,EAAE,CAEvC;AAGD,QAAA,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAWlC,CAAC;AAOF,eAAe,OAAO,CAAC;AAGvB,eAAO,MAAM,aAAa,OAA4B,CAAC;AACvD,eAAO,MAAM,WAAW,OAA0B,CAAC;AACnD,eAAO,MAAM,YAAY,OAA2B,CAAC;AACrD,eAAO,MAAM,cAAc,OAA6B,CAAC;AACzD,eAAO,MAAM,aAAa,OAA4B,CAAC;AACvD,eAAO,MAAM,YAAY,OAA2B,CAAC;AACrD,eAAO,MAAM,iBAAiB,OAAmC,CAAC;AAClE,eAAO,MAAM,qBAAqB,OAAuC,CAAC;AAC1E,eAAO,MAAM,cAAc,OAA6B,CAAC;AACzD,eAAO,MAAM,YAAY,OAA2B,CAAC;AACrD,eAAO,MAAM,qBAAqB,OAAqC,CAAC;AACxE,eAAO,MAAM,eAAe,OAA8B,CAAC"}
+{"version":3,"file":"Diary.d.ts","sourceRoot":"","sources":["../../../../source/runescape/model/diaries/Diary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAYlG,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;CACnB;AAiFD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAM9D;AAED,wBAAgB,aAAa,IAAI,KAAK,EAAE,CAEvC;AAGD,QAAA,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAWlC,CAAC;AAEF,eAAe,OAAO,CAAC;AAGvB,eAAO,MAAM,aAAa,OAA4B,CAAC;AACvD,eAAO,MAAM,WAAW,OAA0B,CAAC;AACnD,eAAO,MAAM,YAAY,OAA2B,CAAC;AACrD,eAAO,MAAM,cAAc,OAA6B,CAAC;AACzD,eAAO,MAAM,aAAa,OAA4B,CAAC;AACvD,eAAO,MAAM,YAAY,OAA2B,CAAC;AACrD,eAAO,MAAM,iBAAiB,OAAmC,CAAC;AAClE,eAAO,MAAM,qBAAqB,OAAuC,CAAC;AAC1E,eAAO,MAAM,cAAc,OAA6B,CAAC;AACzD,eAAO,MAAM,YAAY,OAA2B,CAAC;AACrD,eAAO,MAAM,qBAAqB,OAAqC,CAAC;AACxE,eAAO,MAAM,eAAe,OAA8B,CAAC"}

package/dist/runescape/model/diaries/Diary.js

@@ -9,8 +9,6 @@ import { KourendKebosDiary as typedKourendKebosDiary } from "./kourend-kebos/Kou
 import { LumbridgeDraynorDiary as typedLumbridgeDraynorDiary } from "./lumbridge-draynor/LumbridgeDraynor";
 import { MorytaniaDiary as typedMorytaniaDiary } from "./morytania/Morytania";
 import { WildernessDiary as typedWildernessDiary } from "./wilderness/Wilderness";
-// eslint-disable-next-line @typescript-eslint/no-var-requires
-const diariesData = require("../../resources/diary/diaries.json");
 function mapSkillReq(skillReq) {
     // skillReq: { skill: string, level: number, boostable: boolean }
     if (!skillReq || !skillReq.skill)
@@ -111,11 +109,6 @@ const diaries = {
     "Morytania Diary": typedMorytaniaDiary,
     "Wilderness Diary": typedWildernessDiary,
 };
-for (const k of Object.keys(diariesData)) {
-    if (!diaries[k]) {
-        diaries[k] = buildDiary(k, diariesData[k]);
-    }
-}
 export default diaries;
 // Named exports for convenient imports
 export const ArdougneDiary = diaries["Ardougne Diary"];

package/dist/runescape/model/quest/QuestTool.d.ts

@@ -28,12 +28,41 @@ declare class QuestTool {
     static getAllQuests(): Quest[];
     static getAllMiniQuests(): Quest[];
     /**
-     * Static utility to get a Quest instance by its name.
-     * This assumes all quests are exported as default from their respective files in quest/all/.
+     * Build the quest registry mapping canonical names to quest objects.
+     * Uses QuestList as the source of truth for quest names.
+     * @returns Map of normalized quest names to Quest objects
+     */
+    private static buildQuestRegistry;
+    /**
+     * Find the quest object matching a canonical quest name from QuestList.
+     * Uses the quest's name property to match against the canonical name.
+     * @param canonicalName The canonical name from QuestList
+     * @param questMap Map of available quest objects
+     * @returns The matching Quest object or undefined
+     */
+    private static findQuestByCanonicalName;
+    /**
+     * Normalize a quest name for comparison purposes.
+     * Removes punctuation, extra spaces, and converts to lowercase.
+     * @param questName The quest name to normalize
+     * @returns Normalized quest name
+     */
+    private static normalizeQuestName;
+    /**
+     * Calculate Levenshtein distance between two strings for fuzzy matching.
+     * @param str1 First string
+     * @param str2 Second string
+     * @returns Levenshtein distance
+     */
+    private static levenshteinDistance;
+    /**
+     * Get a quest by name with support for fuzzy matching and common variations.
+     * Supports exact matches, case-insensitive matches, and approximate matches.
      * @param questName The name of the quest to retrieve
      * @returns Quest instance or undefined if not found
      */
     static getQuestByName(questName: string): Quest | undefined;
+    private static questCache;
     /**
      * Get the maximum boost for a given skill, based on OSRS Wiki data.
      * @param skillName The name of the skill (case-insensitive, e.g. 'Attack', 'Herblore')

package/dist/runescape/model/quest/QuestTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QuestTool.d.ts","sourceRoot":"","sources":["../../../../source/runescape/model/quest/QuestTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC;;;;;GAKG;AACH,cAAM,SAAS;IACb,OAAO,CAAC,WAAW,CAA0B;gBAEjC,OAAO,CAAC,EAAE,WAAW;IAIjC;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAQ1C;;;OAGG;IACH,cAAc,IAAI,WAAW,GAAG,SAAS;IAIzC;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,OAAO;WAmCvE,YAAY,IAAI,KAAK,EAAE;WAIvB,gBAAgB,IAAI,KAAK,EAAE;IAIzC;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAiC3D;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CA2EnD;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"QuestTool.d.ts","sourceRoot":"","sources":["../../../../source/runescape/model/quest/QuestTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AA+IhC;;;;;GAKG;AACH,cAAM,SAAS;IACb,OAAO,CAAC,WAAW,CAA0B;gBAEjC,OAAO,CAAC,EAAE,WAAW;IAIjC;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAQ1C;;;OAGG;IACH,cAAc,IAAI,WAAW,GAAG,SAAS;IAIzC;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,OAAO;WAmCvE,YAAY,IAAI,KAAK,EAAE;WAIvB,gBAAgB,IAAI,KAAK,EAAE;IAIzC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA6JjC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAUvC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAQjC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA4BlC;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAiC3D,OAAO,CAAC,MAAM,CAAC,UAAU,CAAiC;IAE1D;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CA2EnD;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/runescape/model/quest/QuestTool.js

@@ -1,6 +1,145 @@
 import { RequirementType } from "../Requirement";
 import { QuestList } from "./QuestList";
+// Import all quests for registry
 import AKingdomDivided from "./all/AKingdomDivided";
+import AnimalMagnetism from "./all/AnimalMagnetism";
+import AnotherSliceOfHAM from "./all/AnotherSliceOfHAM";
+import APorcineOfInterest from "./all/APorcineOfInterest";
+import ASoulsBane from "./all/ASoulsBane";
+import ATailOfTwoCats from "./all/ATailOfTwoCats";
+import ATasteOfHope from "./all/ATasteOfHope";
+import ATheatreOfBlood from "./all/ATheatreOfBlood";
+import BelowIceMountain from "./all/BelowIceMountain";
+import BetweenARock from "./all/BetweenARock";
+import BigChompyBirdHunting from "./all/BigChompyBirdHunting";
+import Biohazard from "./all/Biohazard";
+import BlackKnightsFortress from "./all/BlackKnightsFortress";
+import BoneVoyage from "./all/BoneVoyage";
+import CabinFever from "./all/CabinFever";
+import ClientOfKourend from "./all/ClientOfKourend";
+import ClockTower from "./all/ClockTower";
+import ColdWar from "./all/ColdWar";
+import Contact from "./all/Contact";
+import CooksAssistant from "./all/CooksAssistant";
+import CreatureOfFenkenstrain from "./all/CreatureOfFenkenstrain";
+import CurrentAffairs from "./all/CurrentAffairs";
+import DarknessOfHallowvale from "./all/DarknessOfHallowvale";
+import DeathPlateau from "./all/DeathPlateau";
+import DeathToTheDorgeshuun from "./all/DeathToTheDorgeshuun";
+import DemonSlayer from "./all/DemonSlayer";
+import DesertTreasure from "./all/DesertTreasure";
+import DeviousMinds from "./all/DeviousMinds";
+import DoricQuest from "./all/DoricQuest";
+import DoricsQuest from "./all/DoricsQuest";
+import DragonSlayerI from "./all/DragonSlayerI";
+import DragonSlayerII from "./all/DragonSlayerII";
+import DreamMentor from "./all/DreamMentor";
+import DruidicRitual from "./all/DruidicRitual";
+import DwarfCannon from "./all/DwarfCannon";
+import EadgarsRuse from "./all/EadgarsRuse";
+import EaglesPeak from "./all/EaglesPeak";
+import ElementalWorkshopI from "./all/ElementalWorkshopI";
+import ElementalWorkshopII from "./all/ElementalWorkshopII";
+import EnakhrasLament from "./all/EnakhrasLament";
+import EnlightenedJourney from "./all/EnlightenedJourney";
+import FairytaleIGrowingPains from "./all/FairytaleIGrowingPains";
+import FairytaleIICureAQueen from "./all/FairytaleIICureAQueen";
+import FamilyCrest from "./all/FamilyCrest";
+import FightArena from "./all/FightArena";
+import FishingContest from "./all/FishingContest";
+import ForgettableTale from "./all/ForgettableTale";
+import GardenOfTranquillity from "./all/GardenOfTranquillity";
+import GertrudesCat from "./all/GertrudesCat";
+import GettingAhead from "./all/GettingAhead";
+import GhostsAhoy from "./all/GhostsAhoy";
+import GoblinDiplomacy from "./all/GoblinDiplomacy";
+import GrimTales from "./all/GrimTales";
+import HauntedMine from "./all/HauntedMine";
+import HazeelCult from "./all/HazeelCult";
+import HeroesQuest from "./all/HeroesQuest";
+import HolyGrail from "./all/HolyGrail";
+import HorrorFromTheDeep from "./all/HorrorFromTheDeep";
+import IcthlarinsLittleHelper from "./all/IcthlarinsLittleHelper";
+import ImpCatcher from "./all/ImpCatcher";
+import InAidOfTheMyreque from "./all/InAidOfTheMyreque";
+import InSearchOfTheMyreque from "./all/InSearchOfTheMyreque";
+import JunglePotion from "./all/JunglePotion";
+import KingsRansom from "./all/KingsRansom";
+import LegendsQuest from "./all/LegendsQuest";
+import LostCity from "./all/LostCity";
+import LunarDiplomacy from "./all/LunarDiplomacy";
+import MakingHistory from "./all/MakingHistory";
+import MeatAndGreet from "./all/MeatAndGreet";
+import MerlinsCrystal from "./all/MerlinsCrystal";
+import MonkeyMadness from "./all/MonkeyMadness";
+import MonkeyMadnessII from "./all/MonkeyMadnessII";
+import MonksFriend from "./all/MonksFriend";
+import MurderMystery from "./all/MurderMystery";
+import MyArmsBigAdventure from "./all/MyArmsBigAdventure";
+import NatureSpirit from "./all/NatureSpirit";
+import ObservatoryQuest from "./all/ObservatoryQuest";
+import OlafsQuest from "./all/OlafsQuest";
+import OneSmallFavour from "./all/OneSmallFavour";
+import Pandemonium from "./all/Pandemonium";
+import PlagueCity from "./all/PlagueCity";
+import PriestInPeril from "./all/PriestInPeril";
+import PryingTimes from "./all/PryingTimes";
+import RagAndBoneMan from "./all/RagAndBoneMan";
+import Ratcatchers from "./all/Ratcatchers";
+import RecipeForDisaster from "./all/RecipeForDisaster";
+import RecruitmentDrive from "./all/RecruitmentDrive";
+import Regicide from "./all/Regicide";
+import RovingElves from "./all/RovingElves";
+import RoyalTrouble from "./all/RoyalTrouble";
+import RumDeal from "./all/RumDeal";
+import ScorpionCatcher from "./all/ScorpionCatcher";
+import Scrambled from "./all/Scrambled";
+import SeaSlug from "./all/SeaSlug";
+import ShadesOfMortton from "./all/ShadesOfMortton";
+import ShadowOfTheStorm from "./all/ShadowOfTheStorm";
+import ShadowsOfCustodia from "./all/ShadowsOfCustodia";
+import SheepHerder from "./all/SheepHerder";
+import ShiloVillage from "./all/ShiloVillage";
+import SlugMenace from "./all/SlugMenace";
+import SongOfTheElves from "./all/SongOfTheElves";
+import SpiritsOfTheElid from "./all/SpiritsOfTheElid";
+import SwanSong from "./all/SwanSong";
+import TaiBwoWannaiTrio from "./all/TaiBwoWannaiTrio";
+import TheAscentOfArceuus from "./all/TheAscentOfArceuus";
+import TheDepthsOfDespair from "./all/TheDepthsOfDespair";
+import TheFinalDawn from "./all/TheFinalDawn";
+import TheForsakenTower from "./all/TheForsakenTower";
+import TheFremennikExiles from "./all/TheFremennikExiles";
+import TheFremennikIsles from "./all/TheFremennikIsles";
+import TheFremennikTrials from "./all/TheFremennikTrials";
+import TheGiantDwarf from "./all/TheGiantDwarf";
+import TheGolem from "./all/TheGolem";
+import TheGrandTree from "./all/TheGrandTree";
+import TheGreatBrainRobbery from "./all/TheGreatBrainRobbery";
+import TheHandInTheSand from "./all/TheHandInTheSand";
+import TheKnightsSword from "./all/TheKnightsSword";
+import TheLostTribe from "./all/TheLostTribe";
+import TheQueenOfThieves from "./all/TheQueenOfThieves";
+import TheSlugMenace from "./all/TheSlugMenace";
+import TheTaleOfTheRighteous from "./all/TheTaleOfTheRighteous";
+import TheTempleOfIkov from "./all/TheTempleOfIkov";
+import TheTouristTrap from "./all/TheTouristTrap";
+import ThroneOfMiscellania from "./all/ThroneOfMiscellania";
+import TowerOfLife from "./all/TowerOfLife";
+import TreeGnomeVillage from "./all/TreeGnomeVillage";
+import TribalTotem from "./all/TribalTotem";
+import TrollRomance from "./all/TrollRomance";
+import TrollStronghold from "./all/TrollStronghold";
+import TroubledTortugans from "./all/TroubledTortugans";
+import UndergroundPass from "./all/UndergroundPass";
+import VampyreSlayer from "./all/VampyreSlayer";
+import Wanted from "./all/Wanted";
+import Watchtower from "./all/Watchtower";
+import WaterfallQuest from "./all/WaterfallQuest";
+import WhatLiesBelow from "./all/WhatLiesBelow";
+import WitchesPotion from "./all/WitchesPotion";
+import WitchsHouse from "./all/WitchsHouse";
+import ZogreFleshEaters from "./all/ZogreFleshEaters";
 /**
  * OSRS Quest utility tool
  *
@@ -81,41 +220,253 @@ class QuestTool {
         return QuestList.map((name) => QuestTool.getQuestByName(name)).filter((q) => q !== undefined && q.miniquest);
     }
     /**
-     * Static utility to get a Quest instance by its name.
-     * This assumes all quests are exported as default from their respective files in quest/all/.
-     * @param questName The name of the quest to retrieve
-     * @returns Quest instance or undefined if not found
+     * Build the quest registry mapping canonical names to quest objects.
+     * Uses QuestList as the source of truth for quest names.
+     * @returns Map of normalized quest names to Quest objects
      */
-    static getQuestByName(questName) {
-        // Normalize quest name to match file naming convention
-        const normalized = questName
-            .replace(/[^a-zA-Z0-9]/g, '') // Remove non-alphanumeric
-            .replace(/\s+/g, '') // Remove spaces
-            .replace(/^./, (c) => c.toUpperCase());
-        try {
-            // Dynamically require the quest file
-            // Note: This only works in Node.js, not in browser environments
-            // and assumes all quest files are named as <QuestName>.ts and exported as default
-            // Example: 'Dragon Slayer' => './all/DragonSlayer'
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
-            const questModule = require(`./all/${normalized}`);
-            const quest = questModule.default || questModule;
+    static buildQuestRegistry() {
+        const registry = new Map();
+        // All available quests imported above
+        const allQuests = {
+            AKingdomDivided,
+            AnimalMagnetism,
+            AnotherSliceOfHAM,
+            APorcineOfInterest,
+            ASoulsBane,
+            ATailOfTwoCats,
+            ATasteOfHope,
+            ATheatreOfBlood,
+            BelowIceMountain,
+            BetweenARock,
+            BigChompyBirdHunting,
+            Biohazard,
+            BlackKnightsFortress,
+            BoneVoyage,
+            CabinFever,
+            ClientOfKourend,
+            ClockTower,
+            ColdWar,
+            Contact,
+            CooksAssistant,
+            CreatureOfFenkenstrain,
+            CurrentAffairs,
+            DarknessOfHallowvale,
+            DeathPlateau,
+            DeathToTheDorgeshuun,
+            DemonSlayer,
+            DesertTreasure,
+            DeviousMinds,
+            DoricQuest,
+            DoricsQuest,
+            DragonSlayerI,
+            DragonSlayerII,
+            DreamMentor,
+            DruidicRitual,
+            DwarfCannon,
+            EadgarsRuse,
+            EaglesPeak,
+            ElementalWorkshopI,
+            ElementalWorkshopII,
+            EnakhrasLament,
+            EnlightenedJourney,
+            FairytaleIGrowingPains,
+            FairytaleIICureAQueen,
+            FamilyCrest,
+            FightArena,
+            FishingContest,
+            ForgettableTale,
+            GardenOfTranquillity,
+            GertrudesCat,
+            GettingAhead,
+            GhostsAhoy,
+            GoblinDiplomacy,
+            GrimTales,
+            HauntedMine,
+            HazeelCult,
+            HeroesQuest,
+            HolyGrail,
+            HorrorFromTheDeep,
+            IcthlarinsLittleHelper,
+            ImpCatcher,
+            InAidOfTheMyreque,
+            InSearchOfTheMyreque,
+            JunglePotion,
+            KingsRansom,
+            LegendsQuest,
+            LostCity,
+            LunarDiplomacy,
+            MakingHistory,
+            MeatAndGreet,
+            MerlinsCrystal,
+            MonkeyMadness,
+            MonkeyMadnessII,
+            MonksFriend,
+            MurderMystery,
+            MyArmsBigAdventure,
+            NatureSpirit,
+            ObservatoryQuest,
+            OlafsQuest,
+            OneSmallFavour,
+            Pandemonium,
+            PlagueCity,
+            PriestInPeril,
+            PryingTimes,
+            RagAndBoneMan,
+            Ratcatchers,
+            RecipeForDisaster,
+            RecruitmentDrive,
+            Regicide,
+            RovingElves,
+            RoyalTrouble,
+            RumDeal,
+            ScorpionCatcher,
+            Scrambled,
+            SeaSlug,
+            ShadesOfMortton,
+            ShadowOfTheStorm,
+            ShadowsOfCustodia,
+            SheepHerder,
+            ShiloVillage,
+            SlugMenace,
+            SongOfTheElves,
+            SpiritsOfTheElid,
+            SwanSong,
+            TaiBwoWannaiTrio,
+            TheAscentOfArceuus,
+            TheDepthsOfDespair,
+            TheFinalDawn,
+            TheForsakenTower,
+            TheFremennikExiles,
+            TheFremennikIsles,
+            TheFremennikTrials,
+            TheGiantDwarf,
+            TheGolem,
+            TheGrandTree,
+            TheGreatBrainRobbery,
+            TheHandInTheSand,
+            TheKnightsSword,
+            TheLostTribe,
+            TheQueenOfThieves,
+            TheSlugMenace,
+            TheTaleOfTheRighteous,
+            TheTempleOfIkov,
+            TheTouristTrap,
+            ThroneOfMiscellania,
+            TowerOfLife,
+            TreeGnomeVillage,
+            TribalTotem,
+            TrollRomance,
+            TrollStronghold,
+            TroubledTortugans,
+            UndergroundPass,
+            VampyreSlayer,
+            Wanted,
+            Watchtower,
+            WaterfallQuest,
+            WhatLiesBelow,
+            WitchesPotion,
+            WitchsHouse,
+            ZogreFleshEaters,
+        };
+        // Map canonical quest names from QuestList to quest objects
+        for (const questName of QuestList) {
+            const quest = QuestTool.findQuestByCanonicalName(questName, allQuests);
             if (quest) {
+                registry.set(QuestTool.normalizeQuestName(questName), quest);
+            }
+        }
+        return registry;
+    }
+    /**
+     * Find the quest object matching a canonical quest name from QuestList.
+     * Uses the quest's name property to match against the canonical name.
+     * @param canonicalName The canonical name from QuestList
+     * @param questMap Map of available quest objects
+     * @returns The matching Quest object or undefined
+     */
+    static findQuestByCanonicalName(canonicalName, questMap) {
+        // Direct match by quest.name property
+        for (const quest of Object.values(questMap)) {
+            if (quest && typeof quest === "object" && "name" in quest && quest["name"] === canonicalName) {
                 return quest;
             }
-            // Handle known quest name variations
-            switch (questName.toLocaleLowerCase()) {
-                case 'a kingdome divided':
-                case 'akingdomdivided':
-                    return AKingdomDivided;
-                default:
-                    return undefined;
+        }
+        return undefined;
+    }
+    /**
+     * Normalize a quest name for comparison purposes.
+     * Removes punctuation, extra spaces, and converts to lowercase.
+     * @param questName The quest name to normalize
+     * @returns Normalized quest name
+     */
+    static normalizeQuestName(questName) {
+        return questName
+            .toLowerCase()
+            .replace(/[^\w\s]/g, "") // Remove punctuation (except word chars and spaces)
+            .replace(/\s+/g, " ") // Normalize spaces
+            .trim();
+    }
+    /**
+     * Calculate Levenshtein distance between two strings for fuzzy matching.
+     * @param str1 First string
+     * @param str2 Second string
+     * @returns Levenshtein distance
+     */
+    static levenshteinDistance(str1, str2) {
+        const matrix = [];
+        for (let i = 0; i <= str2.length; i++) {
+            matrix[i] = [i];
+        }
+        for (let j = 0; j <= str1.length; j++) {
+            matrix[0][j] = j;
+        }
+        for (let i = 1; i <= str2.length; i++) {
+            for (let j = 1; j <= str1.length; j++) {
+                if (str2.charAt(i - 1) === str1.charAt(j - 1)) {
+                    matrix[i][j] = matrix[i - 1][j - 1];
+                }
+                else {
+                    matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // Substitution
+                    matrix[i][j - 1] + 1, // Insertion
+                    matrix[i - 1][j] + 1);
+                }
             }
         }
-        catch (e) {
+        return matrix[str2.length][str1.length];
+    }
+    /**
+     * Get a quest by name with support for fuzzy matching and common variations.
+     * Supports exact matches, case-insensitive matches, and approximate matches.
+     * @param questName The name of the quest to retrieve
+     * @returns Quest instance or undefined if not found
+     */
+    static getQuestByName(questName) {
+        if (!questName || questName.trim() === "") {
             return undefined;
         }
+        // Initialize cache on first use (lazy initialization)
+        if (!QuestTool.questCache) {
+            QuestTool.questCache = QuestTool.buildQuestRegistry();
+        }
+        const normalized = QuestTool.normalizeQuestName(questName);
+        // Try exact match first
+        if (QuestTool.questCache.has(normalized)) {
+            return QuestTool.questCache.get(normalized);
+        }
+        // Try fuzzy matching if exact match fails
+        let bestMatch;
+        let bestDistance = 5; // Threshold for fuzzy matching
+        for (const [registryKey, quest] of QuestTool.questCache.entries()) {
+            const distance = QuestTool.levenshteinDistance(normalized, registryKey);
+            if (distance < bestDistance) {
+                bestDistance = distance;
+                bestMatch = quest;
+            }
+        }
+        return bestMatch;
     }
+    // Static cache for quest registry (initialized lazily)
+    static questCache;
     /**
      * Get the maximum boost for a given skill, based on OSRS Wiki data.
      * @param skillName The name of the skill (case-insensitive, e.g. 'Attack', 'Herblore')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osrs-tools",
-  "version": "2.5.2",
+  "version": "2.5.3",
   "description": "A comprehensive TypeScript library for Old School RuneScape (OSRS) data and utilities, including quest data, skill requirements, and game item information",
   "license": "MIT",
   "scripts": {