@rpgm-tools/neo-angband-core 0.10.0

package/src/generated/square-flags.ts

@@ -0,0 +1,56 @@
+// Generated from reference/src/list-square-flags.h by scripts/codegen-lists.mjs. Do not edit.
+
+/**
+ * Special grid flags (cave.h SQUARE_ enum).
+ */
+
+export const SQUARE_FLAG_ENTRIES = [
+  { name: "NONE", description: "" },
+  { name: "MARK", description: "memorized feature" },
+  { name: "GLOW", description: "self-illuminating" },
+  { name: "VAULT", description: "part of a vault" },
+  { name: "ROOM", description: "part of a room" },
+  { name: "SEEN", description: "seen flag" },
+  { name: "VIEW", description: "view flag" },
+  { name: "WASSEEN", description: "previously seen (during update)" },
+  { name: "FEEL", description: "hidden points to trigger feelings" },
+  { name: "TRAP", description: "square containing a known trap" },
+  { name: "INVIS", description: "square containing an unknown trap" },
+  { name: "WALL_INNER", description: "inner wall generation flag" },
+  { name: "WALL_OUTER", description: "outer wall generation flag" },
+  { name: "WALL_SOLID", description: "solid wall generation flag" },
+  { name: "MON_RESTRICT", description: "no random monster flag" },
+  { name: "NO_TELEPORT", description: "player can't teleport from this square" },
+  { name: "NO_MAP", description: "square can't be magically mapped" },
+  { name: "NO_ESP", description: "telepathy doesn't work on this square" },
+  { name: "PROJECT", description: "marked for projection processing" },
+  { name: "DTRAP", description: "trap detected square" },
+  { name: "NO_STAIRS", description: "square is not suitable for placing stairs" },
+  { name: "CLOSE_PLAYER", description: "square is seen and in player's light radius or UNLIGHT detection radius" },
+] as const;
+
+/** NAME -> upstream enum value (SQUARE_ prefix upstream). */
+export const SQUARE = {
+  NONE: 0,
+  MARK: 1,
+  GLOW: 2,
+  VAULT: 3,
+  ROOM: 4,
+  SEEN: 5,
+  VIEW: 6,
+  WASSEEN: 7,
+  FEEL: 8,
+  TRAP: 9,
+  INVIS: 10,
+  WALL_INNER: 11,
+  WALL_OUTER: 12,
+  WALL_SOLID: 13,
+  MON_RESTRICT: 14,
+  NO_TELEPORT: 15,
+  NO_MAP: 16,
+  NO_ESP: 17,
+  PROJECT: 18,
+  DTRAP: 19,
+  NO_STAIRS: 20,
+  CLOSE_PLAYER: 21,
+} as const;

package/src/generated/stats.ts

@@ -0,0 +1,22 @@
+// Generated from reference/src/list-stats.h by scripts/codegen-lists.mjs. Do not edit.
+
+/**
+ * Player stats (player.h STAT_ enum; order matches the sustains in list-object-flags.h).
+ */
+
+export const STAT_ENTRIES = [
+  { name: "STR" },
+  { name: "INT" },
+  { name: "WIS" },
+  { name: "DEX" },
+  { name: "CON" },
+] as const;
+
+/** NAME -> upstream enum value (STAT_ prefix upstream). */
+export const STAT = {
+  STR: 0,
+  INT: 1,
+  WIS: 2,
+  DEX: 3,
+  CON: 4,
+} as const;

package/src/generated/terrain-flags.ts

