@datamoc/mw_games 0.1.1 → 0.2.0

package/dist/rpg/Marshal.js

@@ -0,0 +1,393 @@
+/**
+ * Ruby's `Marshal` binary serialisation format (version 4.8, unchanged since Ruby 1.8) -
+ * the container `Game.rxdata` and every other RPG Maker XP/VX save are written in. This is
+ * format engineering, not RPG Maker's own code or content: the byte layout below is Ruby's
+ * own standard-library format, learned the ordinary way any undocumented format is, by
+ * reading real files in it. Nothing here knows what an RPG Maker save's own classes
+ * (`Game_Party`, `Game_Actor`) mean; it only turns the container's bytes into a faithful,
+ * generic JS shape a game can then interpret however it needs to. See CLAUDE.md's licence
+ * convention and ROADMAP.md item 100 for where this line sits.
+ *
+ * What decodes: nil, true, false, Fixnum, Bignum, Float, String, Symbol, Array, Hash
+ * (including one with a default value, read separately via `hashDefaultOf` rather than as a
+ * fake entry - a real Hash key equal to any string sentinel would otherwise collide with
+ * it), and Object (`o`, a class name plus its instance variables) - everything a plain-data
+ * save file actually needs. `_dump`/`_load` values
+ * (`u`) decode to their class name plus the opaque bytes their own `_load` would need,
+ * since that per-class binary layout is a second, undocumented format nested inside this
+ * one and out of scope the same way a container format never explains the media it holds.
+ * `marshal_dump`/`marshal_load` values (`U`) decode fully, since their payload is an
+ * ordinary Marshal value. Backreferences (`@`, `;`) resolve against the same link tables a
+ * real Ruby `Marshal.load` keeps, so a value referenced twice decodes to the same object
+ * twice rather than being duplicated.
+ */
+/**
+ * Marks a JS string as a Ruby Symbol rather than a String when encoding - `decodeMarshal`
+ * maps both to a plain JS string (the distinction rarely matters for reading a save back),
+ * but writing needs to know which one to produce. `RubyObject.ivars`' keys are always
+ * written as symbols regardless, since that half of the format has no other option.
+ */
+export class RubySymbol {
+    constructor(name) {
+        this.name = name;
+    }
+}
+const MARSHAL_MAJOR = 4;
+const MARSHAL_MINOR = 8;
+//a Hash.new(default)'s default value, keyed by the decoded Map itself rather than a fake
+//entry - a real Hash key equal to any string sentinel would otherwise be overwritten
+const hashDefaults = new WeakMap();
+/** the default value of a Hash decoded from `Hash.new(default)` (Marshal's `}` tag), if any */
+export function hashDefaultOf(hash) {
+    return hashDefaults.get(hash);
+}
+/** marks a Map for `encodeMarshal` to write back out as a `Hash.new(default)`, tag `}` */
+export function withHashDefault(hash, defaultValue) {
+    hashDefaults.set(hash, defaultValue);
+    return hash;
+}
+class Reader {
+    constructor(bytes) {
+        this.pos = 0;
+        this.symbols = [];
+        this.objects = [];
+        this.bytes = bytes;
+    }
+    byte() {
+        if (this.pos >= this.bytes.length)
+            throw new Error('Marshal: unexpected end of input');
+        return this.bytes[this.pos++];
+    }
+    take(count) {
+        //a negative count (a corrupt length-prefixed field) would otherwise pass the length
+        //check below silently, since subarray(pos, pos + count) with count < 0 clamps to an
+        //empty slice rather than throwing, and rewind pos backward instead of erroring
+        if (count < 0)
+            throw new Error('Marshal: negative length');
+        const slice = this.bytes.subarray(this.pos, this.pos + count);
+        if (slice.length < count)
+            throw new Error('Marshal: unexpected end of input');
+        this.pos += count;
+        return slice;
+    }
+    /** Ruby's variable-length integer encoding - see the module doc for the byte layout */
+    readFixnum() {
+        const c = this.byte() << 24 >> 24; // reinterpret as signed 8-bit
+        if (c === 0)
+            return 0;
+        if (c >= 5 && c <= 127)
+            return c - 5;
+        if (c <= -5 && c >= -128)
+            return c + 5;
+        if (c > 0) {
+            let value = 0;
+            for (let i = 0; i < c; i++)
+                value |= this.byte() << (8 * i);
+            return value >>> 0;
+        }
+        const n = -c;
+        let value = 0;
+        for (let i = 0; i < n; i++)
+            value |= this.byte() << (8 * i);
+        return (value >>> 0) - 2 ** (8 * n);
+    }
+    readBytes() {
+        return this.take(this.readFixnum());
+    }
+    readSymbol() {
+        const name = new TextDecoder().decode(this.readBytes());
+        this.symbols.push(name);
+        return name;
+    }
+    readSymbolLink() {
+        const index = this.readFixnum();
+        const name = this.symbols[index];
+        if (name === undefined)
+            throw new Error(`Marshal: symbol link ${index} out of range`);
+        return name;
+    }
+    /** reads whichever of `:` (a new symbol) or `;` (a link to one already seen) comes next */
+    readSymbolValue() {
+        const tag = String.fromCharCode(this.byte());
+        if (tag === ':')
+            return this.readSymbol();
+        if (tag === ';')
+            return this.readSymbolLink();
+        throw new Error(`Marshal: expected a symbol, got tag "${tag}"`);
+    }
+    link(value) {
+        this.objects.push(value);
+        return value;
+    }
+    /**
+     * A Bignum decodes to a plain JS `number`, not a `bigint` - correct up to
+     * `Number.MAX_SAFE_INTEGER` (2^53), silently imprecise past it, the same rounding a plain
+     * `JSON.parse` of a huge integer already has. RPG Maker save data has no legitimate use
+     * for an integer that large (`Game_Party`'s gold, item counts, switch/variable ids are
+     * all ordinary Fixnum range), so this stays a `number` for a uniform return type rather
+     * than `number | bigint` for a case no real `.rxdata` file exercises.
+     */
+    readBignum() {
+        const sign = String.fromCharCode(this.byte()) === '-' ? -1 : 1;
+        const words = this.readFixnum();
+        let value = 0;
+        let multiplier = 1;
+        for (let i = 0; i < words; i++) {
+            value += (this.byte() | (this.byte() << 8)) * multiplier;
+            multiplier *= 65536;
+        }
+        return sign * value;
+    }
+    readFloat() {
+        const text = new TextDecoder().decode(this.readBytes());
+        if (text === 'inf')
+            return Infinity;
+        if (text === '-inf')
+            return -Infinity;
+        if (text === 'nan')
+            return NaN;
+        return Number(text);
+    }
+    readArray() {
+        const array = [];
+        this.link(array);
+        const length = this.readFixnum();
+        for (let i = 0; i < length; i++)
+            array.push(this.readValue());
+        return array;
+    }
+    readHash(withDefault) {
+        const map = new Map();
+        this.link(map);
+        const length = this.readFixnum();
+        for (let i = 0; i < length; i++)
+            map.set(this.readValue(), this.readValue());
+        //a Hash.new(default)'s default lives out of band, in hashDefaults - never as a fake
+        //entry, which a real key equal to that sentinel would silently collide with
+        if (withDefault)
+            hashDefaults.set(map, this.readValue());
+        return map;
+    }
+    readIvars(count) {
+        const ivars = {};
+        for (let i = 0; i < count; i++)
+            ivars[this.readSymbolValue()] = this.readValue();
+        return ivars;
+    }
+    readObject() {
+        const object = { class: '', ivars: {} };
+        this.link(object);
+        object.class = this.readSymbolValue();
+        object.ivars = this.readIvars(this.readFixnum());
+        return object;
+    }
+    /** a string, possibly wrapped in `I` (instance-variable) metadata such as its encoding */
+    readIvarWrapped() {
+        const value = this.readValue();
+        this.readIvars(this.readFixnum()); // encoding/other ivars are metadata this reader does not expose
+        return value;
+    }
+    readUserDefined() {
+        const value = { class: '', raw: new Uint8Array() };
+        this.link(value);
+        value.class = this.readSymbolValue();
+        value.raw = this.readBytes().slice();
+        return value;
+    }
+    readUserMarshal() {
+        const wrapper = { class: '', value: null };
+        this.link(wrapper);
+        wrapper.class = this.readSymbolValue();
+        wrapper.value = this.readValue();
+        return wrapper;
+    }
+    readValue() {
+        const tag = String.fromCharCode(this.byte());
+        switch (tag) {
+            case '0':
+                return null;
+            case 'T':
+                return true;
+            case 'F':
+                return false;
+            case 'i':
+                return this.readFixnum();
+            case 'l':
+                return this.link(this.readBignum());
+            case 'f':
+                return this.link(this.readFloat());
+            case ':':
+                return this.readSymbol();
+            case ';':
+                return this.readSymbolLink();
+            case '"':
+                return this.link(new TextDecoder().decode(this.readBytes()));
+            case '[':
+                return this.readArray();
+            case '{':
+                return this.readHash(false);
+            case '}':
+                return this.readHash(true);
+            case 'o':
+                return this.readObject();
+            case 'I':
+                return this.readIvarWrapped();
+            case 'u':
+                return this.readUserDefined();
+            case 'U':
+                return this.readUserMarshal();
+            case '@': {
+                const index = this.readFixnum();
+                const value = this.objects[index];
+                if (value === undefined)
+                    throw new Error(`Marshal: object link ${index} out of range`);
+                return value;
+            }
+            default:
+                throw new Error(`Marshal: unsupported tag "${tag}" (0x${tag.charCodeAt(0).toString(16)})`);
+        }
+    }
+    readDocument() {
+        const major = this.byte();
+        const minor = this.byte();
+        if (major !== MARSHAL_MAJOR || minor > MARSHAL_MINOR) {
+            throw new Error(`Marshal: unsupported version ${major}.${minor} (expected ${MARSHAL_MAJOR}.${MARSHAL_MINOR} or lower)`);
+        }
+        return this.readValue();
+    }
+}
+/** decodes one Marshal document (a whole `.rxdata` file, or any other Marshal dump) */
+export function decodeMarshal(bytes) {
+    return new Reader(bytes).readDocument();
+}
+function isRubyObject(value) {
+    return typeof value === 'object' && value !== null && 'class' in value && 'ivars' in value;
+}
+/**
+ * Encodes one Marshal document from the same shapes `decodeMarshal` produces: `null`,
+ * `boolean`, `number` (written as a Fixnum when it is a safe integer, a Float otherwise),
+ * `string` (a Marshal String, unless wrapped in `RubySymbol`), `Array`, `Map` (a Hash, key
+ * order preserved), and `RubyObject`.
+ *
+ * Every value is written fresh rather than reusing Ruby's own backreference scheme for a
+ * repeated string, symbol or object - valid Marshal either way, since backreferences are an
+ * optional size optimisation, not something a reader is required to produce. A save written
+ * this way is larger than Ruby's own `Marshal.dump` would make it, never incorrect.
+ * `RubyUserDefined` (a `_dump`/`_load` value) cannot be re-encoded at all, for the same
+ * reason `decodeMarshal` cannot interpret its bytes: that per-class binary layout is a
+ * second format this module was never taught.
+ */
+export function encodeMarshal(value) {
+    const chunks = [MARSHAL_MAJOR, MARSHAL_MINOR];
+    writeValue(chunks, value);
+    return new Uint8Array(chunks);
+}
+function writeValue(out, value) {
+    if (value === null || value === undefined) {
+        out.push(char('0'));
+    }
+    else if (value === true) {
+        out.push(char('T'));
+    }
+    else if (value === false) {
+        out.push(char('F'));
+    }
+    else if (value instanceof RubySymbol) {
+        out.push(char(':'));
+        writeByteString(out, value.name);
+    }
+    else if (typeof value === 'number') {
+        if (Number.isInteger(value) && Math.abs(value) < 2 ** 30) {
+            out.push(char('i'));
+            writeFixnum(out, value);
+        }
+        else {
+            out.push(char('f'));
+            writeByteString(out, Number.isFinite(value) ? String(value) : value > 0 ? 'inf' : value < 0 ? '-inf' : 'nan');
+        }
+    }
+    else if (typeof value === 'string') {
+        out.push(char('"'));
+        writeByteString(out, value);
+    }
+    else if (Array.isArray(value)) {
+        out.push(char('['));
+        writeFixnum(out, value.length);
+        for (const item of value)
+            writeValue(out, item);
+    }
+    else if (value instanceof Map) {
+        const hasDefault = hashDefaults.has(value);
+        out.push(char(hasDefault ? '}' : '{'));
+        writeFixnum(out, value.size);
+        for (const [key, entry] of value) {
+            writeValue(out, key);
+            writeValue(out, entry);
+        }
+        if (hasDefault)
+            writeValue(out, hashDefaults.get(value));
+    }
+    else if (isRubyObject(value)) {
+        out.push(char('o'));
+        out.push(char(':'));
+        writeByteString(out, value.class);
+        const entries = Object.entries(value.ivars);
+        writeFixnum(out, entries.length);
+        for (const [name, ivarValue] of entries) {
+            out.push(char(':'));
+            writeByteString(out, name);
+            writeValue(out, ivarValue);
+        }
+    }
+    else {
+        throw new Error(`Marshal: cannot encode a value of type ${typeof value}`);
+    }
+}
+function char(c) {
+    return c.charCodeAt(0);
+}
+function writeByteString(out, text) {
+    const bytes = new TextEncoder().encode(text);
+    writeFixnum(out, bytes.length);
+    for (const byte of bytes)
+        out.push(byte);
+}
+/** the inverse of `Reader`'s `readFixnum` - see the module doc for the encoding this mirrors */
+function writeFixnum(out, value) {
+    if (value === 0) {
+        out.push(0);
+        return;
+    }
+    if (value > 0 && value <= 122) {
+        out.push(value + 5);
+        return;
+    }
+    if (value < 0 && value >= -123) {
+        out.push((value - 5) & 0xff);
+        return;
+    }
+    //falls back to the smallest byte count (1-4) that round-trips through readFixnum
+    if (value > 0) {
+        for (let n = 1; n <= 4; n++) {
+            if (value < 2 ** (8 * n)) {
+                out.push(n);
+                for (let i = 0; i < n; i++)
+                    out.push((value >>> (8 * i)) & 0xff);
+                return;
+            }
+        }
+    }
+    else {
+        for (let n = 1; n <= 4; n++) {
+            if (value >= -(2 ** (8 * n))) {
+                out.push((-n) & 0xff);
+                const unsigned = value + 2 ** (8 * n);
+                for (let i = 0; i < n; i++)
+                    out.push((unsigned >>> (8 * i)) & 0xff);
+                return;
+            }
+        }
+    }
+    throw new Error(`Marshal: integer ${value} is out of range for a Fixnum`);
+}
+//# sourceMappingURL=Marshal.js.map

