coh-content-db 2.0.0-rc.4 → 2.0.0-rc.6

package/dist/coh-content-db.js

@@ -1,13 +1,17 @@
 'use strict';
 
-var MiniSearch = require('minisearch');
-
 const ALIGNMENT = ["H", "V", "P"];
 
-const BADGE_PARTIAL_TYPE = [
+const BADGE_REQUIREMENT_TYPE = [
   "PLAQUE",
   "BADGE",
   "INVENTION",
+  "MISSION",
+  // Complete a mission
+  "ARC",
+  // Complete a story arc
+  "TASK_FORCE",
+  // Complete a task force
   "INVENTION_PLUS_ONE"
   // Some invention badges require you to build x of two different invention levels, 'plus one of either level'.
 ];
@@ -66,115 +70,60 @@ const PLAQUE_TYPE = [
 
 const SEX = ["M", "F"];
 
-var __typeError$3 = (msg) => {
-  throw TypeError(msg);
-};
-var __accessCheck$3 = (obj, member, msg) => member.has(obj) || __typeError$3("Cannot " + msg);
-var __privateGet$3 = (obj, member, getter) => (__accessCheck$3(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
-var __privateAdd$3 = (obj, member, value) => member.has(obj) ? __typeError$3("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
-var __privateSet$2 = (obj, member, value, setter) => (__accessCheck$3(obj, member, "write to private field"), member.set(obj, value), value);
-var __privateMethod$1 = (obj, member, method) => (__accessCheck$3(obj, member, "access private method"), method);
-var _value, _Key_instances, validateKey_fn;
-const INVALID_KEY_PATTERN = /[^a-z0-9-]/;
-class Key {
-  constructor(value) {
-    __privateAdd$3(this, _Key_instances);
-    __privateAdd$3(this, _value);
-    __privateMethod$1(this, _Key_instances, validateKey_fn).call(this, value);
-    __privateSet$2(this, _value, value);
-  }
-  get value() {
-    return __privateGet$3(this, _value);
-  }
-}
-_value = new WeakMap();
-_Key_instances = new WeakSet();
-validateKey_fn = function(key) {
-  if (INVALID_KEY_PATTERN.test(key)) throw new Error(`Invalid key: [${key}]; Keys can only contain lowercase characters, numbers and dashes.`);
-};
-
-var __defProp$8 = Object.defineProperty;
-var __defNormalProp$8 = (obj, key, value) => key in obj ? __defProp$8(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$8 = (obj, key, value) => __defNormalProp$8(obj, typeof key !== "symbol" ? key + "" : key, value);
-class Archetype {
-  constructor(data) {
-    __publicField$8(this, "key");
-    __publicField$8(this, "name");
-    __publicField$8(this, "description");
-    this.key = new Key(data.key).value;
-    this.name = data.name;
-    this.description = data.description;
-  }
-}
-
 var __defProp$7 = Object.defineProperty;
 var __defNormalProp$7 = (obj, key, value) => key in obj ? __defProp$7(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField$7 = (obj, key, value) => __defNormalProp$7(obj, typeof key !== "symbol" ? key + "" : key, value);
-class BadgePartial {
-  constructor(data) {
-    __publicField$7(this, "key");
-    __publicField$7(this, "type");
-    __publicField$7(this, "mapKey");
-    __publicField$7(this, "loc");
-    __publicField$7(this, "plaqueType");
-    __publicField$7(this, "inscription");
-    __publicField$7(this, "vidiotMapKey");
-    __publicField$7(this, "badgeKey");
-    __publicField$7(this, "inventionLevel");
-    __publicField$7(this, "inventionTypes");
-    __publicField$7(this, "inventionCount");
-    __publicField$7(this, "notes");
-    this.key = new Key(data.key).value;
-    this.type = data.type;
-    this.mapKey = data.mapKey;
-    this.loc = data.loc;
-    this.plaqueType = data.plaqueType;
-    this.inscription = data.inscription;
-    this.vidiotMapKey = data.vidiotMapKey;
-    this.badgeKey = data.badgeKey;
-    this.inventionLevel = data.inventionLevel;
-    this.inventionTypes = data.inventionTypes;
-    this.inventionCount = data.inventionCount;
-    this.notes = data.notes;
+class Alignments {
+  constructor(raw) {
+    __publicField$7(this, "items");
+    __publicField$7(this, "hero");
+    __publicField$7(this, "villain");
+    __publicField$7(this, "praetorian");
+    __publicField$7(this, "primal");
+    this.items = raw;
+    this.hero = raw.includes("H");
+    this.villain = raw.includes("V");
+    this.praetorian = raw.includes("P");
+    this.primal = !this.praetorian && (this.hero || this.villain);
   }
 }
 
-var __typeError$2 = (msg) => {
+var __typeError$4 = (msg) => {
   throw TypeError(msg);
 };
-var __accessCheck$2 = (obj, member, msg) => member.has(obj) || __typeError$2("Cannot " + msg);
-var __privateGet$2 = (obj, member, getter) => (__accessCheck$2(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
-var __privateAdd$2 = (obj, member, value) => member.has(obj) ? __typeError$2("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
-var __privateSet$1 = (obj, member, value, setter) => (__accessCheck$2(obj, member, "write to private field"), member.set(obj, value), value);
-var __privateMethod = (obj, member, method) => (__accessCheck$2(obj, member, "access private method"), method);
+var __accessCheck$4 = (obj, member, msg) => member.has(obj) || __typeError$4("Cannot " + msg);
+var __privateGet$4 = (obj, member, getter) => (__accessCheck$4(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd$4 = (obj, member, value) => member.has(obj) ? __typeError$4("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet$3 = (obj, member, value, setter) => (__accessCheck$4(obj, member, "write to private field"), member.set(obj, value), value);
+var __privateMethod$2 = (obj, member, method) => (__accessCheck$4(obj, member, "access private method"), method);
 var _sortedValues, _Alternates_instances, compareAlternates_fn, compareAlignment_fn, compareSex_fn;
 const ALIGNMENT_SORT = { H: 2, V: 1, P: 0 };
 const SEX_SORT = { M: 1, F: 0 };
 class Alternates {
   constructor(values) {
-    __privateAdd$2(this, _Alternates_instances);
-    __privateAdd$2(this, _sortedValues, []);
-    __privateSet$1(this, _sortedValues, values.sort());
-    __privateGet$2(this, _sortedValues).sort((a, b) => __privateMethod(this, _Alternates_instances, compareAlternates_fn).call(this, a, b));
+    __privateAdd$4(this, _Alternates_instances);
+    __privateAdd$4(this, _sortedValues, []);
+    __privateSet$3(this, _sortedValues, values.sort());
+    __privateGet$4(this, _sortedValues).sort((a, b) => __privateMethod$2(this, _Alternates_instances, compareAlternates_fn).call(this, a, b));
   }
   getValue(alignment, sex) {
-    for (let index = __privateGet$2(this, _sortedValues).length; index--; ) {
-      const entry = __privateGet$2(this, _sortedValues)[index];
+    for (let index = __privateGet$4(this, _sortedValues).length; index--; ) {
+      const entry = __privateGet$4(this, _sortedValues)[index];
       if ((entry.alignment === void 0 || entry.alignment === alignment) && (entry.sex === void 0 || entry.sex === sex)) return entry.value;
     }
-    return this.default;
+    return this.default?.value;
   }
   /**
    * Get the default value for this list of alternates, the value with the highest priority and lowest specificity.
    */
   get default() {
-    return __privateGet$2(this, _sortedValues)[0]?.value;
+    return __privateGet$4(this, _sortedValues)[0];
   }
   /**
    * Get the list of alternates sorted in canonical order (alignment then sex, low to high specificity).
    */
   get canonical() {
-    return __privateGet$2(this, _sortedValues);
+    return __privateGet$4(this, _sortedValues);
   }
   /**
    * Create a joined string from the alternate values in canonical order.
@@ -190,9 +139,9 @@ compareAlternates_fn = function(a, b) {
   const aSpecificity = (a.alignment ? 2 : 0) + (a.sex ? 1 : 0);
   const bSpecificity = (b.alignment ? 2 : 0) + (b.sex ? 1 : 0);
   if (aSpecificity !== bSpecificity) return aSpecificity - bSpecificity;
-  const alignmentComparison = __privateMethod(this, _Alternates_instances, compareAlignment_fn).call(this, a.alignment, b.alignment);
+  const alignmentComparison = __privateMethod$2(this, _Alternates_instances, compareAlignment_fn).call(this, a.alignment, b.alignment);
   if (alignmentComparison !== 0) return alignmentComparison;
-  const sexComparison = __privateMethod(this, _Alternates_instances, compareSex_fn).call(this, a.sex, b.sex);
+  const sexComparison = __privateMethod$2(this, _Alternates_instances, compareSex_fn).call(this, a.sex, b.sex);
   if (sexComparison !== 0) return sexComparison;
   return String(a.value).localeCompare(String(b.value));
 };
@@ -202,8 +151,7 @@ compareAlignment_fn = function(a, b) {
   if (b === void 0 && a !== void 0) return 1;
   const aSort = a === void 0 ? -1 : ALIGNMENT_SORT[a] ?? -1;
   const bSort = b === void 0 ? -1 : ALIGNMENT_SORT[b] ?? -1;
-  if (aSort !== bSort) return bSort - aSort;
-  return a?.localeCompare(b ?? "") ?? 0;
+  return bSort - aSort;
 };
 compareSex_fn = function(a, b) {
   if (a === b) return 0;
@@ -211,242 +159,353 @@ compareSex_fn = function(a, b) {
   if (b === void 0 && a !== void 0) return 1;
   const aSort = SEX_SORT[a ?? -1] ?? -1;
   const bSort = SEX_SORT[b ?? -1] ?? -1;
-  if (aSort !== bSort) return bSort - aSort;
-  return a?.localeCompare(b ?? "") ?? 0;
+  return bSort - aSort;
 };
 
-var __defProp$6 = Object.defineProperty;
-var __typeError$1 = (msg) => {
+var __typeError$3 = (msg) => {
   throw TypeError(msg);
 };
+var __accessCheck$3 = (obj, member, msg) => member.has(obj) || __typeError$3("Cannot " + msg);
+var __privateGet$3 = (obj, member, getter) => (__accessCheck$3(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd$3 = (obj, member, value) => member.has(obj) ? __typeError$3("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet$2 = (obj, member, value, setter) => (__accessCheck$3(obj, member, "write to private field"), member.set(obj, value), value);
+var __privateMethod$1 = (obj, member, method) => (__accessCheck$3(obj, member, "access private method"), method);
+var _value, _Key_instances, validateKey_fn;
+const INVALID_KEY_PATTERN = /[^a-z0-9-]/;
+class Key {
+  constructor(value) {
+    __privateAdd$3(this, _Key_instances);
+    __privateAdd$3(this, _value);
+    __privateMethod$1(this, _Key_instances, validateKey_fn).call(this, value);
+    __privateSet$2(this, _value, value);
+  }
+  get value() {
+    return __privateGet$3(this, _value);
+  }
+}
+_value = new WeakMap();
+_Key_instances = new WeakSet();
+validateKey_fn = function(key) {
+  if (INVALID_KEY_PATTERN.test(key)) throw new Error(`Invalid key: [${key}]; Keys can only contain lowercase characters, numbers and dashes.`);
+};
+
+var __defProp$6 = Object.defineProperty;
 var __defNormalProp$6 = (obj, key, value) => key in obj ? __defProp$6(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField$6 = (obj, key, value) => __defNormalProp$6(obj, typeof key !== "symbol" ? key + "" : key, value);
-var __accessCheck$1 = (obj, member, msg) => member.has(obj) || __typeError$1("Cannot " + msg);
-var __privateGet$1 = (obj, member, getter) => (__accessCheck$1(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
-var __privateAdd$1 = (obj, member, value) => member.has(obj) ? __typeError$1("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
-var _partialsIndex;
-class Badge {
+class Archetype {
   constructor(data) {
-    __privateAdd$1(this, _partialsIndex, {});
-    /**
-     * The database key for this badge.
-     */
     __publicField$6(this, "key");
+    __publicField$6(this, "name");
+    __publicField$6(this, "description");
+    this.key = new Key(data.key).value;
+    this.name = data.name;
+    this.description = data.description;
+  }
+}
+
+var __defProp$5 = Object.defineProperty;
+var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$5 = (obj, key, value) => __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
+class BadgeRequirement {
+  constructor(data) {
     /**
-     * The type of badge.
+     * Key.
      */
-    __publicField$6(this, "type");
+    __publicField$5(this, "key");
     /**
-     * The name of this badge.
-     *
-     * May vary by character sex or alignment.
+     * Type of requirement.
      */
-    __publicField$6(this, "name");
+    __publicField$5(this, "type");
     /**
-     * The character alignments that this badge is available to.
+     * Zone the requirement is located in.
      */
-    __publicField$6(this, "alignment");
+    __publicField$5(this, "zoneKey");
     /**
-     * The badge text as it appears in-game. May vary by character sex or alignment.
+     * /loc coordinates.
      */
-    __publicField$6(this, "badgeText");
+    __publicField$5(this, "loc");
     /**
-     * Description of how to acquire the badge.
-     *
-     * Supports {@link https://www.markdownguide.org/|Markdown} format.
+     * Is it a wall plaque or a physical monument?
      */
-    __publicField$6(this, "acquisition");
+    __publicField$5(this, "plaqueType");
     /**
-     * Absolute URL to this badge's icon.
-     *
-     * May vary by character sex or alignment.
+     * Plaque inscription.
      */
-    __publicField$6(this, "icon");
+    __publicField$5(this, "plaqueInscription");
     /**
-     * Freeform notes or tips about the badge.
-     *
-     * Supports {@link https://www.markdownguide.org/|Markdown} format.
+     * The number or letter the plaque appears as on Vidiot Maps.
      */
-    __publicField$6(this, "notes");
+    __publicField$5(this, "vidiotMapKey");
     /**
-     * List of external links for this Badge. Wiki, forums, etc.
+     * The key of the badge for this requirement.
      */
-    __publicField$6(this, "links");
+    __publicField$5(this, "badgeKey");
     /**
-     * For exploration badges, the key of the {@link GameMap} that this badge is found on.
+     * Mission name.
      */
-    __publicField$6(this, "mapKey");
+    __publicField$5(this, "missionName");
     /**
-     * For exploration badges, the `/loc` coordinates of the badge on the in-game map.
+     * {@link Contact} key for the story arc.
      */
-    __publicField$6(this, "loc");
+    __publicField$5(this, "contactKey");
     /**
-     * For badges that appear on a Vidiot Map, the number or letter the badge appears as.
+     * Level of the invention required.
      */
-    __publicField$6(this, "vidiotMapKey");
+    __publicField$5(this, "inventionLevel");
     /**
-     * ID used with the in-game `/settitle` command to apply the badge.
+     * The types of enhancements required to be crafted.
      */
-    __publicField$6(this, "setTitle");
+    __publicField$5(this, "inventionTypes");
     /**
-     * A description of the effect the badge will have, such as a buff or granting a temporary power.
-     *
-     * Supports {@link https://www.markdownguide.org/|Markdown} format.
+     * Number of invention crafts required.
      */
-    __publicField$6(this, "effect");
+    __publicField$5(this, "inventionCount");
     /**
-     * A list of requirements for badges that have partial fulfilment steps, such as visiting plaques for history badges, or collecting other badges for meta-badges like accolades.
+     * Any additional notes.
      */
-    __publicField$6(this, "partials");
+    __publicField$5(this, "notes");
     /**
-     * Some badges are not included in the badge total count... such as Flames of Prometheus, which can be removed by redeeming it for a Notice of the Well.
+     * List of external links. Wiki, forums, etc.
      */
-    __publicField$6(this, "ignoreInTotals");
+    __publicField$5(this, "links");
     this.key = new Key(data.key).value;
     this.type = data.type;
-    this.name = new Alternates(data.name);
-    this.alignment = data.alignment;
-    this.badgeText = new Alternates(data.badgeText ?? []);
-    this.acquisition = data.acquisition;
-    this.icon = new Alternates(data.icon ?? []);
-    this.notes = data.notes;
-    this.links = data.links;
-    this.mapKey = data.mapKey;
+    this.zoneKey = data.zoneKey;
     this.loc = data.loc;
-    this.effect = data.effect;
+    this.plaqueType = data.plaqueType;
+    this.plaqueInscription = data.plaqueInscription;
     this.vidiotMapKey = data.vidiotMapKey;
-    this.setTitle = data.setTitle;
-    this.ignoreInTotals = data.ignoreInTotals ?? false;
-    this.partials = data.partials?.map((data2) => {
-      if (__privateGet$1(this, _partialsIndex)[data2.key] !== void 0) throw new Error(`Duplicate badge partial key [${data2.key}]`);
-      const badge = new BadgePartial(data2);
-      __privateGet$1(this, _partialsIndex)[badge.key] = badge;
-      return badge;
-    });
-  }
-  getPartial(key) {
-    const result = __privateGet$1(this, _partialsIndex)[key];
-    if (result === void 0) throw new Error(`Unknown badge partial key [${key}]`);
-    return result;
+    this.badgeKey = data.badgeKey;
+    this.missionName = data.missionName;
+    this.contactKey = data.contactKey;
+    this.inventionLevel = data.inventionLevel;
+    this.inventionTypes = data.inventionTypes;
+    this.inventionCount = data.inventionCount;
+    this.notes = data.notes;
+    this.links = data.links ?? [];
   }
 }
-_partialsIndex = new WeakMap();
 
-var __defProp$5 = Object.defineProperty;
-var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$5 = (obj, key, value) => __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
-class VidiotMapPointOfInterest {
-  constructor(data) {
+var __defProp$4 = Object.defineProperty;
+var __typeError$2 = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$4 = (obj, key, value) => __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __accessCheck$2 = (obj, member, msg) => member.has(obj) || __typeError$2("Cannot " + msg);
+var __privateGet$2 = (obj, member, getter) => (__accessCheck$2(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd$2 = (obj, member, value) => member.has(obj) ? __typeError$2("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var _requirementsIndex;
+class Badge {
+  constructor(badgeData) {
+    __privateAdd$2(this, _requirementsIndex, {});
     /**
-     * The pixel-space position of the PoI on the map graphic.
-     *
-     * Screen-space, pixels from top-left `[0, 0]`.
+     * The database key for this badge.
      */
-    __publicField$5(this, "pos");
+    __publicField$4(this, "key");
     /**
-     * Freeform notes about the PoI.
+     * The type of badge.
+     */
+    __publicField$4(this, "type");
+    /**
+     * The name of this badge.
      *
-     * Supports {@link https://www.markdownguide.org/|Markdown} format.
+     * May vary by character sex or alignment.
      */
-    __publicField$5(this, "notes");
+    __publicField$4(this, "name");
     /**
-     * If the POI is a zone transfer, the map it transfers to.
+     * The character alignments that this badge is available to.
      */
-    __publicField$5(this, "mapKey");
+    __publicField$4(this, "alignment");
     /**
-     * If the POI is a badge, the badge.
+     * The badge text as it appears in-game. May vary by character sex or alignment.
      */
-    __publicField$5(this, "badgeKey");
+    __publicField$4(this, "badgeText");
     /**
-     * If the POI is a partial for a badge, the partial key.
+     * Short description of how to acquire the badge. Detailed instructions will be in the notes field.
      */
-    __publicField$5(this, "badgePartialKey");
-    this.pos = data.pos;
-    this.notes = data.notes;
-    this.mapKey = data.mapKey;
-    this.badgeKey = data.badgeKey;
-    this.badgePartialKey = data.badgePartialKey;
-  }
-}
-
-var __defProp$4 = Object.defineProperty;
-var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$4 = (obj, key, value) => __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
-class VidiotMap {
-  constructor(data) {
+    __publicField$4(this, "acquisition");
     /**
-     * URL of the map image.
+     * Absolute URL to this badge's icon.
+     *
+     * May vary by character sex or alignment.
      */
-    __publicField$4(this, "imageUrl");
+    __publicField$4(this, "icon");
     /**
-     * Name to display for the Vidiot map.
+     * Freeform notes or tips about the badge.
      */
-    __publicField$4(this, "name");
+    __publicField$4(this, "notes");
     /**
-     * List of Points of Interest labelled on the image.
+     * List of external links. Wiki, forums, etc.
      */
-    __publicField$4(this, "pointsOfInterest");
-    this.imageUrl = data.imageUrl;
-    this.name = data.name;
-    this.pointsOfInterest = data.pointsOfInterest?.map((data2) => new VidiotMapPointOfInterest(data2));
-  }
-}
-
-var __defProp$3 = Object.defineProperty;
-var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$3 = (obj, key, value) => __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
-class GameMap {
-  constructor(data) {
+    __publicField$4(this, "links");
     /**
-     * The database key for this map.
+     * For exploration badges, the key of the {@link Zone} that this badge is found on.
      */
-    __publicField$3(this, "key");
+    __publicField$4(this, "zoneKey");
     /**
-     * The name of the map as it appears in-game.
+     * For exploration badges, the `/loc` coordinates of the badge.
      */
-    __publicField$3(this, "name");
+    __publicField$4(this, "loc");
     /**
-     * List of external links for this Map. Wiki, forums, etc.
+     * For plaques that appear on a Vidiot Map, the number or letter the badge appears as.
      */
-    __publicField$3(this, "links");
+    __publicField$4(this, "vidiotMapKey");
     /**
-     * List of Vidiot Map assets for this map.
+     * ID used with the in-game `/settitle` command to apply the badge.
      */
-    __publicField$3(this, "vidiotMaps");
-    this.key = new Key(data.key).value;
-    this.name = data.name;
-    this.links = data.links;
-    this.vidiotMaps = data.vidiotMaps?.map((data2) => new VidiotMap(data2));
+    __publicField$4(this, "setTitle");
+    /**
+     * A description of the effect the badge will have, such as a buff or granting a temporary power.
+     */
+    __publicField$4(this, "effect");
+    /**
+     * Represents the layered requirements for badges with multiple fulfillment steps,
+     * such as visiting plaques for history badges or collecting other badges.
+     *
+     * The outer array represents groups of requirements evaluated with OR logic —
+     * fulfilling any group satisfies the badge.
+     *
+     * Each inner array represents individual requirements evaluated with AND logic —
+     * all conditions in the group must be met.
+     */
+    __publicField$4(this, "requirements");
+    /**
+     * Some badges are not included in the badge total count... such as Flames of Prometheus, which can be removed by redeeming it for a Notice of the Well.
+     */
+    __publicField$4(this, "ignoreInTotals");
+    this.key = new Key(badgeData.key).value;
+    this.type = badgeData.type;
+    this.name = new Alternates(badgeData.name);
+    this.alignment = new Alignments(badgeData.alignment);
+    this.badgeText = new Alternates(badgeData.badgeText ?? []);
+    this.acquisition = badgeData.acquisition;
+    this.icon = new Alternates(badgeData.icon ?? []);
+    this.notes = badgeData.notes;
+    this.links = badgeData.links ?? [];
+    this.zoneKey = badgeData.zoneKey;
+    this.loc = badgeData.loc;
+    this.effect = badgeData.effect;
+    this.vidiotMapKey = badgeData.vidiotMapKey;
+    this.setTitle = badgeData.setTitle;
+    this.ignoreInTotals = badgeData.ignoreInTotals ?? false;
+    this.requirements = badgeData.requirements?.map((groups, index) => {
+      const existingKeysInGroup = /* @__PURE__ */ new Set();
+      return groups.map((requirementData) => {
+        if (existingKeysInGroup.has(requirementData.key)) throw new Error(`Duplicate badge requirement key [${badgeData.key}:${requirementData.key}] in group [${index + 1}]`);
+        existingKeysInGroup.add(requirementData.key);
+        const badge = new BadgeRequirement(requirementData);
+        __privateGet$2(this, _requirementsIndex)[badge.key] = badge;
+        return badge;
+      });
+    });
+  }
+  getRequirement(key) {
+    const result = __privateGet$2(this, _requirementsIndex)[key];
+    if (result === void 0) throw new Error(`Unknown badge requirement key [${key}]`);
+    return result;
   }
 }
+_requirementsIndex = new WeakMap();
 
-var __defProp$2 = Object.defineProperty;
-var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __typeError$1 = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck$1 = (obj, member, msg) => member.has(obj) || __typeError$1("Cannot " + msg);
+var __privateGet$1 = (obj, member, getter) => (__accessCheck$1(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd$1 = (obj, member, value) => member.has(obj) ? __typeError$1("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet$1 = (obj, member, value, setter) => (__accessCheck$1(obj, member, "write to private field"), member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck$1(obj, member, "access private method"), method);
+var _badges, _badgeIndex$1, _zoneOrder, _BadgeIndex_instances, satisfiesQueryPredicate_fn, satisfiesFilterPredicate_fn, sort_fn;
+class BadgeIndex {
+  constructor(badges, zones) {
+    __privateAdd$1(this, _BadgeIndex_instances);
+    __privateAdd$1(this, _badges, []);
+    __privateAdd$1(this, _badgeIndex$1, {});
+    __privateAdd$1(this, _zoneOrder, {});
+    __privateSet$1(this, _zoneOrder, Object.fromEntries(
+      zones?.sort((a, b) => a.name.localeCompare(b.name))?.map((x, index) => [x.key, index]) ?? []
+    ));
+    __privateSet$1(this, _badges, badges);
+    for (const badge of badges) {
+      if (__privateGet$1(this, _badgeIndex$1)[badge.key] !== void 0) throw new Error(`Duplicate badge key [${badge.key}]`);
+      __privateGet$1(this, _badgeIndex$1)[badge.key] = badge;
+    }
+  }
+  getBadge(key) {
+    const result = __privateGet$1(this, _badgeIndex$1)[key];
+    if (result === void 0) throw new Error(`Unknown badge key [${key}]`);
+    return result;
+  }
+  badgeExists(key) {
+    return !!__privateGet$1(this, _badgeIndex$1)[key];
+  }
+  searchBadges(options) {
+    const filtered = options?.query || options?.filter ? __privateGet$1(this, _badges).filter((badge) => __privateMethod(this, _BadgeIndex_instances, satisfiesQueryPredicate_fn).call(this, badge, options?.query) && __privateMethod(this, _BadgeIndex_instances, satisfiesFilterPredicate_fn).call(this, badge, options?.filter)) : __privateGet$1(this, _badges);
+    const totalPages = options?.pageSize ? Math.ceil(filtered.length / options?.pageSize) : 1;
+    const page = Math.max(1, Math.min(totalPages, options?.page ?? 1));
+    const paged = options?.pageSize ? filtered.slice((page - 1) * options.pageSize, page * options?.pageSize) : filtered;
+    const sorted = __privateMethod(this, _BadgeIndex_instances, sort_fn).call(this, paged, options?.sort);
+    return {
+      items: sorted,
+      page,
+      pageSize: options?.pageSize,
+      totalItems: filtered.length,
+      totalPages
+    };
+  }
+}
+_badges = new WeakMap();
+_badgeIndex$1 = new WeakMap();
+_zoneOrder = new WeakMap();
+_BadgeIndex_instances = new WeakSet();
+satisfiesQueryPredicate_fn = function(badge, query) {
+  const queryString = query?.str?.toLowerCase() ?? "";
+  return !!((query?.on?.name ?? true) && badge.name.canonical.some((x) => x.value.toLowerCase().includes(queryString)) || query?.on?.badgeText && badge.badgeText.canonical.some((x) => x.value.toLowerCase().includes(queryString)) || query?.on?.acquisition && badge.acquisition?.toLowerCase().includes(queryString) || query?.on?.effect && badge.effect?.toLowerCase().includes(queryString) || query?.on?.notes && badge.notes?.toLowerCase().includes(queryString) || query?.on?.setTitle && (badge.setTitle?.id?.toString().includes(queryString) || badge.setTitle?.praetorianId?.toString().includes(queryString)));
+};
+satisfiesFilterPredicate_fn = function(badge, filter) {
+  return (!filter?.type || badge.type === filter.type) && (!filter?.zoneKey || badge.zoneKey === filter.zoneKey) && (!filter?.alignment || badge.alignment.items.includes(filter.alignment));
+};
+sort_fn = function(badges, sort) {
+  if (!sort) return badges;
+  const ascending = sort.dir !== "DESC";
+  if (!sort.by || sort.by === "CANONICAL") return sort.dir === "DESC" ? badges.reverse() : badges;
+  if (sort.by === "BADGE_NAME") return ascending ? badges.sort((a, b) => a.name.default?.value.localeCompare(b.name.default?.value ?? "") ?? 0) : badges.sort((a, b) => b.name.default?.value.localeCompare(a.name.default?.value ?? "") ?? 0);
+  return badges.sort((a, b) => {
+    const aIndex = __privateGet$1(this, _zoneOrder)[a.zoneKey ?? ""];
+    const bIndex = __privateGet$1(this, _zoneOrder)[b.zoneKey ?? ""];
+    if (aIndex === bIndex) return 0;
+    if (aIndex === void 0) return ascending ? 1 : -1;
+    if (bIndex === void 0) return ascending ? -1 : 1;
+    return ascending ? aIndex - bIndex : bIndex - aIndex;
+  });
+};
+
+var __defProp$3 = Object.defineProperty;
+var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$3 = (obj, key, value) => __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
 class BundleMetadata {
   constructor(bundle) {
     /**
-     * Name of the server group.
+     * Name of the content bundle.
      */
-    __publicField$2(this, "name");
+    __publicField$3(this, "name");
     /**
-     * Description of the server group.
-     *
-     * Supports {@link https://www.markdownguide.org/|Markdown} format.
+     * Description of the fork.
      */
-    __publicField$2(this, "description");
+    __publicField$3(this, "description");
     /**
      * Repository where the db content package is maintained.
      */
-    __publicField$2(this, "repository");
+    __publicField$3(this, "repository");
     /**
-     * List of external links for this Server Group. Wiki, forums, etc.
+     * List of external links. Wiki, forums, etc.
      */
-    __publicField$2(this, "links");
+    __publicField$3(this, "links");
     /**
      * Change log for this data package.
      */
-    __publicField$2(this, "changelog");
+    __publicField$3(this, "changelog");
     this.name = bundle.name;
     this.description = bundle.description;
     this.repository = bundle.repository;
@@ -455,20 +514,78 @@ class BundleMetadata {
   }
 }
 
+var __defProp$2 = Object.defineProperty;
+var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
+class Zone {
+  constructor(data) {
+    /**
+     * Unique key used to reference this zone.
+     *
+     * Keys can only contain lowercase letters, numbers and hyphens (`-`).
+     */
+    __publicField$2(this, "key");
+    /**
+     * The name of the zone as it appears in-game.
+     */
+    __publicField$2(this, "name");
+    /**
+     * List of external links. Wiki, forums, etc.
+     */
+    __publicField$2(this, "links");
+    this.key = new Key(data.key).value;
+    this.name = data.name;
+    this.links = data.links ?? [];
+  }
+}
+
 var __defProp$1 = Object.defineProperty;
 var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField$1 = (obj, key, value) => __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
-class BadgeSearchDocument {
-  constructor(badge) {
-    __publicField$1(this, "id");
+class Contact {
+  constructor(contactData) {
+    /**
+     * Unique key used to reference this contact.
+     *
+     * Keys can only contain lowercase letters, numbers and hyphens (`-`).
+     */
     __publicField$1(this, "key");
+    /**
+     * The name of this contact.
+     */
     __publicField$1(this, "name");
-    __publicField$1(this, "badgeText");
-    __publicField$1(this, "acquisition");
-    this.id = this.key = badge.key;
-    this.name = badge.name.toString(", ");
-    this.badgeText = badge.badgeText.toString(", ");
-    this.acquisition = badge.acquisition ?? "";
+    /**
+     * The contact's title.
+     */
+    __publicField$1(this, "title");
+    /**
+     * The zone this character is located in.
+     */
+    __publicField$1(this, "zoneKey");
+    /**
+     * The `/loc` coordinates of the contact.
+     */
+    __publicField$1(this, "loc");
+    /**
+     * The level range this contact will offer missions for.
+     */
+    __publicField$1(this, "levelRange");
+    /**
+     * Freeform notes or tips about the contact.
+     */
+    __publicField$1(this, "notes");
+    /**
+     * List of external links. Wiki, forums, etc.
+     */
+    __publicField$1(this, "links");
+    this.key = new Key(contactData.key).value;
+    this.name = contactData.name;
+    this.title = contactData.title;
+    this.zoneKey = contactData.zoneKey;
+    this.loc = contactData.loc;
+    this.levelRange = contactData.levelRange;
+    this.notes = contactData.notes;
+    this.links = contactData.links ?? [];
   }
 }
 
@@ -482,7 +599,7 @@ var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot
 var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
 var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), member.set(obj, value), value);
-var _archetypeIndex, _mapIndex, _badgeIndex, _badgeSearch;
+var _archetypeIndex, _zoneIndex, _contactIndex, _badgeIndex;
 class CohContentDatabase {
   /**
    * Initialize the database with a content bundle.
@@ -490,83 +607,99 @@ class CohContentDatabase {
    */
   constructor(bundle) {
     __privateAdd(this, _archetypeIndex, {});
-    __privateAdd(this, _mapIndex, {});
-    __privateAdd(this, _badgeIndex, {});
-    __privateAdd(this, _badgeSearch);
+    __privateAdd(this, _zoneIndex, {});
+    __privateAdd(this, _contactIndex, {});
+    __privateAdd(this, _badgeIndex);
     /**
      * Metadata about the content bundle.
      */
     __publicField(this, "metadata");
     /**
-     * List of the game server names in this server group.
+     * List of the game server names.
+     *
      * Torchbearer, Excelsior, etc.
      */
     __publicField(this, "servers");
     /**
-     * List of archetypes available in this server group.
+     * List of archetypes.
      */
     __publicField(this, "archetypes");
     /**
-     * List of game maps supported by this server group.
+     * List of game zones.
+     */
+    __publicField(this, "zones");
+    /**
+     * List of contacts.
      */
-    __publicField(this, "maps");
+    __publicField(this, "contacts");
     /**
-     * List of badges available on this server group.
+     * List of badges.
      */
     __publicField(this, "badges");
     this.metadata = new BundleMetadata(bundle);
     this.servers = bundle.servers ?? [];
     this.archetypes = bundle.archetypes?.map((data) => {
-      if (__privateGet(this, _archetypeIndex)[data.key] !== void 0) throw new Error(`Duplicate archetype key [${data.key}]`);
+      if (__privateGet(this, _archetypeIndex)[data.key] !== void 0) throw new Error(`Duplicate archetype key '${data.key}'`);
       const archetype = new Archetype(data);
       __privateGet(this, _archetypeIndex)[archetype.key] = archetype;
       return archetype;
     }) ?? [];
-    this.maps = bundle.maps?.map((data) => {
-      if (__privateGet(this, _mapIndex)[data.key] !== void 0) throw new Error(`Duplicate map key [${data.key}]`);
-      const map = new GameMap(data);
-      __privateGet(this, _mapIndex)[map.key] = map;
-      return map;
+    this.zones = bundle.zones?.map((data) => {
+      if (__privateGet(this, _zoneIndex)[data.key] !== void 0) throw new Error(`Duplicate zone key '${data.key}'`);
+      const zone = new Zone(data);
+      __privateGet(this, _zoneIndex)[zone.key] = zone;
+      return zone;
     }) ?? [];
-    this.badges = bundle.badges?.map((data) => {
-      if (__privateGet(this, _badgeIndex)[data.key] !== void 0) throw new Error(`Duplicate badge key [${data.key}]`);
-      const badge = new Badge(data);
-      __privateGet(this, _badgeIndex)[badge.key] = badge;
-      return badge;
+    this.contacts = bundle.contacts?.map((data) => {
+      if (__privateGet(this, _contactIndex)[data.key] !== void 0) throw new Error(`Duplicate contact key '${data.key}'`);
+      const contact = new Contact(data);
+      __privateGet(this, _contactIndex)[contact.key] = contact;
+      return contact;
     }) ?? [];
-    __privateSet(this, _badgeSearch, new MiniSearch({
-      fields: ["key", "name", "badgeText", "acquisition"],
-      storeFields: ["key"]
-    }));
-    for (const badge of this.badges) {
-      __privateGet(this, _badgeSearch).add(new BadgeSearchDocument(badge));
-    }
+    this.badges = bundle.badges?.map((data) => new Badge(data)) ?? [];
+    __privateSet(this, _badgeIndex, new BadgeIndex(this.badges, this.zones));
   }
   getArchetype(key) {
     const result = __privateGet(this, _archetypeIndex)[key];
-    if (result === void 0) throw new Error(`Unknown archetype key [${key}]`);
+    if (result === void 0) throw new Error(`Unknown archetype key '${key}'`);
     return result;
   }
-  getMap(key) {
-    const result = __privateGet(this, _mapIndex)[key];
-    if (result === void 0) throw new Error(`Unknown map key [${key}]`);
+  getZone(key) {
+    const result = __privateGet(this, _zoneIndex)[key];
+    if (result === void 0) throw new Error(`Unknown zone key '${key}'`);
     return result;
   }
-  getBadge(key) {
-    const result = __privateGet(this, _badgeIndex)[key];
-    if (result === void 0) throw new Error(`Unknown badge key [${key}]`);
+  getContact(key) {
+    const result = __privateGet(this, _contactIndex)[key];
+    if (result === void 0) throw new Error(`Unknown contact key '${key}'`);
     return result;
   }
-  searchBadges(query) {
-    if (!query) return this.badges;
-    const keys = __privateGet(this, _badgeSearch).search(query, { prefix: true, fuzzy: true });
-    return keys.map((result) => this.getBadge(result["key"]));
+  zoneExists(key) {
+    return !!__privateGet(this, _zoneIndex)[key];
+  }
+  contactExists(key) {
+    return !!__privateGet(this, _contactIndex)[key];
+  }
+  getBadge(key) {
+    return __privateGet(this, _badgeIndex).getBadge(key);
+  }
+  badgeExists(key) {
+    return __privateGet(this, _badgeIndex).badgeExists(key);
+  }
+  /**
+   * Search, sort and filter the badge list.
+   * This is a fairly brute-forced approach and will not be as performant as loading the badge data into a traditional
+   * database engine, but is sufficient for most operations.
+   * @param options {@link BadgeSearchOptions}
+   */
+  searchBadges(options) {
+    return __privateGet(this, _badgeIndex).searchBadges(options);
   }
 }
 _archetypeIndex = new WeakMap();
-_mapIndex = new WeakMap();
+_zoneIndex = new WeakMap();
+_contactIndex = new WeakMap();
 _badgeIndex = new WeakMap();
-_badgeSearch = new WeakMap();
 
 const CHANGELOG = [
   {
@@ -574,14 +707,19 @@ const CHANGELOG = [
     date: /* @__PURE__ */ new Date("2025-03-12"),
     description: `* Replaced redundant interfaces with their concrete equivalents.
 * Server groups are now referred to as 'forks'.
-* Replaced enums with extensible union types; Forks with new badge types, enhancement types, etc. can now extend them locally.
+* Replaced enums with union types.
 * \`IServerGroupData\` is now \`ContentBundle\` and each database instance is now designed to accept only a single server group.
+* \`GameMap\` is now \`Zone\`.
 * Removed the \`serverGroup\` property from entities to simplify the object tree given that only a single context can exist per db now.
 * Added a simple indexing and search function for badge names, text and acquisition info.
+* Zone and badge references now follow a standard Markdown link format with a \`badge://\` or \`map://\` protocol.
+* Badge partials are now known as badge requirements and support both AND and OR groups of requirements.
+* Removed the \`VidiotMap\` API as it was never used or fleshed out properly.
+* Added support for story arcs to badge requirements including a link to the contact.
 * Standardized pluralization of some field names (name, icon).
 * Combined \`settitle\` ids into a single tuple field.
 * Change from GNU to The Unlicense.
-* Removed dependency on lodash.
+* Removed all third-party dependencies.
 * Moved from webpack to rollup for packaging.
 * Add eslint for linting.
 * Add jest for unit tests.
@@ -590,31 +728,53 @@ const CHANGELOG = [
   }
 ];
 
-function createBadgeReference(target) {
+function badgeUri(target) {
+  const key = typeof target === "string" ? target : target.key;
+  return `badge://${key}`;
+}
+function badgeLink(target) {
+  const key = typeof target === "string" ? target : target.key;
+  return `[${key}](${badgeUri(target)})`;
+}
+function contactUri(target) {
+  const key = typeof target === "string" ? target : target.key;
+  return `contact://${key}`;
+}
+function contactLink(target) {
+  const key = typeof target === "string" ? target : target.key;
+  return `[${key}](${contactUri(target)})`;
+}
+function zoneUri(target) {
   const key = typeof target === "string" ? target : target.key;
-  return `[badge:${key}]`;
+  return `zone://${key}`;
 }
-function createMapReference(target) {
+function zoneLink(target) {
   const key = typeof target === "string" ? target : target.key;
-  return `[map:${key}]`;
+  return `[${key}](${zoneUri(target)})`;
 }
 
 exports.ALIGNMENT = ALIGNMENT;
+exports.Alignments = Alignments;
+exports.Alternates = Alternates;
 exports.Archetype = Archetype;
-exports.BADGE_PARTIAL_TYPE = BADGE_PARTIAL_TYPE;
+exports.BADGE_REQUIREMENT_TYPE = BADGE_REQUIREMENT_TYPE;
 exports.BADGE_TYPE = BADGE_TYPE;
 exports.Badge = Badge;
-exports.BadgePartial = BadgePartial;
+exports.BadgeIndex = BadgeIndex;
+exports.BadgeRequirement = BadgeRequirement;
 exports.BundleMetadata = BundleMetadata;
 exports.CHANGELOG = CHANGELOG;
 exports.CohContentDatabase = CohContentDatabase;
+exports.Contact = Contact;
 exports.ENHANCEMENT_CATEGORY = ENHANCEMENT_CATEGORY;
-exports.GameMap = GameMap;
 exports.Key = Key;
 exports.PLAQUE_TYPE = PLAQUE_TYPE;
 exports.SEX = SEX;
-exports.VidiotMap = VidiotMap;
-exports.VidiotMapPointOfInterest = VidiotMapPointOfInterest;
-exports.createBadgeReference = createBadgeReference;
-exports.createMapReference = createMapReference;
+exports.Zone = Zone;
+exports.badgeLink = badgeLink;
+exports.badgeUri = badgeUri;
+exports.contactLink = contactLink;
+exports.contactUri = contactUri;
+exports.zoneLink = zoneLink;
+exports.zoneUri = zoneUri;
 //# sourceMappingURL=coh-content-db.js.map