@@ -0,0 +1,76 @@
+// Generated from reference/src/list-terrain-flags.h by scripts/codegen-lists.mjs. Do not edit.
+
+/**
+ * Terrain flags (cave.h TF_ enum).
+ */
+
+export const TERRAIN_FLAG_ENTRIES = [
+  { name: "NONE", description: "" },
+  { name: "LOS", description: "Allows line of sight" },
+  { name: "PROJECT", description: "Allows projections to pass through" },
+  { name: "PASSABLE", description: "Can be passed through by all creatures" },
+  { name: "INTERESTING", description: "Is noticed on looking around" },
+  { name: "PERMANENT", description: "Is permanent" },
+  { name: "EASY", description: "Is easily passed through" },
+  { name: "TRAP", description: "Can hold a trap" },
+  { name: "NO_SCENT", description: "Cannot store scent" },
+  { name: "NO_FLOW", description: "No flow through" },
+  { name: "OBJECT", description: "Can hold objects" },
+  { name: "TORCH", description: "Becomes bright when torch-lit" },
+  { name: "HIDDEN", description: "Can be found by searching" },
+  { name: "GOLD", description: "Contains treasure" },
+  { name: "CLOSABLE", description: "Can be closed" },
+  { name: "FLOOR", description: "Is a clear floor" },
+  { name: "WALL", description: "Is a solid wall" },
+  { name: "ROCK", description: "Is rocky" },
+  { name: "GRANITE", description: "Is a granite rock wall" },
+  { name: "DOOR_ANY", description: "Is any door" },
+  { name: "DOOR_CLOSED", description: "Is a closed door" },
+  { name: "SHOP", description: "Is a shop" },
+  { name: "DOOR_JAMMED", description: "Is a jammed door" },
+  { name: "DOOR_LOCKED", description: "Is a locked door" },
+  { name: "MAGMA", description: "Is a magma seam" },
+  { name: "QUARTZ", description: "Is a quartz seam" },
+  { name: "STAIR", description: "Is a stair" },
+  { name: "UPSTAIR", description: "Is an up staircase" },
+  { name: "DOWNSTAIR", description: "Is a down staircase" },
+  { name: "SMOOTH", description: "Should have smooth boundaries" },
+  { name: "BRIGHT", description: "Is internally lit" },
+  { name: "FIERY", description: "Is fire-based" },
+] as const;
+
+/** NAME -> upstream enum value (TF_ prefix upstream). */
+export const TF = {
+  NONE: 0,
+  LOS: 1,
+  PROJECT: 2,
+  PASSABLE: 3,
+  INTERESTING: 4,
+  PERMANENT: 5,
+  EASY: 6,
+  TRAP: 7,
+  NO_SCENT: 8,
+  NO_FLOW: 9,
+  OBJECT: 10,
+  TORCH: 11,
+  HIDDEN: 12,
+  GOLD: 13,
+  CLOSABLE: 14,
+  FLOOR: 15,
+  WALL: 16,
+  ROCK: 17,
+  GRANITE: 18,
+  DOOR_ANY: 19,
+  DOOR_CLOSED: 20,
+  SHOP: 21,
+  DOOR_JAMMED: 22,
+  DOOR_LOCKED: 23,
+  MAGMA: 24,
+  QUARTZ: 25,
+  STAIR: 26,
+  UPSTAIR: 27,
+  DOWNSTAIR: 28,
+  SMOOTH: 29,
+  BRIGHT: 30,
+  FIERY: 31,
+} as const;

package/src/generated/terrain.ts

@@ -0,0 +1,62 @@
+// Generated from reference/src/list-terrain.h by scripts/codegen-lists.mjs. Do not edit.
+
+/**
+ * Terrain (feature) types (cave.h FEAT_ enum; stored as uint8 upstream).
+ */
+
+export const TERRAIN_ENTRIES = [
+  { name: "NONE" },
+  { name: "FLOOR" },
+  { name: "CLOSED" },
+  { name: "OPEN" },
+  { name: "BROKEN" },
+  { name: "LESS" },
+  { name: "MORE" },
+  { name: "STORE_GENERAL" },
+  { name: "STORE_ARMOR" },
+  { name: "STORE_WEAPON" },
+  { name: "STORE_BOOK" },
+  { name: "STORE_ALCHEMY" },
+  { name: "STORE_MAGIC" },
+  { name: "STORE_BLACK" },
+  { name: "HOME" },
+  { name: "SECRET" },
+  { name: "RUBBLE" },
+  { name: "MAGMA" },
+  { name: "QUARTZ" },
+  { name: "MAGMA_K" },
+  { name: "QUARTZ_K" },
+  { name: "GRANITE" },
+  { name: "PERM" },
+  { name: "LAVA" },
+  { name: "PASS_RUBBLE" },
+] as const;
+
+/** NAME -> upstream enum value (FEAT_ prefix upstream). */
+export const FEAT = {
+  NONE: 0,
+  FLOOR: 1,
+  CLOSED: 2,
+  OPEN: 3,
+  BROKEN: 4,
+  LESS: 5,
+  MORE: 6,
+  STORE_GENERAL: 7,
+  STORE_ARMOR: 8,
+  STORE_WEAPON: 9,
+  STORE_BOOK: 10,
+  STORE_ALCHEMY: 11,
+  STORE_MAGIC: 12,
+  STORE_BLACK: 13,
+  HOME: 14,
+  SECRET: 15,
+  RUBBLE: 16,
+  MAGMA: 17,
+  QUARTZ: 18,
+  MAGMA_K: 19,
+  QUARTZ_K: 20,
+  GRANITE: 21,
+  PERM: 22,
+  LAVA: 23,
+  PASS_RUBBLE: 24,
+} as const;