package/dist/rpg/Marshal.js.map

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

package/dist/rpg/Quest.d.ts

@@ -15,6 +15,17 @@ export interface QuestStage {
     };
     /** shown in a quest log's progress readout; `mwg` never reads this itself */
     description?: string;
+    /**
+     * Where this stage is satisfied, if anywhere in particular - "kill 5 rats" can
+     * optionally also say where the rats are. `mwg` only carries this data; turning it into
+     * a route or a compass arrow is `roguelike.Pathfinder`'s job (already has everything
+     * needed: `find`/`step`/`distanceMap`) plus the game's own presentation.
+     */
+    location?: {
+        map?: string;
+        x: number;
+        y: number;
+    };
 }
 export interface QuestDefinition {
     id: string;
@@ -23,6 +34,15 @@ export interface QuestDefinition {
     requires?: string[];
 }
 export type QuestStatus = 'unavailable' | 'available' | 'active' | 'complete';
+/**
+ * What an NPC (or anything else tied to a quest) currently has to offer the player, derived
+ * the same way `Achievements`' unlocking already is rather than stored separately:
+ * `'offer'` if any tied quest could be started, `'turnIn'` if any is active and its current
+ * stage is already satisfied (ready to close out, whether or not the player has actually
+ * walked up and done so), `'none'` otherwise. The actual `!`, its colour, and where it
+ * floats above a sprite stay the game's own art and UI - this is only the derived bit.
+ */
+export type QuestMarker = 'offer' | 'turnIn' | 'none';
 /**
  * Tracks which stage every known quest is on, against `GameState`'s existing switches and
  * variables - not a storage mechanism of its own. A quest's *definition* (its stages, its
@@ -33,7 +53,24 @@ export declare class QuestLog {
     private definitions;
     /** the stage index a started quest is on; absent means not yet started */
     private stageIndex;
+    /** the one active quest a game currently points the player towards, if any */
+    private tracked;
     define(quest: QuestDefinition): void;
+    /** marks `id` as the quest a game currently guides the player towards; `null` to clear it */
+    track(id: string | null): void;
+    /** the currently tracked quest id, or `null` if none is tracked or it is no longer active */
+    trackedQuest(): string | null;
+    /** where the tracked quest's current stage is satisfied, if it says anywhere at all */
+    trackedLocation(): {
+        map?: string;
+        x: number;
+        y: number;
+    } | null;
+    /**
+     * Derives what an NPC tied to `ids` currently has to offer - see `QuestMarker`. Checking
+     * several ids at once covers an NPC that gives one quest and takes in another.
+     */
+    markerFor(ids: readonly string[], state: GameState): QuestMarker;
     /** whether every prerequisite is already complete, so the quest could be started */
     canStart(id: string): boolean;
     /** begins a quest; throws if a prerequisite is not yet complete */
@@ -55,13 +92,17 @@ export declare class QuestLog {
      * @returns true if a stage (or the whole quest) completed this call
      */
     advance(id: string, state: GameState): boolean;
+    /** whether the current stage's condition or counter already holds, without advancing it */
+    private stageSatisfied;
     private require;
     toJSON(): {
         stageIndex: [string, number][];
+        tracked: string | null;
     };
     /** rebuilds a log from save data - `definitions` are supplied fresh, the same as `ITEMS` */
     static fromJSON(definitions: QuestDefinition[], data: {
         stageIndex: [string, number][];
+        tracked?: string | null;
     }): QuestLog;
 }
 //# sourceMappingURL=Quest.d.ts.map

package/dist/rpg/Quest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Quest.d.ts","sourceRoot":"","sources":["../../src/rpg/Quest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IAC1B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,OAAO,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAE/C,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,EAAE,CAAC;IAErB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9E;;;;;GAKG;AACH,qBAAa,QAAQ;IACpB,OAAO,CAAC,WAAW,CAAsC;IAEzD,0EAA0E;IAC1E,OAAO,CAAC,UAAU,CAA6B;IAE/C,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAEnC;IAED,oFAAoF;IACpF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG5B;IAED,mEAAmE;IACnE,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAGtB;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAK9B;IAED,uFAAuF;IACvF,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAG1C;IAED,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAIpD;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAa7C;IAED,OAAO,CAAC,OAAO;IAMf,MAAM,IAAI;QAAE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,CAE3C;IAED,4FAA4F;IAC5F,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE;QAAE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,GAAG,QAAQ,CAKlG;CACD"}
+{"version":3,"file":"Quest.d.ts","sourceRoot":"","sources":["../../src/rpg/Quest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IAC1B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,OAAO,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAE/C,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,EAAE,CAAC;IAErB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtD;;;;;GAKG;AACH,qBAAa,QAAQ;IACpB,OAAO,CAAC,WAAW,CAAsC;IAEzD,0EAA0E;IAC1E,OAAO,CAAC,UAAU,CAA6B;IAE/C,8EAA8E;IAC9E,OAAO,CAAC,OAAO,CAAuB;IAEtC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAEnC;IAED,6FAA6F;IAC7F,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAG7B;IAED,6FAA6F;IAC7F,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,uFAAuF;IACvF,eAAe,IAAI;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAG/D;IAED;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,GAAG,WAAW,CAI/D;IAED,oFAAoF;IACpF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAG5B;IAED,mEAAmE;IACnE,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAGtB;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAK9B;IAED,uFAAuF;IACvF,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAG1C;IAED,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAIpD;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAK7C;IAED,2FAA2F;IAC3F,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,OAAO;IAMf,MAAM,IAAI;QAAE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAEnE;IAED,4FAA4F;IAC5F,MAAM,CAAC,QAAQ,CACd,WAAW,EAAE,eAAe,EAAE,EAC9B,IAAI,EAAE;QAAE,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAC/D,QAAQ,CAMV;CACD"}

package/dist/rpg/Quest.js

@@ -10,10 +10,38 @@ export class QuestLog {
         this.definitions = new Map();
         /** the stage index a started quest is on; absent means not yet started */
         this.stageIndex = new Map();
+        /** the one active quest a game currently points the player towards, if any */
+        this.tracked = null;
     }
     define(quest) {
         this.definitions.set(quest.id, quest);
     }
+    /** marks `id` as the quest a game currently guides the player towards; `null` to clear it */
+    track(id) {
+        if (id !== null)
+            this.require(id);
+        this.tracked = id;
+    }
+    /** the currently tracked quest id, or `null` if none is tracked or it is no longer active */
+    trackedQuest() {
+        return this.tracked !== null && this.status(this.tracked) === 'active' ? this.tracked : null;
+    }
+    /** where the tracked quest's current stage is satisfied, if it says anywhere at all */
+    trackedLocation() {
+        const id = this.trackedQuest();
+        return id ? (this.currentStage(id)?.location ?? null) : null;
+    }
+    /**
+     * Derives what an NPC tied to `ids` currently has to offer - see `QuestMarker`. Checking
+     * several ids at once covers an NPC that gives one quest and takes in another.
+     */
+    markerFor(ids, state) {
+        if (ids.some((id) => this.status(id) === 'active' && this.stageSatisfied(id, state)))
+            return 'turnIn';
+        if (ids.some((id) => this.status(id) === 'available'))
+            return 'offer';
+        return 'none';
+    }
     /** whether every prerequisite is already complete, so the quest could be started */
     canStart(id) {
         const quest = this.require(id);
@@ -57,18 +85,21 @@ export class QuestLog {
      * @returns true if a stage (or the whole quest) completed this call
      */
     advance(id, state) {
+        if (!this.stageSatisfied(id, state))
+            return false;
+        this.stageIndex.set(id, this.stageIndex.get(id) + 1);
+        return true;
+    }
+    /** whether the current stage's condition or counter already holds, without advancing it */
+    stageSatisfied(id, state) {
         const stage = this.currentStage(id);
         if (!stage)
             return false;
-        const done = stage.condition
+        return stage.condition
             ? conditionHolds(stage.condition, state)
             : stage.counter
                 ? state.variable(stage.counter.variable) >= stage.counter.target
                 : true;
-        if (!done)
-            return false;
-        this.stageIndex.set(id, this.stageIndex.get(id) + 1);
-        return true;
     }
     require(id) {
         const quest = this.definitions.get(id);
@@ -77,7 +108,7 @@ export class QuestLog {
         return quest;
     }
     toJSON() {
-        return { stageIndex: [...this.stageIndex] };
+        return { stageIndex: [...this.stageIndex], tracked: this.tracked };
     }
     /** rebuilds a log from save data - `definitions` are supplied fresh, the same as `ITEMS` */
     static fromJSON(definitions, data) {
@@ -86,6 +117,8 @@ export class QuestLog {
             log.define(quest);
         for (const [id, index] of data.stageIndex)
             log.stageIndex.set(id, index);
+        if (data.tracked)
+            log.tracked = data.tracked;
         return log;
     }
 }

package/dist/rpg/Quest.js.map

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

package/dist/rpg/index.d.ts

@@ -9,6 +9,12 @@ export { EventRunner } from './EventRunner.ts';
 export type { EventCommand, EventRunnerState, EventRunnerOptions, MoveStep } from './EventRunner.ts';
 export { GridMover } from './GridMover.ts';
 export type { GridMoverOptions, Direction4 } from './GridMover.ts';
+export { FreeMover } from './FreeMover.ts';
+export type { FreeMoverOptions } from './FreeMover.ts';
+export { aabbOverlap, circleOverlap, circleAabbOverlap, resolveAabbAgainstTiles } from './Collision.ts';
+export type { AABB, Circle, SolidTile, ResolveTileMoveOptions } from './Collision.ts';
 export { QuestLog } from './Quest.ts';
-export type { QuestStage, QuestDefinition, QuestStatus } from './Quest.ts';
+export type { QuestStage, QuestDefinition, QuestStatus, QuestMarker } from './Quest.ts';
+export { decodeMarshal, encodeMarshal, RubySymbol, hashDefaultOf, withHashDefault } from './Marshal.ts';
+export type { RubyObject, RubyUserDefined } from './Marshal.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/rpg/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rpg/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC3H,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rpg/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC3H,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACxG,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxG,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/rpg/index.js

@@ -4,5 +4,8 @@ export { GameState } from './GameState.js';
 export { activePage, conditionHolds } from './Event.js';
 export { EventRunner } from './EventRunner.js';
 export { GridMover } from './GridMover.js';
+export { FreeMover } from './FreeMover.js';
+export { aabbOverlap, circleOverlap, circleAabbOverlap, resolveAabbAgainstTiles } from './Collision.js';
 export { QuestLog } from './Quest.js';
+export { decodeMarshal, encodeMarshal, RubySymbol, hashDefaultOf, withHashDefault } from './Marshal.js';
 //# sourceMappingURL=index.js.map

package/dist/rpg/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rpg/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rpg/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAExG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}