@rpgm-tools/neo-angband-core 0.10.0

package/dist/events.d.ts

@@ -0,0 +1,188 @@
+/**
+ * The game event bus, ported from reference/src/game-event.h and
+ * game-event.c (Angband 4.2.6).
+ *
+ * This is the core-to-UI seam: the engine signals what happened, front
+ * ends subscribe. Event names map 1:1 to the upstream enum (EVENT_MAP ->
+ * "map", EVENT_GEN_LEVEL_START -> "gen-level-start", ...). The C union of
+ * payloads becomes a typed payload map; the C `user` pointer disappears
+ * because closures carry state.
+ */
+import type { Loc } from "./loc.js";
+/** EVENT_MESSAGE / EVENT_INITSTATUS payloads. */
+export interface MessageEventData {
+    /**
+     * The message text, or null. NULL is meaningful and not the same as "":
+     * event_signal_message carries a real string only for EVENT_MESSAGE, and
+     * passes NULL for EVENT_SOUND (message.c:374) and EVENT_BELL (:381). A front
+     * end distinguishing "no message accompanies this" from "an empty message"
+     * needs that, and a port that flattened both to "" could not.
+     */
+    msg: string | null;
+    /** Message type (MSG_* index); front ends map it to color/sound. */
+    type: number;
+}
+/** EVENT_BIRTHPOINTS payload. */
+export interface BirthPointsEventData {
+    points: readonly number[];
+    incPoints: readonly number[];
+    remaining: number;
+}
+/** EVENT_EXPLOSION payload. */
+export interface ExplosionEventData {
+    projType: number;
+    numGrids: number;
+    distanceToGrid: readonly number[];
+    drawing: boolean;
+    playerSeesGrid: readonly boolean[];
+    blastGrid: readonly Loc[];
+    centre: Loc;
+}
+/** EVENT_BOLT payload. */
+export interface BoltEventData {
+    projType: number;
+    drawing: boolean;
+    seen: boolean;
+    beam: boolean;
+    oy: number;
+    ox: number;
+    y: number;
+    x: number;
+}
+/** EVENT_MISSILE payload. The object type is refined once objects land. */
+export interface MissileEventData {
+    obj: unknown;
+    seen: boolean;
+    y: number;
+    x: number;
+}
+/** EVENT_GEN_ROOM_CHOOSE_SIZE payload. */
+export interface SizeEventData {
+    h: number;
+    w: number;
+}
+/** EVENT_GEN_TUNNEL_FINISHED payload. */
+export interface TunnelEventData {
+    /** Total tunneling steps made. */
+    nstep: number;
+    /** Total wall piercings for rooms. */
+    npierce: number;
+    /** Tiles excavated, excluding wall piercings. */
+    ndug: number;
+    /** City-block distance from start to goal. */
+    dstart: number;
+    /** City-block distance from tunnel end to goal; 0 means it arrived. */
+    dend: number;
+    /** True if terminated by the random early-termination criteria. */
+    early: boolean;
+}
+/**
+ * Every game event and its payload type. `undefined` payloads are
+ * signal-only events.
+ */
+export interface GameEventMap {
+    map: Loc | undefined;
+    stats: undefined;
+    hp: undefined;
+    mana: undefined;
+    ac: undefined;
+    experience: undefined;
+    playerlevel: undefined;
+    playertitle: undefined;
+    gold: undefined;
+    monsterhealth: undefined;
+    dungeonlevel: undefined;
+    playerspeed: undefined;
+    "race-class": undefined;
+    studystatus: undefined;
+    status: undefined;
+    detectionstatus: undefined;
+    feeling: undefined;
+    light: undefined;
+    state: undefined;
+    playermoved: undefined;
+    seefloor: undefined;
+    explosion: ExplosionEventData;
+    bolt: BoltEventData;
+    missile: MissileEventData;
+    inventory: undefined;
+    equipment: undefined;
+    itemlist: undefined;
+    monsterlist: undefined;
+    monstertarget: undefined;
+    objecttarget: undefined;
+    message: MessageEventData;
+    sound: MessageEventData;
+    bell: MessageEventData;
+    "use-store": undefined;
+    storechanged: undefined;
+    "input-flush": undefined;
+    "message-flush": undefined;
+    "check-interrupt": undefined;
+    refresh: undefined;
+    "new-level-display": undefined;
+    "command-repeat": undefined;
+    animate: undefined;
+    "cheat-death": undefined;
+    initstatus: MessageEventData;
+    birthpoints: BirthPointsEventData;
+    "enter-init": undefined;
+    "leave-init": undefined;
+    "enter-birth": undefined;
+    "leave-birth": undefined;
+    "enter-game": undefined;
+    "leave-game": undefined;
+    "enter-world": undefined;
+    "leave-world": undefined;
+    "enter-store": undefined;
+    "leave-store": undefined;
+    "enter-death": undefined;
+    "leave-death": undefined;
+    "gen-level-start": string;
+    "gen-level-end": boolean;
+    "gen-room-start": string;
+    "gen-room-choose-size": SizeEventData;
+    "gen-room-choose-subtype": string;
+    "gen-room-end": boolean;
+    "gen-tunnel-finished": TunnelEventData;
+    end: undefined;
+}
+export type GameEventType = keyof GameEventMap;
+/** All event types, in upstream enum order. */
+export declare const GAME_EVENT_TYPES: readonly GameEventType[];
+export type GameEventHandler<K extends GameEventType> = (type: K, data: GameEventMap[K]) => void;
+/**
+ * Typed pub/sub bus mirroring game-event.c's handler chains. Handlers for
+ * one type are called in registration order, exactly like the upstream
+ * linked list traversal.
+ */
+export declare class GameEvents {
+    private handlers;
+    /** event_add_handler. */
+    on<K extends GameEventType>(type: K, fn: GameEventHandler<K>): void;
+    /** event_remove_handler. */
+    off<K extends GameEventType>(type: K, fn: GameEventHandler<K>): void;
+    /** event_add_handler_set. */
+    onSet(types: readonly GameEventType[], fn: GameEventHandler<GameEventType>): void;
+    /** event_remove_handler_set. */
+    offSet(types: readonly GameEventType[], fn: GameEventHandler<GameEventType>): void;
+    /** event_remove_handler_type. */
+    removeHandlersOf(type: GameEventType): void;
+    /** event_remove_all_handlers. */
+    removeAllHandlers(): void;
+    /**
+     * event_signal and the typed event_signal_* helpers, unified: the C union
+     * payload is a typed payload map, so event_signal_message (game-event.c:172),
+     * event_signal_string, event_signal_point and event_signal_birthpoints are
+     * all this one call with a different payload type.
+     */
+    emit<K extends GameEventType>(type: K, data: GameEventMap[K]): void;
+    /** event_signal: signal-only convenience for payload-less events. */
+    signal<K extends GameEventType & SignalOnly>(type: K): void;
+}
+/** Event types whose payload is undefined (signal-only). */
+type SignalOnly = {
+    [K in GameEventType]: undefined extends GameEventMap[K] ? K : never;
+}[GameEventType];
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,138 @@
+/**
+ * The game event bus, ported from reference/src/game-event.h and
+ * game-event.c (Angband 4.2.6).
+ *
+ * This is the core-to-UI seam: the engine signals what happened, front
+ * ends subscribe. Event names map 1:1 to the upstream enum (EVENT_MAP ->
+ * "map", EVENT_GEN_LEVEL_START -> "gen-level-start", ...). The C union of
+ * payloads becomes a typed payload map; the C `user` pointer disappears
+ * because closures carry state.
+ */
+/** All event types, in upstream enum order. */
+export const GAME_EVENT_TYPES = [
+    "map",
+    "stats",
+    "hp",
+    "mana",
+    "ac",
+    "experience",
+    "playerlevel",
+    "playertitle",
+    "gold",
+    "monsterhealth",
+    "dungeonlevel",
+    "playerspeed",
+    "race-class",
+    "studystatus",
+    "status",
+    "detectionstatus",
+    "feeling",
+    "light",
+    "state",
+    "playermoved",
+    "seefloor",
+    "explosion",
+    "bolt",
+    "missile",
+    "inventory",
+    "equipment",
+    "itemlist",
+    "monsterlist",
+    "monstertarget",
+    "objecttarget",
+    "message",
+    "sound",
+    "bell",
+    "use-store",
+    "storechanged",
+    "input-flush",
+    "message-flush",
+    "check-interrupt",
+    "refresh",
+    "new-level-display",
+    "command-repeat",
+    "animate",
+    "cheat-death",
+    "initstatus",
+    "birthpoints",
+    "enter-init",
+    "leave-init",
+    "enter-birth",
+    "leave-birth",
+    "enter-game",
+    "leave-game",
+    "enter-world",
+    "leave-world",
+    "enter-store",
+    "leave-store",
+    "enter-death",
+    "leave-death",
+    "gen-level-start",
+    "gen-level-end",
+    "gen-room-start",
+    "gen-room-choose-size",
+    "gen-room-choose-subtype",
+    "gen-room-end",
+    "gen-tunnel-finished",
+    "end",
+];
+/**
+ * Typed pub/sub bus mirroring game-event.c's handler chains. Handlers for
+ * one type are called in registration order, exactly like the upstream
+ * linked list traversal.
+ */
+export class GameEvents {
+    handlers = new Map();
+    /** event_add_handler. */
+    on(type, fn) {
+        const list = this.handlers.get(type) ?? [];
+        list.push(fn);
+        this.handlers.set(type, list);
+    }
+    /** event_remove_handler. */
+    off(type, fn) {
+        const list = this.handlers.get(type);
+        if (!list)
+            return;
+        const i = list.indexOf(fn);
+        if (i >= 0)
+            list.splice(i, 1);
+    }
+    /** event_add_handler_set. */
+    onSet(types, fn) {
+        for (const t of types)
+            this.on(t, fn);
+    }
+    /** event_remove_handler_set. */
+    offSet(types, fn) {
+        for (const t of types)
+            this.off(t, fn);
+    }
+    /** event_remove_handler_type. */
+    removeHandlersOf(type) {
+        this.handlers.delete(type);
+    }
+    /** event_remove_all_handlers. */
+    removeAllHandlers() {
+        this.handlers.clear();
+    }
+    /**
+     * event_signal and the typed event_signal_* helpers, unified: the C union
+     * payload is a typed payload map, so event_signal_message (game-event.c:172),
+     * event_signal_string, event_signal_point and event_signal_birthpoints are
+     * all this one call with a different payload type.
+     */
+    emit(type, data) {
+        const list = this.handlers.get(type);
+        if (!list)
+            return;
+        // Copy so handlers that unsubscribe during dispatch do not skip peers.
+        for (const fn of [...list])
+            fn(type, data);
+    }
+    /** event_signal: signal-only convenience for payload-less events. */
+    signal(type) {
+        this.emit(type, undefined);
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/expression.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Simple math expressions, ported from reference/src/z-expression.c/h
+ * (Angband 4.2.6).
+ *
+ * An expression is a base value function plus a list of (operator, operand)
+ * operations applied to an accumulator strictly left to right; there is NO
+ * operator precedence. The string form is prefix/space-delimited and must
+ * start with an operator: "+ 1 2 3" means ((base + 1) + 2) + 3 and
+ * "+ 2 * 3" means (base + 2) * 3. An operator with multiple following
+ * operands is applied once per operand; negation ("n" or "N") is unary and
+ * takes no operand.
+ *
+ * Number tokens are parsed with C strtol(str, &end, 0) semantics: base is
+ * auto-detected, so "0x1A" is hex and "017" is OCTAL (15). Any token where
+ * strtol consumes at least one character is treated as a value, even with
+ * trailing junk ("5abc" is the value 5). Operands must fit in int16
+ * (-32768..32767). Arithmetic is C int32: wrap on add/sub/mul, truncation
+ * toward zero on division.
+ *
+ * Parsing appends at most EXPRESSION_MAX_OPERATIONS (50) operations per
+ * call and silently drops the rest, as upstream. On a parse error nothing
+ * is appended and the (negative) error code is returned.
+ */
+export declare const EXPRESSION_ERR_GENERIC = -1;
+export declare const EXPRESSION_ERR_INVALID_OPERATOR = -2;
+export declare const EXPRESSION_ERR_EXPECTED_OPERATOR = -3;
+export declare const EXPRESSION_ERR_EXPECTED_OPERAND = -4;
+export declare const EXPRESSION_ERR_DIVIDE_BY_ZERO = -5;
+export declare const EXPRESSION_ERR_OPERAND_OUT_OF_BOUNDS = -6;
+/** expression_base_value_f: returns the int32 the operations start from. */
+export type ExpressionBaseValue = () => number;
+/** Maximum number of operations added by one parse call. */
+export declare const EXPRESSION_MAX_OPERATIONS = 50;
+/**
+ * C strtol(nptr, &endptr, 0) replica used by the expression and dice
+ * parsers: optional whitespace, optional sign, then auto-detected base
+ * ("0x"/"0X" prefix is hex, leading "0" is octal, otherwise decimal).
+ * Returns the parsed value and the number of characters consumed; consumed
+ * is 0 when no digits were found (endptr == nptr upstream). Long-overflow
+ * saturation is not replicated (tokens here are at most 16 chars).
+ */
+export declare function strtolBase0(s: string): {
+    value: number;
+    consumed: number;
+};
+/**
+ * expression_t. Construction is expression_new; there is no expression_free
+ * (garbage collected). operationsSize mirrors the upstream capacity
+ * bookkeeping so expressionTestCopy can compare it faithfully.
+ */
+export declare class Expression {
+    private baseValue;
+    private operations;
+    private operationsSize;
+    /** expression_copy: a deep copy sharing the base value function. */
+    copy(): Expression;
+    /** expression_set_base_value. */
+    setBaseValue(fn: ExpressionBaseValue): void;
+    /**
+     * expression_evaluate: applies the operations left to right with C int32
+     * semantics. With no base value function, evaluation starts from zero.
+     */
+    evaluate(): number;
+    /** expression_add_operation, including the capacity bookkeeping. */
+    private addOperation;
+    /**
+     * expression_add_operations_string: parses a prefix-notation string and
+     * appends its operations. Returns the number of operations added, or a
+     * negative expression error code (in which case nothing is appended).
+     * The upstream NULL string case maps to null/undefined.
+     */
+    addOperationsString(str: string | null | undefined): number;
+    /** Internal snapshot for expressionTestCopy. */
+    private snapshot;
+    /**
+     * expression_test_copy: checks that b is a value-equal deep copy of a
+     * (distinct objects, same base value function, same operations).
+     */
+    static testCopy(a: Expression | null, b: Expression | null): boolean;
+}
+/** Function-style alias for upstream expression_test_copy. */
+export declare function expressionTestCopy(a: Expression | null, b: Expression | null): boolean;
+//# sourceMappingURL=expression.d.ts.map

package/dist/expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../src/expression.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,eAAO,MAAM,oCAAoC,KAAK,CAAC;AAEvD,4EAA4E;AAC5E,MAAM,MAAM,mBAAmB,GAAG,MAAM,MAAM,CAAC;AA6B/C,4DAA4D;AAC5D,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAyC5C;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAgC1E;AA4CD;;;;GAIG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,cAAc,CAAyB;IAE/C,oEAAoE;IACpE,IAAI,IAAI,UAAU;IAQlB,iCAAiC;IACjC,YAAY,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI;IAI3C;;;OAGG;IACH,QAAQ,IAAI,MAAM;IA2BlB,oEAAoE;IACpE,OAAO,CAAC,YAAY;IAOpB;;;;;OAKG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM;IA4D3D,gDAAgD;IAChD,OAAO,CAAC,QAAQ;IAYhB;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO;CAkBrE;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,UAAU,GAAG,IAAI,EACpB,CAAC,EAAE,UAAU,GAAG,IAAI,GACnB,OAAO,CAET"}