osrs-tools 2.8.1 → 2.9.0

package/dist/runescape/model/guilds/hunter/index.js

@@ -0,0 +1,4 @@
+export * from './types';
+export { HunterRumour } from './HunterRumour';
+export { HunterGuildMaster } from './HunterGuildMaster';
+export { HunterGuild } from './HunterGuild';

package/dist/runescape/model/guilds/hunter/types.d.ts

@@ -0,0 +1,32 @@
+export type HunterRumourTier = 'Novice' | 'Adept' | 'Expert' | 'Master';
+export declare const HunterRumourMethods: {
+    readonly BIRD_SNARE: "Bird snare";
+    readonly DEADFALL: "Deadfall";
+    readonly BUTTERFLY_NET: "Butterfly net";
+    readonly NET_TRAP: "Net trap";
+    readonly SPIKED_PIT: "Spiked pit";
+    readonly BOX_TRAP: "Box trap";
+    readonly FALCONRY: "Falconry";
+    readonly TRACKING: "Tracking";
+};
+export type HunterRumourMethod = typeof HunterRumourMethods[keyof typeof HunterRumourMethods];
+import type { RumourLocation } from './RumourLocation';
+export interface HunterRumourDefinition {
+    id: string;
+    creature: string;
+    method: HunterRumourMethod;
+    locations: RumourLocation[];
+    requiredHunterLevel: number;
+    tier: HunterRumourTier;
+    masterNames: string[];
+    questRequirements?: string[];
+    notes?: string;
+    leagueRegions?: string[];
+}
+export interface HunterRumourAssignment {
+    id: string;
+    masterName: string;
+    rumourId: string;
+    assignedAt: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runescape/model/guilds/hunter/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../source/runescape/model/guilds/hunter/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExE,eAAO,MAAM,mBAAmB;;;;;;;;;CAStB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,mBAAmB,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAE9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;CAClB"}

package/dist/runescape/model/guilds/hunter/types.js

@@ -0,0 +1,10 @@
+export const HunterRumourMethods = {
+    BIRD_SNARE: 'Bird snare',
+    DEADFALL: 'Deadfall',
+    BUTTERFLY_NET: 'Butterfly net',
+    NET_TRAP: 'Net trap',
+    SPIKED_PIT: 'Spiked pit',
+    BOX_TRAP: 'Box trap',
+    FALCONRY: 'Falconry',
+    TRACKING: 'Tracking',
+};

package/dist/runescape/model/guilds/index.d.ts

@@ -0,0 +1,2 @@
+export * from './hunter';
+//# sourceMappingURL=index.d.ts.map

package/dist/runescape/model/guilds/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../source/runescape/model/guilds/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/runescape/model/guilds/index.js

@@ -0,0 +1 @@
+export * from './hunter';

package/dist/runescape/model/guilds/types.d.ts

@@ -0,0 +1,44 @@
+export type HunterRumourTier = 'Novice' | 'Adept' | 'Expert' | 'Master';
+export declare const HunterRumourMethods: {
+    readonly BIRD_SNARE: "Bird snare";
+    readonly DEADFALL: "Deadfall";
+    readonly BUTTERFLY_NET: "Butterfly net";
+    readonly NET_TRAP: "Net trap";
+    readonly SPIKED_PIT: "Spiked pit";
+    readonly BOX_TRAP: "Box trap";
+    readonly FALCONRY: "Falconry";
+    readonly TRACKING: "Tracking";
+};
+export type HunterRumourMethod = typeof HunterRumourMethods[keyof typeof HunterRumourMethods];
+import type { RumourLocation } from './RumourLocation';
+export declare const HunterLeagueRegions: {
+    readonly KANDARIN: "Kandarin";
+    readonly VARLAMORE: "Varlamore";
+    readonly FREMENNIK: "Fremennik";
+    readonly KOUREND: "Kourend";
+    readonly MORYTANIA: "Morytania";
+    readonly KARAMJA: "Karamja";
+    readonly DESERT: "Desert";
+    readonly MISHTHALIN: "Misthalin";
+    readonly TIRANNWN: "Tirannwn";
+};
+export type HunterLeagueRegion = typeof HunterLeagueRegions[keyof typeof HunterLeagueRegions];
+export interface HunterRumourDefinition {
+    id: string;
+    creature: string;
+    method: HunterRumourMethod;
+    locations: RumourLocation[];
+    requiredHunterLevel: number;
+    tier: HunterRumourTier;
+    masterNames: string[];
+    questRequirements?: string[];
+    notes?: string;
+    leagueRegions?: HunterLeagueRegion[];
+}
+export interface HunterRumourAssignment {
+    id: string;
+    masterName: string;
+    rumourId: string;
+    assignedAt: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runescape/model/guilds/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../source/runescape/model/guilds/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExE,eAAO,MAAM,mBAAmB;;;;;;;;;CAStB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,mBAAmB,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAE9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,eAAO,MAAM,mBAAmB;;;;;;;;;;CAUtB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,mBAAmB,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAE9F,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,gBAAgB,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;CAClB"}

package/dist/runescape/model/guilds/types.js

@@ -0,0 +1,21 @@
+export const HunterRumourMethods = {
+    BIRD_SNARE: 'Bird snare',
+    DEADFALL: 'Deadfall',
+    BUTTERFLY_NET: 'Butterfly net',
+    NET_TRAP: 'Net trap',
+    SPIKED_PIT: 'Spiked pit',
+    BOX_TRAP: 'Box trap',
+    FALCONRY: 'Falconry',
+    TRACKING: 'Tracking',
+};
+export const HunterLeagueRegions = {
+    KANDARIN: 'Kandarin',
+    VARLAMORE: 'Varlamore',
+    FREMENNIK: 'Fremennik',
+    KOUREND: 'Kourend',
+    MORYTANIA: 'Morytania',
+    KARAMJA: 'Karamja',
+    DESERT: 'Desert',
+    MISHTHALIN: 'Misthalin',
+    TIRANNWN: 'Tirannwn',
+};

package/dist/runescape/model/hunter/HunterRumour.d.ts

@@ -0,0 +1,155 @@
+import { LevelRequirement, Requirement } from "../Requirement";
+/**
+ * Hunting methods used for Hunters' Rumours.
+ * Each method has its own drop rate for rare creature parts.
+ * Reference: https://oldschool.runescape.wiki/w/Hunters%27_Rumours
+ */
+export declare enum HuntingMethod {
+    BirdSnare = "Bird snare",
+    BoxTrap = "Box trap",
+    ButterflyNet = "Butterfly net",
+    Deadfall = "Deadfall",
+    Falconry = "Falconry",
+    NetTrap = "Net trap",
+    SpikedPit = "Spiked pit",
+    TrackingKebbit = "Tracking (kebbit)",
+    TrackingHerbiboar = "Tracking (herbiboar)"
+}
+/**
+ * Tier of a Hunter's Rumour.
+ * Each tier has its own Hunter level requirement and reward quality.
+ */
+export declare enum RumourTier {
+    Novice = "Novice",
+    Adept = "Adept",
+    Expert = "Expert",
+    Master = "Master"
+}
+/**
+ * Hunters' loot sack variants by rumour tier.
+ */
+export declare enum HunterLootSackType {
+    Basic = "Hunters' loot sack (basic)",
+    Adept = "Hunters' loot sack (adept)",
+    Expert = "Hunters' loot sack (expert)",
+    Master = "Hunters' loot sack (master)"
+}
+/**
+ * Guild hunters who assign Hunters' Rumours.
+ * Each hunter has a distinct list of rumours they can assign.
+ */
+export declare enum GuildHunterName {
+    Gilman = "Huntmaster Gilman",
+    Cervus = "Guild Hunter Cervus",
+    Ornus = "Guild Hunter Ornus",
+    Aco = "Guild Hunter Aco",
+    Teco = "Guild Hunter Teco",
+    Wolf = "Guild Hunter Wolf"
+}
+/**
+ * Drop rate data for rare creature parts by hunting method.
+ */
+export interface DropRateInfo {
+    /** Base drop rate denominator (e.g. 20 means 1/20) */
+    baseRate: number;
+    /** Pity threshold without guild hunter outfit */
+    pityThreshold: number;
+    /** Pity threshold with guild hunter outfit */
+    pityThresholdWithOutfit: number;
+}
+/**
+ * A hunter creature that can be hunted for Hunters' Rumours.
+ */
+export interface HunterRumour {
+    /** The creature's name */
+    creature: string;
+    /** Hunter level requirement to hunt this creature (unboostable) */
+    hunterRequirement: LevelRequirement;
+    /** Hunting method used to catch this creature */
+    method: HuntingMethod;
+    /** Locations where this creature can be found */
+    locations: string[];
+    /** Additional requirements beyond Hunter level (quests, other skills, diaries) */
+    requirements: Requirement[];
+}
+/**
+ * A guild hunter who assigns Hunters' Rumours.
+ */
+export interface GuildHunter {
+    /** The guild hunter's full name */
+    name: GuildHunterName;
+    /** The tier of rumours this hunter assigns */
+    tier: RumourTier;
+    /** Hunter level required to receive rumours from this hunter (unboostable) */
+    levelRequired: LevelRequirement;
+    /** Quest required to access this hunter's rumours */
+    questRequired?: string;
+    /** Rumours this guild hunter can assign */
+    rumours: HunterRumour[];
+}
+/**
+ * Loot sack metadata by tier.
+ */
+export interface HunterLootSackInfo {
+    sackType: HunterLootSackType;
+    estimatedGpValue: number;
+    minimumHunterLevel: number;
+    minimumHunterXp: number;
+    maximumHunterXp: number;
+}
+/**
+ * Milestone unlocks from total rumours completed.
+ */
+export interface RumourMilestoneUnlock {
+    rumoursCompleted: number;
+    unlock: string;
+}
+/**
+ * Result returned when opening a hunters' loot sack.
+ */
+export interface OpenLootSackResult {
+    sackType: HunterLootSackType;
+    tier: RumourTier;
+    estimatedGpValue: number;
+    hunterExperience: number;
+    milestonesUnlocked: RumourMilestoneUnlock[];
+}
+/**
+ * Drop rates for rare creature parts by hunting method.
+ * Reference: https://oldschool.runescape.wiki/w/Hunters%27_Rumours#Drop_rates
+ */
+export declare const DROP_RATES: Record<HuntingMethod, DropRateInfo>;
+/**
+ * Experience modifier per rumour tier, used in the reward formula:
+ * Experience = (HunterLevel + 5) * Modifier
+ */
+export declare const TIER_XP_MODIFIER: Record<RumourTier, number>;
+/**
+ * Loot sack metadata from the wiki's rewards table.
+ */
+export declare const HUNTER_LOOT_SACK_INFO: Record<RumourTier, HunterLootSackInfo>;
+/**
+ * Rumour completion milestone unlocks.
+ */
+export declare const RUMOUR_MILESTONE_UNLOCKS: readonly RumourMilestoneUnlock[];
+/**
+ * Calculate the Hunter experience rewarded for completing a rumour.
+ * @param hunterLevel - The player's current Hunter level
+ * @param tier - The tier of the completed rumour
+ * @returns The experience awarded
+ */
+export declare function calculateRumourExperience(hunterLevel: number, tier: RumourTier): number;
+/**
+ * Create an unboostable Hunter level requirement helper.
+ */
+export declare function createHunterLevelRequirement(level: number): LevelRequirement;
+/**
+ * Get milestones unlocked at a total rumour completion count.
+ */
+export declare function getMilestoneUnlocks(rumoursCompleted: number): RumourMilestoneUnlock[];
+/**
+ * Open a hunters' loot sack for a completed rumour.
+ * Returns deterministic reward metadata and XP calculation from official formula.
+ */
+export declare function openHuntersLootSack(tier: RumourTier, hunterLevel: number, rumoursCompleted?: number): OpenLootSackResult;
+//# sourceMappingURL=HunterRumour.d.ts.map

package/dist/runescape/model/hunter/HunterRumour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HunterRumour.d.ts","sourceRoot":"","sources":["../../../../source/runescape/model/hunter/HunterRumour.ts"],"names":[],"mappings":"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"}

package/dist/runescape/model/hunter/HunterRumour.js

@@ -0,0 +1,183 @@
+import { LevelRequirement } from "../Requirement";
+import { Skill } from "../account/Skill";
+/**
+ * Hunting methods used for Hunters' Rumours.
+ * Each method has its own drop rate for rare creature parts.
+ * Reference: https://oldschool.runescape.wiki/w/Hunters%27_Rumours
+ */
+export var HuntingMethod;
+(function (HuntingMethod) {
+    HuntingMethod["BirdSnare"] = "Bird snare";
+    HuntingMethod["BoxTrap"] = "Box trap";
+    HuntingMethod["ButterflyNet"] = "Butterfly net";
+    HuntingMethod["Deadfall"] = "Deadfall";
+    HuntingMethod["Falconry"] = "Falconry";
+    HuntingMethod["NetTrap"] = "Net trap";
+    HuntingMethod["SpikedPit"] = "Spiked pit";
+    HuntingMethod["TrackingKebbit"] = "Tracking (kebbit)";
+    HuntingMethod["TrackingHerbiboar"] = "Tracking (herbiboar)";
+})(HuntingMethod || (HuntingMethod = {}));
+/**
+ * Tier of a Hunter's Rumour.
+ * Each tier has its own Hunter level requirement and reward quality.
+ */
+export var RumourTier;
+(function (RumourTier) {
+    RumourTier["Novice"] = "Novice";
+    RumourTier["Adept"] = "Adept";
+    RumourTier["Expert"] = "Expert";
+    RumourTier["Master"] = "Master";
+})(RumourTier || (RumourTier = {}));
+/**
+ * Hunters' loot sack variants by rumour tier.
+ */
+export var HunterLootSackType;
+(function (HunterLootSackType) {
+    HunterLootSackType["Basic"] = "Hunters' loot sack (basic)";
+    HunterLootSackType["Adept"] = "Hunters' loot sack (adept)";
+    HunterLootSackType["Expert"] = "Hunters' loot sack (expert)";
+    HunterLootSackType["Master"] = "Hunters' loot sack (master)";
+})(HunterLootSackType || (HunterLootSackType = {}));
+/**
+ * Guild hunters who assign Hunters' Rumours.
+ * Each hunter has a distinct list of rumours they can assign.
+ */
+export var GuildHunterName;
+(function (GuildHunterName) {
+    GuildHunterName["Gilman"] = "Huntmaster Gilman";
+    GuildHunterName["Cervus"] = "Guild Hunter Cervus";
+    GuildHunterName["Ornus"] = "Guild Hunter Ornus";
+    GuildHunterName["Aco"] = "Guild Hunter Aco";
+    GuildHunterName["Teco"] = "Guild Hunter Teco";
+    GuildHunterName["Wolf"] = "Guild Hunter Wolf";
+})(GuildHunterName || (GuildHunterName = {}));
+/**
+ * Drop rates for rare creature parts by hunting method.
+ * Reference: https://oldschool.runescape.wiki/w/Hunters%27_Rumours#Drop_rates
+ */
+export const DROP_RATES = {
+    [HuntingMethod.BirdSnare]: { baseRate: 20, pityThreshold: 40, pityThresholdWithOutfit: 38 },
+    [HuntingMethod.BoxTrap]: { baseRate: 50, pityThreshold: 100, pityThresholdWithOutfit: 94 },
+    [HuntingMethod.ButterflyNet]: { baseRate: 75, pityThreshold: 150, pityThresholdWithOutfit: 142 },
+    [HuntingMethod.Deadfall]: { baseRate: 15, pityThreshold: 30, pityThresholdWithOutfit: 28 },
+    [HuntingMethod.Falconry]: { baseRate: 10, pityThreshold: 20, pityThresholdWithOutfit: 18 },
+    [HuntingMethod.NetTrap]: { baseRate: 25, pityThreshold: 50, pityThresholdWithOutfit: 46 },
+    [HuntingMethod.SpikedPit]: { baseRate: 15, pityThreshold: 30, pityThresholdWithOutfit: 28 },
+    [HuntingMethod.TrackingKebbit]: { baseRate: 15, pityThreshold: 30, pityThresholdWithOutfit: 28 },
+    [HuntingMethod.TrackingHerbiboar]: { baseRate: 7, pityThreshold: 14, pityThresholdWithOutfit: 12 },
+};
+/**
+ * Experience modifier per rumour tier, used in the reward formula:
+ * Experience = (HunterLevel + 5) * Modifier
+ */
+export const TIER_XP_MODIFIER = {
+    [RumourTier.Novice]: 50,
+    [RumourTier.Adept]: 50,
+    [RumourTier.Expert]: 55,
+    [RumourTier.Master]: 60,
+};
+/**
+ * Loot sack metadata from the wiki's rewards table.
+ */
+export const HUNTER_LOOT_SACK_INFO = {
+    [RumourTier.Novice]: {
+        sackType: HunterLootSackType.Basic,
+        estimatedGpValue: 7705.71,
+        minimumHunterLevel: 46,
+        minimumHunterXp: 2550,
+        maximumHunterXp: 5200,
+    },
+    [RumourTier.Adept]: {
+        sackType: HunterLootSackType.Adept,
+        estimatedGpValue: 21802.42,
+        minimumHunterLevel: 57,
+        minimumHunterXp: 3100,
+        maximumHunterXp: 5200,
+    },
+    [RumourTier.Expert]: {
+        sackType: HunterLootSackType.Expert,
+        estimatedGpValue: 28609.94,
+        minimumHunterLevel: 72,
+        minimumHunterXp: 4235,
+        maximumHunterXp: 5720,
+    },
+    [RumourTier.Master]: {
+        sackType: HunterLootSackType.Master,
+        estimatedGpValue: 34604.61,
+        minimumHunterLevel: 91,
+        minimumHunterXp: 5760,
+        maximumHunterXp: 6240,
+    },
+};
+/**
+ * Rumour completion milestone unlocks.
+ */
+export const RUMOUR_MILESTONE_UNLOCKS = [
+    {
+        rumoursCompleted: 10,
+        unlock: "A basic quetzal whistle blueprint from Soar Leader Pitri, to craft a basic quetzal whistle.",
+    },
+    {
+        rumoursCompleted: 25,
+        unlock: "The ability to cook raw graahk, raw kyatt, and raw pyre foxes.",
+    },
+    {
+        rumoursCompleted: 50,
+        unlock: "The ability to cook raw dashing kebbit, raw sunlight antelope, and raw moonlight antelope.",
+    },
+    {
+        rumoursCompleted: 50,
+        unlock: "A tattered request note from Guildmaster Apatura.",
+    },
+    {
+        rumoursCompleted: 100,
+        unlock: "A torn enhanced quetzal whistle blueprint from any hunters' loot sack, to craft an enhanced quetzal whistle.",
+    },
+    {
+        rumoursCompleted: 100,
+        unlock: "A guild history excerpt from Guildmaster Apatura.",
+    },
+    {
+        rumoursCompleted: 150,
+        unlock: "A special chest key from Guildmaster Apatura.",
+    },
+    {
+        rumoursCompleted: 250,
+        unlock: "A torn perfected quetzal whistle blueprint from any expert or master hunters' loot sack, to craft a perfected quetzal whistle.",
+    },
+];
+/**
+ * Calculate the Hunter experience rewarded for completing a rumour.
+ * @param hunterLevel - The player's current Hunter level
+ * @param tier - The tier of the completed rumour
+ * @returns The experience awarded
+ */
+export function calculateRumourExperience(hunterLevel, tier) {
+    return (hunterLevel + 5) * TIER_XP_MODIFIER[tier];
+}
+/**
+ * Create an unboostable Hunter level requirement helper.
+ */
+export function createHunterLevelRequirement(level) {
+    return new LevelRequirement(Skill.Hunter, level, false);
+}
+/**
+ * Get milestones unlocked at a total rumour completion count.
+ */
+export function getMilestoneUnlocks(rumoursCompleted) {
+    return RUMOUR_MILESTONE_UNLOCKS.filter((milestone) => milestone.rumoursCompleted === rumoursCompleted);
+}
+/**
+ * Open a hunters' loot sack for a completed rumour.
+ * Returns deterministic reward metadata and XP calculation from official formula.
+ */
+export function openHuntersLootSack(tier, hunterLevel, rumoursCompleted = 0) {
+    const info = HUNTER_LOOT_SACK_INFO[tier];
+    return {
+        sackType: info.sackType,
+        tier,
+        estimatedGpValue: info.estimatedGpValue,
+        hunterExperience: calculateRumourExperience(hunterLevel, tier),
+        milestonesUnlocked: getMilestoneUnlocks(rumoursCompleted),
+    };
+}

package/dist/runescape/model/hunter/HunterRumours.d.ts

@@ -0,0 +1,70 @@
+import { GuildHunter, HunterRumour, RumourTier } from "./HunterRumour";
+/** All hunter rumours sorted by Hunter level */
+export declare const ALL_RUMOURS: readonly HunterRumour[];
+/**
+ * Huntmaster Gilman (Novice) - Can assign all rumours.
+ */
+export declare const Gilman: GuildHunter;
+/**
+ * Guild Hunter Cervus (Adept) - Has a distinct adept rumour list.
+ */
+export declare const Cervus: GuildHunter;
+/**
+ * Guild Hunter Ornus (Adept) - Has a distinct adept rumour list.
+ */
+export declare const Ornus: GuildHunter;
+/**
+ * Guild Hunter Aco (Expert) - Has a distinct expert rumour list.
+ */
+export declare const Aco: GuildHunter;
+/**
+ * Guild Hunter Teco (Expert) - Has a distinct expert rumour list.
+ */
+export declare const Teco: GuildHunter;
+/**
+ * Guild Hunter Wolf (Master) - Requires completion of At First Light.
+ */
+export declare const Wolf: GuildHunter;
+/** All guild hunters */
+export declare const ALL_GUILD_HUNTERS: readonly GuildHunter[];
+/**
+ * Get a guild hunter by name.
+ * @param name - The guild hunter's name (enum or string)
+ * @returns The guild hunter, or undefined if not found
+ */
+export declare function getGuildHunterByName(name: string): GuildHunter | undefined;
+/**
+ * Get all guild hunters for a specific tier.
+ * @param tier - The rumour tier
+ * @returns Array of guild hunters for that tier
+ */
+export declare function getGuildHuntersByTier(tier: RumourTier): GuildHunter[];
+/**
+ * Get the available rumours for a guild hunter, excluding any creatures
+ * already assigned as active rumours from other hunters.
+ *
+ * This implements the "blocking" mechanic: players cannot receive the same
+ * task from multiple guild hunters at once. By obtaining a task from one
+ * hunter first, it is blocked from appearing with another.
+ *
+ * Example: If Gilman assigns "Swamp lizard", Cervus cannot assign "Swamp lizard"
+ * until the Gilman assignment is completed or reset.
+ *
+ * @param hunter - The guild hunter to get available rumours for
+ * @param activeRumours - Rumours currently assigned from other guild hunters
+ * @returns Rumours the hunter can assign, excluding blocked ones
+ */
+export declare function getAvailableRumours(hunter: GuildHunter, activeRumours?: HunterRumour[]): HunterRumour[];
+/**
+ * Find a rumour by creature name.
+ * @param creature - The creature name to search for (case-insensitive)
+ * @returns The matching rumour, or undefined if not found
+ */
+export declare function getRumourByCreature(creature: string): HunterRumour | undefined;
+/**
+ * Get all guild hunters that can assign a specific rumour.
+ * @param rumour - The rumour to check
+ * @returns Array of guild hunters who include this rumour in their list
+ */
+export declare function getHuntersForRumour(rumour: HunterRumour): GuildHunter[];
+//# sourceMappingURL=HunterRumours.d.ts.map

package/dist/runescape/model/hunter/HunterRumours.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HunterRumours.d.ts","sourceRoot":"","sources":["../../../../source/runescape/model/hunter/HunterRumours.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAmB,YAAY,EAAiB,UAAU,EAAgC,MAAM,gBAAgB,CAAC;AA0OrI,gDAAgD;AAChD,eAAO,MAAM,WAAW,EAAE,SAAS,YAAY,EA6B9C,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,WAKpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,WAKpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,WAKnB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,GAAG,EAAE,WAKjB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,WAKlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,WAMlB,CAAC;AAEF,wBAAwB;AACxB,eAAO,MAAM,iBAAiB,EAAE,SAAS,WAAW,EAA6C,CAAC;AAIlG;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,CAErE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,aAAa,GAAE,YAAY,EAAO,GAAG,YAAY,EAAE,CAG3G;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAG9E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,EAAE,CAEvE"}