@rpgm-tools/neo-angband-core 0.10.0

package/dist/mon/desc.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Monster description, ported from reference/src/mon-desc.c and mon-desc.h
+ * (Angband 4.2.6): monster_desc (the naming grammar - articles, possessives,
+ * gendered pronouns, reflexives, "(offscreen)", capitalisation), get_mon_name
+ * (the list-count label) and plural_aux (simple English pluralisation).
+ *
+ * This is the display-layer (#25) grammar that turns a live monster into a
+ * finished noun phrase - "the kobold", "a kobold", "the kobold's", "she",
+ * "herself", "it (offscreen)". Callers select the phrasing through the MDESC_*
+ * bit flags, exactly as upstream.
+ *
+ * Two upstream couplings are handled faithfully:
+ * - monster_is_visible reads the monster's MFLAG_VISIBLE, present on the live
+ *   Monster; forced visibility (MDESC_SHOW / MDESC_HIDE) overrides it as in C.
+ * - panel_contains (mon-desc.c L236, the "(offscreen)" test) is UI viewport
+ *   state; it is injected as an optional predicate defaulting to "on-screen"
+ *   (panel_contains == true), so the "(offscreen)" tag is only appended when a
+ *   caller supplies a real panel test. The single-message web sink never sees a
+ *   monster it cannot show, so the default matches the reachable behaviour.
+ */
+import type { Loc } from "../loc.js";
+import type { Monster } from "./monster.js";
+import type { MonsterRace } from "./types.js";
+/** Bit flags for monster_desc (mon-desc.h L27-42). */
+export declare const MDESC: {
+    readonly DEFAULT: 0;
+    /** Objective (or Reflexive). */
+    readonly OBJE: 1;
+    /** Possessive (or Reflexive). */
+    readonly POSS: 2;
+    /** Indefinites for hidden monsters ("something"). */
+    readonly IND_HID: 4;
+    /** Indefinites for visible monsters ("a kobold"). */
+    readonly IND_VIS: 8;
+    /** Pronominalize hidden monsters. */
+    readonly PRO_HID: 16;
+    /** Pronominalize visible monsters. */
+    readonly PRO_VIS: 32;
+    /** Assume the monster is hidden. */
+    readonly HIDE: 64;
+    /** Assume the monster is visible. */
+    readonly SHOW: 128;
+    /** Capitalise. */
+    readonly CAPITAL: 256;
+    /** Add a comma after an unterminated phrase name. */
+    readonly COMMA: 512;
+};
+/** "someone", "something", or "the kobold" at the start of a message. */
+export declare const MDESC_STANDARD: number;
+/** "someone", "something", or "the kobold" as the target of an attack. */
+export declare const MDESC_TARG: number;
+/** Reveal the full, indefinite name of a monster (died_from). */
+export declare const MDESC_DIED_FROM: number;
+/**
+ * plural_aux (mon-desc.c L27): simple English pluralisation of a monster name -
+ * append "es" after a trailing "s", otherwise "s".
+ */
+export declare function pluralAux(name: string): string;
+/**
+ * get_mon_name (mon-desc.c L44): the "N race(s)" label the monster list prints.
+ * Uniques get "[U] name" with no count; otherwise the count, then the singular
+ * name (num == 1), the race's explicit plural, or plural_aux of the name.
+ */
+export declare function getMonName(race: MonsterRace, num: number): string;
+/**
+ * monster_desc (mon-desc.c L108): build a description of `mon` per the MDESC_*
+ * `mode` flags. `panelContains(grid)` is the injected viewport test for the
+ * "(offscreen)" tag; it defaults to "on-screen" so no tag is appended unless a
+ * caller supplies a real panel predicate.
+ */
+export declare function monsterDesc(mon: Monster, mode: number, panelContains?: (grid: Loc) => boolean): string;
+//# sourceMappingURL=desc.d.ts.map

package/dist/mon/desc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desc.d.ts","sourceRoot":"","sources":["../../src/mon/desc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,sDAAsD;AACtD,eAAO,MAAM,KAAK;;IAEhB,gCAAgC;;IAEhC,iCAAiC;;IAEjC,qDAAqD;;IAErD,qDAAqD;;IAErD,qCAAqC;;IAErC,sCAAsC;;IAEtC,oCAAoC;;IAEpC,qCAAqC;;IAErC,kBAAkB;;IAElB,qDAAqD;;CAE7C,CAAC;AAEX,yEAAyE;AACzE,eAAO,MAAM,cAAc,QACkC,CAAC;AAE9D,0EAA0E;AAC1E,eAAO,MAAM,UAAU,QAA6C,CAAC;AAErE,iEAAiE;AACjE,eAAO,MAAM,eAAe,QAA6B,CAAC;AAY1D;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CASjE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAoB,GACjD,MAAM,CAwGR"}

package/dist/mon/desc.js

@@ -0,0 +1,237 @@
+/**
+ * Monster description, ported from reference/src/mon-desc.c and mon-desc.h
+ * (Angband 4.2.6): monster_desc (the naming grammar - articles, possessives,
+ * gendered pronouns, reflexives, "(offscreen)", capitalisation), get_mon_name
+ * (the list-count label) and plural_aux (simple English pluralisation).
+ *
+ * This is the display-layer (#25) grammar that turns a live monster into a
+ * finished noun phrase - "the kobold", "a kobold", "the kobold's", "she",
+ * "herself", "it (offscreen)". Callers select the phrasing through the MDESC_*
+ * bit flags, exactly as upstream.
+ *
+ * Two upstream couplings are handled faithfully:
+ * - monster_is_visible reads the monster's MFLAG_VISIBLE, present on the live
+ *   Monster; forced visibility (MDESC_SHOW / MDESC_HIDE) overrides it as in C.
+ * - panel_contains (mon-desc.c L236, the "(offscreen)" test) is UI viewport
+ *   state; it is injected as an optional predicate defaulting to "on-screen"
+ *   (panel_contains == true), so the "(offscreen)" tag is only appended when a
+ *   caller supplies a real panel test. The single-message web sink never sees a
+ *   monster it cannot show, so the default matches the reachable behaviour.
+ */
+import { RF } from "../generated/index.js";
+import { monsterIsShapeUnique, monsterIsVisible } from "./predicate.js";
+/** Bit flags for monster_desc (mon-desc.h L27-42). */
+export const MDESC = {
+    DEFAULT: 0x00,
+    /** Objective (or Reflexive). */
+    OBJE: 0x01,
+    /** Possessive (or Reflexive). */
+    POSS: 0x02,
+    /** Indefinites for hidden monsters ("something"). */
+    IND_HID: 0x04,
+    /** Indefinites for visible monsters ("a kobold"). */
+    IND_VIS: 0x08,
+    /** Pronominalize hidden monsters. */
+    PRO_HID: 0x10,
+    /** Pronominalize visible monsters. */
+    PRO_VIS: 0x20,
+    /** Assume the monster is hidden. */
+    HIDE: 0x40,
+    /** Assume the monster is visible. */
+    SHOW: 0x80,
+    /** Capitalise. */
+    CAPITAL: 0x100,
+    /** Add a comma after an unterminated phrase name. */
+    COMMA: 0x200,
+};
+/** "someone", "something", or "the kobold" at the start of a message. */
+export const MDESC_STANDARD = MDESC.CAPITAL | MDESC.IND_HID | MDESC.PRO_HID | MDESC.COMMA;
+/** "someone", "something", or "the kobold" as the target of an attack. */
+export const MDESC_TARG = MDESC.OBJE | MDESC.IND_HID | MDESC.PRO_HID;
+/** Reveal the full, indefinite name of a monster (died_from). */
+export const MDESC_DIED_FROM = MDESC.SHOW | MDESC.IND_VIS;
+/** is_a_vowel (z-util.c): the leading article picks "an" for vowels. */
+function isAVowel(ch) {
+    return "aeiouAEIOU".includes(ch);
+}
+/** my_strcap (z-util.c): capitalise the first letter of the string. */
+function strcap(s) {
+    return s.length > 0 ? s.charAt(0).toUpperCase() + s.slice(1) : s;
+}
+/**
+ * plural_aux (mon-desc.c L27): simple English pluralisation of a monster name -
+ * append "es" after a trailing "s", otherwise "s".
+ */
+export function pluralAux(name) {
+    if (name.length === 0)
+        return name;
+    return name + (name[name.length - 1] === "s" ? "es" : "s");
+}
+/**
+ * get_mon_name (mon-desc.c L44): the "N race(s)" label the monster list prints.
+ * Uniques get "[U] name" with no count; otherwise the count, then the singular
+ * name (num == 1), the race's explicit plural, or plural_aux of the name.
+ */
+export function getMonName(race, num) {
+    if (race.flags.has(RF.UNIQUE)) {
+        return `[U] ${race.name}`;
+    }
+    /* strnfmt "%3d " - the count is right-justified in a 3-wide field. */
+    const prefix = `${String(num).padStart(3, " ")} `;
+    if (num === 1)
+        return prefix + race.name;
+    if (race.plural !== null)
+        return prefix + race.plural;
+    return prefix + pluralAux(race.name);
+}
+/**
+ * monster_desc (mon-desc.c L108): build a description of `mon` per the MDESC_*
+ * `mode` flags. `panelContains(grid)` is the injected viewport test for the
+ * "(offscreen)" tag; it defaults to "on-screen" so no tag is appended unless a
+ * caller supplies a real panel predicate.
+ */
+export function monsterDesc(mon, mode, panelContains = () => true) {
+    /* Can we see it? (forced, or not hidden + visible.) */
+    const seen = !!(mode & MDESC.SHOW) ||
+        (!(mode & MDESC.HIDE) && monsterIsVisible(mon));
+    /* Sexed pronouns (seen and forced, or unseen and allowed). */
+    const usePronoun = (seen && !!(mode & MDESC.PRO_VIS)) || (!seen && !!(mode & MDESC.PRO_HID));
+    /* First, try using pronouns, or describing hidden monsters. */
+    if (!seen || usePronoun) {
+        let choice = "it";
+        /* An encoding of the monster "sex". */
+        let msex = 0x00;
+        if (usePronoun) {
+            if (mon.race.flags.has(RF.FEMALE))
+                msex = 0x20;
+            else if (mon.race.flags.has(RF.MALE))
+                msex = 0x10;
+        }
+        /* Brute force: split on the possibilities (mon-desc.c L137). */
+        switch (msex + (mode & 0x07)) {
+            /* Neuter. */
+            case 0x00:
+                choice = "it";
+                break;
+            case 0x01:
+                choice = "it";
+                break;
+            case 0x02:
+                choice = "its";
+                break;
+            case 0x03:
+                choice = "itself";
+                break;
+            case 0x04:
+                choice = "something";
+                break;
+            case 0x05:
+                choice = "something";
+                break;
+            case 0x06:
+                choice = "something's";
+                break;
+            case 0x07:
+                choice = "itself";
+                break;
+            /* Male. */
+            case 0x10:
+                choice = "he";
+                break;
+            case 0x11:
+                choice = "him";
+                break;
+            case 0x12:
+                choice = "his";
+                break;
+            case 0x13:
+                choice = "himself";
+                break;
+            case 0x14:
+                choice = "someone";
+                break;
+            case 0x15:
+                choice = "someone";
+                break;
+            case 0x16:
+                choice = "someone's";
+                break;
+            case 0x17:
+                choice = "himself";
+                break;
+            /* Female. */
+            case 0x20:
+                choice = "she";
+                break;
+            case 0x21:
+                choice = "her";
+                break;
+            case 0x22:
+                choice = "her";
+                break;
+            case 0x23:
+                choice = "herself";
+                break;
+            case 0x24:
+                choice = "someone";
+                break;
+            case 0x25:
+                choice = "someone";
+                break;
+            case 0x26:
+                choice = "someone's";
+                break;
+            case 0x27:
+                choice = "herself";
+                break;
+        }
+        return mode & MDESC.CAPITAL ? strcap(choice) : choice;
+    }
+    if (mode & MDESC.POSS && mode & MDESC.OBJE) {
+        /* The monster is visible, so use its gender. */
+        let out;
+        if (mon.race.flags.has(RF.FEMALE))
+            out = "herself";
+        else if (mon.race.flags.has(RF.MALE))
+            out = "himself";
+        else
+            out = "itself";
+        return mode & MDESC.CAPITAL ? strcap(out) : out;
+    }
+    /* Strip a descriptive phrase (after the comma) when a possessive follows. */
+    const stripPhrase = (name) => {
+        if (mode & MDESC.POSS &&
+            mon.race.flags.has(RF.NAME_COMMA)) {
+            const commaPos = name.indexOf(",");
+            if (commaPos >= 0 && commaPos < 1024)
+                return name.slice(0, commaPos);
+        }
+        return name;
+    };
+    let desc;
+    /* Unique, indefinite or definite. */
+    if (monsterIsShapeUnique(mon)) {
+        desc = stripPhrase(mon.race.name);
+    }
+    else if (mode & MDESC.IND_VIS) {
+        /* Indefinite monsters need an indefinite article. */
+        desc = (isAVowel(mon.race.name[0] ?? "") ? "an " : "a ") + stripPhrase(mon.race.name);
+    }
+    else {
+        /* Definite monsters need a definite article. */
+        desc = "the " + stripPhrase(mon.race.name);
+    }
+    if (mode & MDESC.COMMA && mon.race.flags.has(RF.NAME_COMMA)) {
+        desc += ",";
+    }
+    /* Handle the possessive. */
+    if (mode & MDESC.POSS) {
+        desc += "'s";
+    }
+    /* Mention "offscreen" monsters. */
+    if (!panelContains(mon.grid)) {
+        desc += " (offscreen)";
+    }
+    return mode & MDESC.CAPITAL ? strcap(desc) : desc;
+}
+//# sourceMappingURL=desc.js.map

package/dist/mon/desc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desc.js","sourceRoot":"","sources":["../../src/mon/desc.ts"],"names":[],"mappings":"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"}

package/dist/mon/knowledge-groups.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Thematic monster-knowledge grouping for the '~' -> Monsters browser, ported
+ * from reference/src/ui-knowledge.c (Angband 4.2.6):
+ *   - the ui_knowledge.txt categories (init_ui_knowledge_parser, L3380-3390)
+ *   - the reserved "***Unclassified***" catch-all appended last
+ *     (finish_ui_knowledge_parser, L3437-3445)
+ *   - the per-race group assignment (do_cmd_knowledge_monsters, L1397-1449):
+ *     a race joins EVERY category it matches (so a unique dragon appears under
+ *     both "Uniques" and "Dragons"), falling back to Unclassified only when it
+ *     matches nothing
+ *   - the within-group ordering (m_cmp_race, L1216-1263): for a category that
+ *     lists monster bases, order by base position (non-base members last), then
+ *     by level, then by name.
+ *
+ * This is display grouping only: the set of selectable races is identical to
+ * the flat list, exactly as upstream partitions the same membership.
+ */
+import type { MonsterRace } from "./types.js";
+/** struct ui_monster_category (one parsed ui_knowledge.txt category). */
+export interface MonsterCategory {
+    /** monster-category:name */
+    readonly name: string;
+    /** mcat-include-base names (monster_base names), in file order. */
+    readonly incBases: readonly string[];
+    /** mcat-include-flag flag indices (RF_*). */
+    readonly incFlags: readonly number[];
+    /** mcat-include-other:fully-known */
+    readonly includeFullyKnown: boolean;
+    /** mcat-include-other:not-fully-known */
+    readonly includeNotFullyKnown: boolean;
+}
+/** A compiled pack/ui_knowledge.json record. */
+export interface UiKnowledgeRecordJson {
+    "monster-category": string;
+    "mcat-include-base"?: string[];
+    /** Each entry is a " | "-separated flag list (may hold several flags). */
+    "mcat-include-flag"?: string[];
+    /** "fully-known" / "not-fully-known". */
+    "mcat-include-other"?: string[];
+}
+/** The reserved catch-all category name (finish_ui_knowledge_parser L3439). */
+export declare const UNCLASSIFIED_CATEGORY = "***Unclassified***";
+/** Parse the compiled ui_knowledge records into MonsterCategory objects. */
+export declare function bindMonsterCategories(records: readonly UiKnowledgeRecordJson[]): MonsterCategory[];
+/** A displayed group: a category name plus its ordered member rows. */
+export interface MonsterKnowledgeGroup<T> {
+    readonly name: string;
+    readonly members: T[];
+}
+/**
+ * Assign each known monster row to every category it matches (Unclassified if
+ * none), then order each category's members and drop empty categories, exactly
+ * as do_cmd_knowledge_monsters + display_knowledge do. `known` is the flat
+ * membership (race + whether its lore is fully known); the returned groups hold
+ * the SAME row objects so the caller keeps any extra lore it carries.
+ */
+export declare function monsterKnowledgeGroups<T extends {
+    race: MonsterRace;
+    allKnown: boolean;
+}>(categories: readonly MonsterCategory[], known: readonly T[]): MonsterKnowledgeGroup<T>[];
+//# sourceMappingURL=knowledge-groups.d.ts.map

package/dist/mon/knowledge-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-groups.d.ts","sourceRoot":"","sources":["../../src/mon/knowledge-groups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,qCAAqC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,yCAAyC;IACzC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAED,gDAAgD;AAChD,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,yCAAyC;IACzC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAE1D,4EAA4E;AAC5E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,eAAe,EAAE,CAoBnB;AAED,uEAAuE;AACvE,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;CACvB;AA2CD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,EACvF,UAAU,EAAE,SAAS,eAAe,EAAE,EACtC,KAAK,EAAE,SAAS,CAAC,EAAE,GAClB,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAiC5B"}

package/dist/mon/knowledge-groups.js

@@ -0,0 +1,121 @@
+/**
+ * Thematic monster-knowledge grouping for the '~' -> Monsters browser, ported
+ * from reference/src/ui-knowledge.c (Angband 4.2.6):
+ *   - the ui_knowledge.txt categories (init_ui_knowledge_parser, L3380-3390)
+ *   - the reserved "***Unclassified***" catch-all appended last
+ *     (finish_ui_knowledge_parser, L3437-3445)
+ *   - the per-race group assignment (do_cmd_knowledge_monsters, L1397-1449):
+ *     a race joins EVERY category it matches (so a unique dragon appears under
+ *     both "Uniques" and "Dragons"), falling back to Unclassified only when it
+ *     matches nothing
+ *   - the within-group ordering (m_cmp_race, L1216-1263): for a category that
+ *     lists monster bases, order by base position (non-base members last), then
+ *     by level, then by name.
+ *
+ * This is display grouping only: the set of selectable races is identical to
+ * the flat list, exactly as upstream partitions the same membership.
+ */
+import { RF } from "../generated/index.js";
+/** The reserved catch-all category name (finish_ui_knowledge_parser L3439). */
+export const UNCLASSIFIED_CATEGORY = "***Unclassified***";
+/** Parse the compiled ui_knowledge records into MonsterCategory objects. */
+export function bindMonsterCategories(records) {
+    return records.map((r) => {
+        const incFlags = [];
+        for (const line of r["mcat-include-flag"] ?? []) {
+            for (const tok of String(line).split("|")) {
+                const name = tok.trim();
+                if (!name)
+                    continue;
+                const idx = RF[name];
+                if (idx !== undefined)
+                    incFlags.push(idx);
+            }
+        }
+        const other = (r["mcat-include-other"] ?? []).map(String);
+        return {
+            name: r["monster-category"],
+            incBases: (r["mcat-include-base"] ?? []).map(String),
+            incFlags,
+            includeFullyKnown: other.includes("fully-known"),
+            includeNotFullyKnown: other.includes("not-fully-known"),
+        };
+    });
+}
+/** strcmp: byte-order name compare (ASCII monster names). */
+function strcmp(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/**
+ * m_cmp_race within a single group (ui-knowledge.c:1234-1262): base position
+ * first (members outside the listed bases sort last), then level, then name.
+ */
+function compareInGroup(category, a, b) {
+    if (category && category.incBases.length > 0) {
+        const pos = (race) => {
+            const i = category.incBases.indexOf(race.base?.name ?? "");
+            return i < 0 ? category.incBases.length : i;
+        };
+        const c = pos(a) - pos(b);
+        if (c)
+            return c;
+    }
+    const c = a.level - b.level;
+    if (c)
+        return c;
+    return strcmp(a.name, b.name);
+}
+/** Does a race match a category by flag or by the fully-/not-fully-known other? */
+function matchesFlagOrOther(category, race, allKnown) {
+    for (const flag of category.incFlags) {
+        if (race.flags.has(flag))
+            return true;
+    }
+    if (category.includeFullyKnown && allKnown)
+        return true;
+    if (category.includeNotFullyKnown && !allKnown)
+        return true;
+    return false;
+}
+/**
+ * Assign each known monster row to every category it matches (Unclassified if
+ * none), then order each category's members and drop empty categories, exactly
+ * as do_cmd_knowledge_monsters + display_knowledge do. `known` is the flat
+ * membership (race + whether its lore is fully known); the returned groups hold
+ * the SAME row objects so the caller keeps any extra lore it carries.
+ */
+export function monsterKnowledgeGroups(categories, known) {
+    const buckets = categories.map(() => []);
+    const unclassified = [];
+    for (const row of known) {
+        let classified = false;
+        for (let j = 0; j < categories.length; j++) {
+            const cat = categories[j];
+            const hasBase = cat.incBases.length > 0 && cat.incBases.includes(row.race.base?.name ?? "");
+            if (hasBase) {
+                buckets[j].push(row);
+                classified = true;
+            }
+            else if (matchesFlagOrOther(cat, row.race, row.allKnown)) {
+                buckets[j].push(row);
+                classified = true;
+            }
+        }
+        if (!classified)
+            unclassified.push(row);
+    }
+    const groups = [];
+    for (let j = 0; j < categories.length; j++) {
+        const members = buckets[j];
+        if (members.length === 0)
+            continue;
+        members.sort((a, b) => compareInGroup(categories[j], a.race, b.race));
+        groups.push({ name: categories[j].name, members });
+    }
+    if (unclassified.length > 0) {
+        unclassified.sort((a, b) => compareInGroup(null, a.race, b.race));
+        groups.push({ name: UNCLASSIFIED_CATEGORY, members: unclassified });
+    }
+    return groups;
+}
+//# sourceMappingURL=knowledge-groups.js.map

package/dist/mon/knowledge-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-groups.js","sourceRoot":"","sources":["../../src/mon/knowledge-groups.ts"],"names":[],"mappings":"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"}