@datamoc/mw_games 0.43.0 → 0.45.0

package/data/microgm-essential.PROVENANCE.md

@@ -1,13 +0,0 @@
-# microgm-essential SoundFont provenance
-
-A preset-only subset of [microgm-opt.sf2](microgm-opt.PROVENANCE.md), with the same
-WTFPL licence and unmodified sample data. No additional media or external download.
-
-The six presets use zero-based MIDI numbering: bank 0 programs 0 (piano), 24 (nylon
-guitar), 40 (violin), 56 (trumpet), 73 (flute), and bank 128 program 0 (standard drums).
-The file is 314,384 bytes. It is optional; the full GM bank remains available.
-
-Regenerate with `npm run build:pkg`, then `node tools/make-essential-soundfont.mjs`.
-`tests/soundfont-essentials.test.ts` compares every generated byte to the supplied bank.
-Use `missingProgram: 'synth'` with the MIDI renderer for instruments outside this set.
-Copy `microgm-essential.sf2` into the game's assets folder; the normal build can subset it further.

package/data/microgm-opt.PROVENANCE.md

@@ -1,23 +0,0 @@
-# microgm-opt SoundFont provenance
-
-`microgm-opt.sf2` is a small General MIDI SoundFont (2,629,640 bytes, 137 presets)
-supplied for this repository as the smallest usable GM bank found so far. Its INFO
-chunk names the bank `microgm-opt`, the engineer `michael`, the sound engine
-`EMU8000`, the comment `gm soundfont for tiny devices`, and the tool `Polyphone`.
-
-Source: https://musical-artifacts.com/artifacts/2529 (the page refused an automated read
-when this note was written, so it was not re-checked there).
-
-Licence: WTFPL (Do What The F*** You Want To Public License,
-https://www.wtfpl.net/), confirmed by the project owner in October 2026. The
-file's own INFO chunk states no licence, so this note is the record of that
-confirmation. The bank keeps its WTFPL terms; it is not relicensed under this
-project's MPL-2.0.
-
-The bank ships in the published npm package (`package.json`'s `files` list), so
-a game copies `data/microgm-opt.sf2` from the installed package into its own
-asset folder and lets the build do the rest: `tools/compile-resources` embeds
-only the programs the game's shipped MIDI files use, so a game that plays a
-handful of instruments carries tens of kilobytes of the bank instead of the
-whole file (see `tests/compile-resources.test.ts`, which subsets this bank
-against a three-program MIDI file).

package/data/soundfont-catalog.json

@@ -1,191 +0,0 @@
-{
-	"description": "SoundFont collections mwg-soundfonts can fetch per instrument. Snapshot of marmooo/free-soundfonts list.json (sf3 sizes in MB) with each licence classified; classes other than public-domain, permissive and attribution need --accept-licence.",
-	"source": "https://soundfonts.pages.dev",
-	"default": "microgm-opt",
-	"bundled": [
-		{
-			"name": "microgm-essential",
-			"file": "data/microgm-essential.sf2",
-			"licence": "WTFPL",
-			"licenceClass": "permissive",
-			"programs": 6,
-			"fullMB": 0.314384
-		},
-		{
-			"name": "microgm-opt",
-			"file": "data/microgm-opt.sf2",
-			"licence": "WTFPL",
-			"licenceClass": "permissive",
-			"web": "https://musical-artifacts.com/artifacts/2529",
-			"programs": 137,
-			"fullMB": 2.6
-		}
-	],
-	"fonts": [
-		{
-			"name": "005.6mg_Aspirin_Stereo_V1.2_Bank",
-			"licence": "Public Domain",
-			"licenceClass": "public-domain",
-			"programs": 191,
-			"gmMB": 9,
-			"fullMB": 15
-		},
-		{
-			"name": "32MbGMStereo",
-			"licence": "see source page",
-			"licenceClass": "check",
-			"web": "http://ntonyx.com/05_sf_01.html#008",
-			"programs": 137,
-			"gmMB": 15,
-			"fullMB": 15,
-			"note": "No licence stated by the collection: check the source page."
-		},
-		{
-			"name": "90's_Retro_Vintage_v1.05",
-			"licence": "Public Domain",
-			"licenceClass": "public-domain",
-			"web": "https://musical-artifacts.com/artifacts/1386",
-			"programs": 470,
-			"gmMB": 59,
-			"fullMB": 155
-		},
-		{
-			"name": "Airfont_320_neo",
-			"licence": "Public Domain",
-			"licenceClass": "public-domain",
-			"web": "https://musical-artifacts.com/artifacts/634",
-			"programs": 325,
-			"gmMB": 6,
-			"fullMB": 10
-		},
-		{
-			"name": "Airfont_330",
-			"licence": "CC-BY-3.0",
-			"licenceClass": "attribution",
-			"web": "https://musical-artifacts.com/artifacts/874",
-			"programs": 218,
-			"gmMB": 20,
-			"fullMB": 22
-		},
-		{
-			"name": "Airfont_340",
-			"licence": "Public Domain",
-			"licenceClass": "public-domain",
-			"web": "https://musical-artifacts.com/artifacts/633",
-			"programs": 326,
-			"gmMB": 14,
-			"fullMB": 18
-		},
-		{
-			"name": "Airfont_380_final",
-			"licence": "Public Domain",
-			"licenceClass": "public-domain",
-			"web": "https://musical-artifacts.com/artifacts/635",
-			"programs": 138,
-			"gmMB": 38,
-			"fullMB": 38
-		},
-		{
-			"name": "Alex's_gm_v1.3",
-			"licence": "CC-BY-3.0",
-			"licenceClass": "attribution",
-			"web": "https://musical-artifacts.com/artifacts/1390",
-			"programs": 137,
-			"gmMB": 60,
-			"fullMB": 60
-		},
-		{
-			"name": "Aspirin_160_GMGS_2015",
-			"licence": "Public Domain",
-			"licenceClass": "public-domain",
-			"programs": 207,
-			"gmMB": 13,
-			"fullMB": 24
-		},
-		{
-			"name": "ColomboGMGS2_V16.0",
-			"licence": "CC-BY-SA-4.0",
-			"licenceClass": "share-alike",
-			"web": "https://musical-artifacts.com/artifacts/1234",
-			"programs": 886,
-			"gmMB": 120,
-			"fullMB": 378
-		},
-		{
-			"name": "FatBoy_v0.790",
-			"licence": "see source page",
-			"licenceClass": "check",
-			"web": "https://fatboy.site/",
-			"programs": 281,
-			"gmMB": 50,
-			"fullMB": 72,
-			"note": "No licence stated by the collection: ask the author."
-		},
-		{
-			"name": "FluidR3_v3.1",
-			"licence": "MIT",
-			"licenceClass": "permissive",
-			"web": "https://launchpad.net/ubuntu/+source/fluid-soundfont",
-			"programs": 222,
-			"gmMB": 70,
-			"fullMB": 78
-		},
-		{
-			"name": "GeneralUser_GS_v1.472",
-			"licence": "see source page",
-			"licenceClass": "check",
-			"web": "http://www.schristiancollins.com/generaluser.php",
-			"programs": 269,
-			"gmMB": 17,
-			"fullMB": 34,
-			"note": "Its own licence (schristiancollins.com): read it before shipping."
-		},
-		{
-			"name": "GeneralUser_GS_v2.0.3",
-			"licence": "see source page",
-			"licenceClass": "check",
-			"web": "http://www.schristiancollins.com/generaluser.php",
-			"programs": 287,
-			"gmMB": 19,
-			"fullMB": 38,
-			"note": "Its own licence (schristiancollins.com): read it before shipping."
-		},
-		{
-			"name": "LiteGM_v1.03",
-			"licence": "CC-BY-SA-4.0",
-			"licenceClass": "share-alike",
-			"web": "https://musical-artifacts.com/artifacts/3677",
-			"programs": 137,
-			"gmMB": 10,
-			"fullMB": 10
-		},
-		{
-			"name": "SGM-V2.01",
-			"licence": "CC-BY-4.0",
-			"licenceClass": "attribution",
-			"web": "https://archive.org/details/SGM-V2.01",
-			"programs": 409,
-			"gmMB": 66,
-			"fullMB": 162
-		},
-		{
-			"name": "SGM-v2.01-NicePianosGuitarsBass-V1.2",
-			"licence": "CC-BY-3.0",
-			"licenceClass": "attribution",
-			"web": "https://musical-artifacts.com/artifacts/855",
-			"programs": 285,
-			"gmMB": 98,
-			"fullMB": 225
-		},
-		{
-			"name": "TimGM6mb",
-			"licence": "GPL-2.0",
-			"licenceClass": "copyleft",
-			"web": "http://www.timbrechbill.com/saxguru/Timidity.php",
-			"programs": 136,
-			"gmMB": 5,
-			"fullMB": 5,
-			"note": "The collection lists Public Domain, but Debian and Alpine list GPL-2.0 (some samples are public domain, others GPL-2.0)."
-		}
-	]
-}

package/dist/actors/Advancement.d.ts

@@ -1,90 +0,0 @@
-/**
- * Tiered specialization: level-gated tiers that grant points, offer a
- * mutually-exclusive branch choice, or offer a capstone choice.
- *
- * The shape a subclass system and an armor-ability slot share: most tiers just add
- * points a game spends elsewhere (through `SkillPoints`, typically), one tier asks the
- * player to commit to exactly one of several branches for the rest of the run, and a
- * late tier grants exactly one capstone. `mwg` names none of the options itself - a
- * game's own track definition does, the same way `QuestLog` takes quest definitions.
- *
- * Points are deliberately only a ledger here, not a spend rule: what a point buys is a
- * game's own design (a stat rank, a talent node), so spending stays game-side the way
- * `skillCheck` is a dice roll and nothing about who is rolling it.
- *
- * @example
- * ```ts
- * import { Advancement, type AdvancementTrack } from '@datamoc/mw_games/actors';
- *
- * const track: AdvancementTrack = {
- *   tiers: [
- *     { threshold: 5, kind: 'points', points: 2 },
- *     { threshold: 10, kind: 'branch', options: [{ id: 'ranger' }, { id: 'mage' }] },
- *   ],
- * };
- *
- * const advancement = new Advancement(track);
- * advancement.grant(6); // opens tier 0, granting 2 points
- * advancement.grant(10); // opens tier 1, a branch to commit to
- * advancement.choose(1, 'ranger', 10);
- * ```
- */
-export type AdvancementTierKind = 'points' | 'branch' | 'capstone';
-export interface AdvancementOption {
-    id: string;
-    /** shown in a choice UI; `mwg` never reads this itself */
-    description?: string;
-}
-export interface AdvancementTier {
-    /** the level at which this tier opens */
-    threshold: number;
-    kind: AdvancementTierKind;
-    /** points tiers: how many ledger points opening this tier grants in total */
-    points?: number;
-    /** branch/capstone tiers: the mutually exclusive options, exactly one may be taken */
-    options?: readonly AdvancementOption[];
-}
-export interface AdvancementTrack {
-    tiers: readonly AdvancementTier[];
-}
-export declare class Advancement {
-    private track;
-    /** how many tiers have had their points granted so far */
-    private grantedTiers;
-    private balance;
-    private choices;
-    constructor(track: AdvancementTrack);
-    /** unspent ledger points */
-    get points(): number;
-    /** tier indices whose threshold the given level has reached, in order */
-    openTiers(level: number): number[];
-    /**
-     * Opens every tier up to `level`, granting each newly opened points tier's points.
-     *
-     * @returns how many points were granted - 0 when nothing new opened, so a game can
-     * tell "level up with no new tier" from a real unlock
-     */
-    grant(level: number): number;
-    /** spends ledger points; false, spending nothing, when the balance is short */
-    spend(points: number): boolean;
-    /**
-     * Takes one option of an open branch/capstone tier - permanently. Throws for a points
-     * tier, a tier that has not opened yet, an unknown option, or a tier already decided,
-     * so a game cannot accidentally offer a choice twice.
-     */
-    choose(tierIndex: number, optionId: string, level: number): void;
-    /** the option taken at a branch/capstone tier, or null when undecided */
-    choice(tierIndex: number): string | null;
-    toJSON(): {
-        grantedTiers: number;
-        balance: number;
-        choices: [number, string][];
-    };
-    /** rebuilds advancement from save data - the track itself is supplied fresh, the same as `QuestLog` definitions */
-    static fromJSON(track: AdvancementTrack, data: {
-        grantedTiers: number;
-        balance: number;
-        choices: [number, string][];
-    }): Advancement;
-}
-//# sourceMappingURL=Advancement.d.ts.map

package/dist/actors/Advancement.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Advancement.d.ts","sourceRoot":"","sources":["../../src/actors/Advancement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnE,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IAEX,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,mBAAmB,CAAC;IAE1B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,sFAAsF;IACtF,OAAO,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;CAClC;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,KAAK,CAAmB;IAEhC,0DAA0D;IAC1D,OAAO,CAAC,YAAY,CAAK;IAEzB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAA6B;IAE5C,YAAY,KAAK,EAAE,gBAAgB,EAElC;IAED,4BAA4B;IAC5B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,yEAAyE;IACzE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAMjC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW3B;IAED,+EAA+E;IAC/E,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAI7B;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAU/D;IAED,yEAAyE;IACzE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEvC;IAED,MAAM,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,CAE/E;IAED,mHAAmH;IACnH,MAAM,CAAC,QAAQ,CACd,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,GAC1E,WAAW,CAMb;CACD"}

package/dist/actors/Advancement.js

@@ -1,115 +0,0 @@
-/**
- * Tiered specialization: level-gated tiers that grant points, offer a
- * mutually-exclusive branch choice, or offer a capstone choice.
- *
- * The shape a subclass system and an armor-ability slot share: most tiers just add
- * points a game spends elsewhere (through `SkillPoints`, typically), one tier asks the
- * player to commit to exactly one of several branches for the rest of the run, and a
- * late tier grants exactly one capstone. `mwg` names none of the options itself - a
- * game's own track definition does, the same way `QuestLog` takes quest definitions.
- *
- * Points are deliberately only a ledger here, not a spend rule: what a point buys is a
- * game's own design (a stat rank, a talent node), so spending stays game-side the way
- * `skillCheck` is a dice roll and nothing about who is rolling it.
- *
- * @example
- * ```ts
- * import { Advancement, type AdvancementTrack } from '@datamoc/mw_games/actors';
- *
- * const track: AdvancementTrack = {
- *   tiers: [
- *     { threshold: 5, kind: 'points', points: 2 },
- *     { threshold: 10, kind: 'branch', options: [{ id: 'ranger' }, { id: 'mage' }] },
- *   ],
- * };
- *
- * const advancement = new Advancement(track);
- * advancement.grant(6); // opens tier 0, granting 2 points
- * advancement.grant(10); // opens tier 1, a branch to commit to
- * advancement.choose(1, 'ranger', 10);
- * ```
- */
-export class Advancement {
-    constructor(track) {
-        /** how many tiers have had their points granted so far */
-        this.grantedTiers = 0;
-        this.balance = 0;
-        this.choices = new Map();
-        this.track = track;
-    }
-    /** unspent ledger points */
-    get points() {
-        return this.balance;
-    }
-    /** tier indices whose threshold the given level has reached, in order */
-    openTiers(level) {
-        const out = [];
-        this.track.tiers.forEach((tier, index) => {
-            if (level >= tier.threshold)
-                out.push(index);
-        });
-        return out;
-    }
-    /**
-     * Opens every tier up to `level`, granting each newly opened points tier's points.
-     *
-     * @returns how many points were granted - 0 when nothing new opened, so a game can
-     * tell "level up with no new tier" from a real unlock
-     */
-    grant(level) {
-        let granted = 0;
-        while (this.grantedTiers < this.track.tiers.length && level >= this.track.tiers[this.grantedTiers].threshold) {
-            const tier = this.track.tiers[this.grantedTiers];
-            if (tier.kind === 'points') {
-                this.balance += tier.points ?? 0;
-                granted += tier.points ?? 0;
-            }
-            this.grantedTiers++;
-        }
-        return granted;
-    }
-    /** spends ledger points; false, spending nothing, when the balance is short */
-    spend(points) {
-        if (this.balance < points)
-            return false;
-        this.balance -= points;
-        return true;
-    }
-    /**
-     * Takes one option of an open branch/capstone tier - permanently. Throws for a points
-     * tier, a tier that has not opened yet, an unknown option, or a tier already decided,
-     * so a game cannot accidentally offer a choice twice.
-     */
-    choose(tierIndex, optionId, level) {
-        const tier = this.track.tiers[tierIndex];
-        if (!tier)
-            throw new Error(`no such advancement tier: ${tierIndex}`);
-        if (tier.kind === 'points')
-            throw new Error(`tier ${tierIndex} grants points, it has no choice`);
-        if (level < tier.threshold)
-            throw new Error(`tier ${tierIndex} has not opened yet`);
-        if (this.choices.has(tierIndex))
-            throw new Error(`tier ${tierIndex} is already decided`);
-        if (!(tier.options ?? []).some((option) => option.id === optionId)) {
-            throw new Error(`tier ${tierIndex} has no option "${optionId}"`);
-        }
-        this.choices.set(tierIndex, optionId);
-    }
-    /** the option taken at a branch/capstone tier, or null when undecided */
-    choice(tierIndex) {
-        return this.choices.get(tierIndex) ?? null;
-    }
-    toJSON() {
-        return { grantedTiers: this.grantedTiers, balance: this.balance, choices: [...this.choices] };
-    }
-    /** rebuilds advancement from save data - the track itself is supplied fresh, the same as `QuestLog` definitions */
-    static fromJSON(track, data) {
-        const advancement = new Advancement(track);
-        advancement.grantedTiers = data.grantedTiers;
-        advancement.balance = data.balance;
-        for (const [tier, option] of data.choices)
-            advancement.choices.set(tier, option);
-        return advancement;
-    }
-}
-//# sourceMappingURL=Advancement.js.map

package/dist/actors/Advancement.js.map

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

package/dist/actors/Affix.d.ts

@@ -1,96 +0,0 @@
-import type { InventoryItem } from './Inventory.ts';
-/**
- * Named item affixes: enchantments, glyphs, augments, curses - whatever a game's items
- * can carry beyond their upgrade `level`.
- *
- * `mwg` draws the line `ItemState` already drew: `level` is a number any item can have,
- * but what "+1 blazing" *means* is a game's own design. An affix definition therefore
- * carries only the routing information every such system shares - which trigger it
- * answers to (`strike`, `defend`, or a `passive` that is always on), how likely it is
- * relative to its table, and whether it is a curse - and the game interprets the id
- * itself when that trigger fires, the same way `Move.effects` is data `mwg` never reads.
- *
- * @example
- * ```ts
- * import { rollAffix, applyAffix, affixOf, removeAffix, copyAffix, matchesContext, type AffixTable } from '@datamoc/mw_games/actors';
- *
- * const table: AffixTable = { entries: [{ id: 'flaming', trigger: 'strike', weight: 1, kinds: ['melee'] }] };
- * const sword = { id: 'sword', quantity: 1 };
- * const betterSword = { id: 'sword', quantity: 1, instanceId: 'b' };
- *
- * const affix = rollAffix(table);
- * if (affix) applyAffix(sword, affix);
- * console.log(affixOf(sword)); // 'flaming'
- *
- * if (affix && matchesContext(affix, { trigger: 'strike', kind: 'melee' })) {
- *   console.log('flaming affix fires on this melee hit');
- * }
- *
- * copyAffix(sword, betterSword); // carries the enchantment onto an upgraded item
- * removeAffix(sword);
- * ```
- */
-export type AffixTrigger = 'strike' | 'defend' | 'passive';
-/** the kind of action a `strike`/`defend` trigger fired from - melee, thrown, a bow, an ability */
-export type AttackKind = 'melee' | 'thrown' | 'bow' | 'ability' | string;
-/** what actually happened, for `matchesContext` to check an affix against */
-export interface AffixContext {
-    trigger: AffixTrigger;
-    kind?: AttackKind;
-}
-export interface AffixDef {
-    id: string;
-    trigger: AffixTrigger;
-    /**
-     * restricts this affix to specific attack kinds within its trigger (a "bow only" affix on
-     * a `strike` trigger); omitted, the affix fires for any kind, the same as before this
-     * existed
-     */
-    kinds?: readonly AttackKind[];
-    /** relative likelihood within its own table; 0 never rolls */
-    weight: number;
-    /** a curse locks the item (see `EquipmentSlots`' lock option) once identified */
-    curse?: boolean;
-    /** shown in an item description; `mwg` never reads this itself */
-    description?: string;
-}
-export interface AffixTable {
-    entries: readonly AffixDef[];
-}
-export interface RollAffixOptions {
-    /** when supplied, only entries with this curse flag are eligible */
-    readonly curse?: boolean;
-    /** an additional game-owned eligibility predicate */
-    readonly predicate?: (entry: AffixDef) => boolean;
-}
-/**
- * Weight-picks one affix from a table - the same "roll whether, then weight-pick which"
- * shape `rollLoot` already is, with a single entry reading as "always this one".
- *
- * @returns null when the table is empty or every entry has weight 0
- */
-export declare function rollAffix(table: AffixTable, options?: RollAffixOptions): AffixDef | null;
-/** the affix an item carries, if any - stored on the item next to its upgrade `level` */
-export declare function affixOf(item: InventoryItem): string | undefined;
-/**
- * Sets an item's affix, replacing any it already had. A curse affix also marks the item
- * `cursed`, so identification and equipment-lock behaviour follow without the game
- * wiring them separately.
- */
-export declare function applyAffix(item: InventoryItem, affix: AffixDef): void;
-/** removes an item's affix (and its curse mark, if the affix was a curse) */
-export declare function removeAffix(item: InventoryItem): void;
-/**
- * Copies `from`'s affix (and curse mark) onto `to`, replacing whatever `to` already had -
- * "transfer" an enchantment or rune between item instances. Clears `to`'s affix when `from`
- * carries none. A true transfer (move rather than copy) is this plus `removeAffix(from)`,
- * left to the caller rather than a second near-identical function.
- */
-export declare function copyAffix(from: InventoryItem, to: InventoryItem): void;
-/**
- * Whether `affix` should fire for `context`: the trigger must match, and when the affix
- * restricts itself to specific attack `kinds`, `context.kind` must be one of them. An affix
- * with no `kinds` fires for any attack kind, unchanged from before this existed.
- */
-export declare function matchesContext(affix: AffixDef, context: AffixContext): boolean;
-//# sourceMappingURL=Affix.d.ts.map

package/dist/actors/Affix.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Affix.d.ts","sourceRoot":"","sources":["../../src/actors/Affix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3D,mGAAmG;AACnG,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzE,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,EAAE,YAAY,CAAC;IAEtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAE9B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IAEf,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAChC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,gBAAqB,GAAG,QAAQ,GAAG,IAAI,CAU5F;AAED,yFAAyF;AACzF,wBAAgB,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAOrE;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAGrD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,GAAG,IAAI,CAOtE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAI9E"}

package/dist/actors/Affix.js

@@ -1,68 +0,0 @@
-import * as Random from '../core/Random.js';
-/**
- * Weight-picks one affix from a table - the same "roll whether, then weight-pick which"
- * shape `rollLoot` already is, with a single entry reading as "always this one".
- *
- * @returns null when the table is empty or every entry has weight 0
- */
-export function rollAffix(table, options = {}) {
-    const live = table.entries.filter((entry) => entry.weight > 0 &&
-        (options.curse === undefined || Boolean(entry.curse) === options.curse) &&
-        (options.predicate?.(entry) ?? true));
-    if (live.length === 0)
-        return null;
-    const index = Random.weighted(live.map((entry) => entry.weight));
-    return index === null ? null : live[index];
-}
-/** the affix an item carries, if any - stored on the item next to its upgrade `level` */
-export function affixOf(item) {
-    return item.affix;
-}
-/**
- * Sets an item's affix, replacing any it already had. A curse affix also marks the item
- * `cursed`, so identification and equipment-lock behaviour follow without the game
- * wiring them separately.
- */
-export function applyAffix(item, affix) {
-    const hadAffix = item.affix !== undefined;
-    item.affix = affix.id;
-    // The curse bit belongs to the affix currently installed.  Replacing a cursed
-    // affix with a benign one must not leave the item permanently cursed.
-    if (affix.curse)
-        item.cursed = true;
-    else if (hadAffix)
-        item.cursed = false;
-}
-/** removes an item's affix (and its curse mark, if the affix was a curse) */
-export function removeAffix(item) {
-    if (item.affix !== undefined)
-        item.cursed = false;
-    delete item.affix;
-}
-/**
- * Copies `from`'s affix (and curse mark) onto `to`, replacing whatever `to` already had -
- * "transfer" an enchantment or rune between item instances. Clears `to`'s affix when `from`
- * carries none. A true transfer (move rather than copy) is this plus `removeAffix(from)`,
- * left to the caller rather than a second near-identical function.
- */
-export function copyAffix(from, to) {
-    if (from.affix === undefined) {
-        removeAffix(to);
-        return;
-    }
-    to.affix = from.affix;
-    to.cursed = from.cursed ?? false;
-}
-/**
- * Whether `affix` should fire for `context`: the trigger must match, and when the affix
- * restricts itself to specific attack `kinds`, `context.kind` must be one of them. An affix
- * with no `kinds` fires for any attack kind, unchanged from before this existed.
- */
-export function matchesContext(affix, context) {
-    if (affix.trigger !== context.trigger)
-        return false;
-    if (affix.kinds && (context.kind === undefined || !affix.kinds.includes(context.kind)))
-        return false;
-    return true;
-}
-//# sourceMappingURL=Affix.js.map

package/dist/actors/Affix.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Affix.js","sourceRoot":"","sources":["../../src/actors/Affix.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AA8E5C;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAiB,EAAE,OAAO,GAAqB,EAAE;IAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAChC,CAAC,KAAK,EAAE,EAAE,CACT,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC;QACvE,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CACrC,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,OAAO,CAAC,IAAmB;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAmB,EAAE,KAAe;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;IAC1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC;IACtB,8EAA8E;IAC9E,sEAAsE;IACtE,IAAI,KAAK,CAAC,KAAK;QAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;SAC/B,IAAI,QAAQ;QAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;AACxC,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,IAAmB;IAC9C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAmB,EAAE,EAAiB;IAC/D,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,WAAW,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO;IACR,CAAC;IACD,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACtB,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAe,EAAE,OAAqB;IACpE,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IACpD,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrG,OAAO,IAAI,CAAC;AACb,CAAC"}