package/src/generated/trap-flags.ts

@@ -0,0 +1,42 @@
+// Generated from reference/src/list-trap-flags.h by scripts/codegen-lists.mjs. Do not edit.
+
+/**
+ * Trap properties (trap.h TRF_ enum).
+ */
+
+export const TRAP_FLAG_ENTRIES = [
+  { name: "NONE", description: "" },
+  { name: "GLYPH", description: "Is a glyph" },
+  { name: "TRAP", description: "Is a player trap" },
+  { name: "VISIBLE", description: "Is visible" },
+  { name: "INVISIBLE", description: "Is invisible" },
+  { name: "FLOOR", description: "Can be set on a floor" },
+  { name: "DOWN", description: "Takes the player down a level" },
+  { name: "PIT", description: "Moves the player onto the trap" },
+  { name: "ONETIME", description: "Disappears after being activated" },
+  { name: "MAGICAL", description: "Has magical activation (absence of this flag means physical)" },
+  { name: "SAVE_THROW", description: "Allows a save from all effects by standard saving throw" },
+  { name: "SAVE_ARMOR", description: "Allows a save from all effects due to AC" },
+  { name: "LOCK", description: "Is a door lock" },
+  { name: "DELAY", description: "Has a delayed effect" },
+  { name: "WEB", description: "Is a web" },
+] as const;
+
+/** NAME -> upstream enum value (TRF_ prefix upstream). */
+export const TRF = {
+  NONE: 0,
+  GLYPH: 1,
+  TRAP: 2,
+  VISIBLE: 3,
+  INVISIBLE: 4,
+  FLOOR: 5,
+  DOWN: 6,
+  PIT: 7,
+  ONETIME: 8,
+  MAGICAL: 9,
+  SAVE_THROW: 10,
+  SAVE_ARMOR: 11,
+  LOCK: 12,
+  DELAY: 13,
+  WEB: 14,
+} as const;

package/src/generated/tvals.ts

@@ -0,0 +1,84 @@
+// Generated from reference/src/list-tvals.h by scripts/codegen-lists.mjs. Do not edit.
+
+/**
+ * Object base types (obj-properties.h/obj-tval TV_ enum; fields per header comment: code_name, string_name).
+ */
+
+export const TVAL_ENTRIES = [
+  { name: "NULL", textName: "none" },
+  { name: "CHEST", textName: "chest" },
+  { name: "SHOT", textName: "shot" },
+  { name: "ARROW", textName: "arrow" },
+  { name: "BOLT", textName: "bolt" },
+  { name: "BOW", textName: "bow" },
+  { name: "DIGGING", textName: "digger" },
+  { name: "HAFTED", textName: "hafted" },
+  { name: "POLEARM", textName: "polearm" },
+  { name: "SWORD", textName: "sword" },
+  { name: "BOOTS", textName: "boots" },
+  { name: "GLOVES", textName: "gloves" },
+  { name: "HELM", textName: "helm" },
+  { name: "CROWN", textName: "crown" },
+  { name: "SHIELD", textName: "shield" },
+  { name: "CLOAK", textName: "cloak" },
+  { name: "SOFT_ARMOR", textName: "soft armor" },
+  { name: "HARD_ARMOR", textName: "hard armor" },
+  { name: "DRAG_ARMOR", textName: "dragon armor" },
+  { name: "LIGHT", textName: "light" },
+  { name: "AMULET", textName: "amulet" },
+  { name: "RING", textName: "ring" },
+  { name: "STAFF", textName: "staff" },
+  { name: "WAND", textName: "wand" },
+  { name: "ROD", textName: "rod" },
+  { name: "SCROLL", textName: "scroll" },
+  { name: "POTION", textName: "potion" },
+  { name: "FLASK", textName: "flask" },
+  { name: "FOOD", textName: "food" },
+  { name: "MUSHROOM", textName: "mushroom" },
+  { name: "MAGIC_BOOK", textName: "magic book" },
+  { name: "PRAYER_BOOK", textName: "prayer book" },
+  { name: "NATURE_BOOK", textName: "nature book" },
+  { name: "SHADOW_BOOK", textName: "shadow book" },
+  { name: "OTHER_BOOK", textName: "other book" },
+  { name: "GOLD", textName: "gold" },
+] as const;
+
+/** NAME -> upstream enum value (TV_ prefix upstream). */
+export const TV = {
+  NULL: 0,
+  CHEST: 1,
+  SHOT: 2,
+  ARROW: 3,
+  BOLT: 4,
+  BOW: 5,
+  DIGGING: 6,
+  HAFTED: 7,
+  POLEARM: 8,
+  SWORD: 9,
+  BOOTS: 10,
+  GLOVES: 11,
+  HELM: 12,
+  CROWN: 13,
+  SHIELD: 14,
+  CLOAK: 15,
+  SOFT_ARMOR: 16,
+  HARD_ARMOR: 17,
+  DRAG_ARMOR: 18,
+  LIGHT: 19,
+  AMULET: 20,
+  RING: 21,
+  STAFF: 22,
+  WAND: 23,
+  ROD: 24,
+  SCROLL: 25,
+  POTION: 26,
+  FLASK: 27,
+  FOOD: 28,
+  MUSHROOM: 29,
+  MAGIC_BOOK: 30,
+  PRAYER_BOOK: 31,
+  NATURE_BOOK: 32,
+  SHADOW_BOOK: 33,
+  OTHER_BOOK: 34,
+  GOLD: 35,
+} as const;

package/src/generated/ui-entry-renderers.ts

@@ -0,0 +1,24 @@
+// Generated from reference/src/list-ui-entry-renderers.h by scripts/codegen-lists.mjs. Do not edit.
+
+/**
+ * Second character screen renderers (ui-entry-renderers.c struct backend_info).
+ */
+
+export const UI_ENTRY_RENDERER_ENTRIES = [
+  { name: "COMPACT_RESIST_RENDERER_WITH_COMBINED_AUX", defaultCombinerName: "RESIST_0", defaultColors: "wwwwwwGGGrrGGGwGrGwwrwWWWWWWGGGrrGGGWGrGWWrW", defaultLabelColors: "swBrgwBrwBwBr", defaultSymbols: "?..+-*!^.=.%%%~!=%~+=~", defaultNDigit: 0, defaultSign: "NO_SIGN" },
+  { name: "COMPACT_FLAG_RENDERER_WITH_COMBINED_AUX", defaultCombinerName: "LOGICAL_OR", defaultColors: "wwwwGWWWWG", defaultLabelColors: "swBw", defaultSymbols: "?..+!", defaultNDigit: 0, defaultSign: "NO_SIGN" },
+  { name: "COMPACT_FLAG_WITH_CANCEL_RENDERER_WITH_COMBINED_AUX", defaultCombinerName: "LOGICAL_OR_WITH_CANCEL", defaultColors: "wwwwwGwwGGwWWWWWGWWGGW", defaultLabelColors: "swwwwBw", defaultSymbols: "?..+-!+-=.-", defaultNDigit: 0, defaultSign: "NO_SIGN" },
+  { name: "NUMERIC_AS_SIGN_RENDERER_WITH_COMBINED_AUX", defaultCombinerName: "ADD", defaultColors: "wwwGowGowGoWWWGoWGoWGo", defaultLabelColors: "swwwBBBrrr", defaultSymbols: "?....+!+--=", defaultNDigit: 0, defaultSign: "NO_SIGN" },
+  { name: "NUMERIC_RENDERER_WITH_COMBINED_AUX", defaultCombinerName: "ADD", defaultColors: "wwwboBbPrRowwwboBbPrRo", defaultLabelColors: "swwwBBBrrr", defaultSymbols: "?0000+-", defaultNDigit: 1, defaultSign: "NO_SIGN" },
+  { name: "NUMERIC_RENDERER_WITH_BOOL_AUX", defaultCombinerName: "ADD", defaultColors: "wdsgGgrRwdsgGgrR", defaultLabelColors: "wwwwwww", defaultSymbols: "? .s*=", defaultNDigit: 1, defaultSign: "NO_SIGN" },
+] as const;
+
+/** NAME -> upstream enum value (UI_ENTRY_RENDERER_ prefix upstream). */
+export const UI_ENTRY_RENDERER = {
+  COMPACT_RESIST_RENDERER_WITH_COMBINED_AUX: 0,
+  COMPACT_FLAG_RENDERER_WITH_COMBINED_AUX: 1,
+  COMPACT_FLAG_WITH_CANCEL_RENDERER_WITH_COMBINED_AUX: 2,
+  NUMERIC_AS_SIGN_RENDERER_WITH_COMBINED_AUX: 3,
+  NUMERIC_RENDERER_WITH_COMBINED_AUX: 4,
+  NUMERIC_RENDERER_WITH_BOOL_AUX: 5,
+} as const;

package/src/guard.ts

@@ -0,0 +1,70 @@
+/**
+ * Overflow-guarded integer arithmetic, ported from reference/src/z-util.c
+ * (Angband 4.2.6): add_guardi/sub_guardi coerce to the 32-bit int range and
+ * add_guardi16/sub_guardi16 to the signed 16-bit range when the exact result
+ * would overflow.
+ *
+ * The object power/pricing engine and the curse-attribute merge rely on these
+ * saturating semantics (a curse can push a bonus to the INT16 rail, and the
+ * curse-power delta arithmetic saturates at INT32), so the port reproduces the
+ * clamping exactly rather than letting JS doubles run unbounded.
+ */
+
+/** INT_MAX (32-bit signed). */
+export const INT_MAX = 2147483647;
+/** INT_MIN (32-bit signed). */
+export const INT_MIN = -2147483648;
+/** INT16_MAX. */
+export const INT16_MAX = 32767;
+/** INT16_MIN. */
+export const INT16_MIN = -32768;
+/** UINT32_MAX: the saturating ceiling for chunk->obj_rating / mon_rating. */
+export const UINT32_MAX = 4294967295;
+
+/**
+ * my_stristr (z-util.c:441): a case-insensitive substring search, returning
+ * whether `pattern` occurs anywhere in `string`. The C compares `toupper` per
+ * character; case-folding both sides is the same test for the ASCII data the
+ * gamedata files carry.
+ *
+ * Given a real counterpart rather than inlined a third time: it was already
+ * inlined at mon/bind.ts (raceByName's substring fallback) and MISSING at
+ * world/trap.ts's lookupTrap, which used a case-SENSITIVE `includes` where
+ * trap.c:57 uses my_stristr. Latent there only because every shipped trap desc
+ * and every call-site literal happens to be lower case today.
+ */
+export function myStristr(string: string, pattern: string): boolean {
+  return string.toLowerCase().includes(pattern.toLowerCase());
+}
+
+/** add_guardi: a + b coerced into [INT_MIN, INT_MAX] on overflow. */
+export function addGuardi(a: number, b: number): number {
+  if (a < 0) {
+    return b >= 0 || (b > INT_MIN && a >= INT_MIN - b) ? a + b : INT_MIN;
+  }
+  return b <= 0 || a <= INT_MAX - b ? a + b : INT_MAX;
+}
+
+/** sub_guardi: a - b coerced into [INT_MIN, INT_MAX] on overflow. */
+export function subGuardi(a: number, b: number): number {
+  if (a < 0) {
+    return b <= 0 || a >= INT_MIN + b ? a - b : INT_MIN;
+  }
+  return b >= 0 || a <= INT_MAX + b ? a - b : INT_MAX;
+}
+
+/** add_guardi16: a + b coerced into [-32768, 32767] on overflow. */
+export function addGuardi16(a: number, b: number): number {
+  if (a < 0) {
+    return b >= 0 || (b > INT16_MIN && a >= INT16_MIN - b) ? a + b : INT16_MIN;
+  }
+  return b <= 0 || a <= INT16_MAX - b ? a + b : INT16_MAX;
+}
+
+/** sub_guardi16: a - b coerced into [-32768, 32767] on overflow. */
+export function subGuardi16(a: number, b: number): number {
+  if (a < 0) {
+    return b <= 0 || a >= INT16_MIN + b ? a - b : INT16_MIN;
+  }
+  return b >= 0 || a <= INT16_MAX + b ? a - b : INT16_MAX;
+}