@rpgm-tools/neo-angband-core 0.10.0

package/dist/gen/room.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Room builders and the runtime-registrable room-builder registry, ported
+ * from reference/src/gen-room.c (Angband 4.2.6).
+ *
+ * MODDABILITY (ratified pillar, decision 13): builders live in a string-keyed
+ * RoomRegistry. createRoomRegistry() populates it with the upstream builders;
+ * a mod can register a new builder under any key and reference it from a
+ * (modded) dungeon profile's room list. There is no closed switch.
+ *
+ * PORTED (faithful geometry and RNG order for the structural work): staircase
+ * (persistent-only), simple, circular, overlap, crossed, large, template
+ * (build_room_template from room_template.json), vault (build_vault from
+ * vault.json) and the vault-type wrappers (lesser/medium/greater and their
+ * "(new)" variants, interesting).
+ *
+ * SIMPLIFIED (ledgered in parity/ledger/gen-rooms.yaml): nest and pit build the
+ * faithful room shell but fill with any depth-appropriate monster instead of a
+ * themed pit profile; vault racial glyphs likewise place any depth-appropriate
+ * monster rather than a base-symbol-restricted one.
+ *
+ * PORTED (starburst + cellular builders): moria (build_moria), room_of_chambers
+ * (build_room_of_chambers, with make_chamber/hollow_out_room carving and the
+ * get_chamber_monsters themed fill) and huge (build_huge). Faithful RNG order.
+ */
+import type { Loc } from "../loc.js";
+import type { Rng } from "../rng.js";
+import type { Gen } from "./util.js";
+/** room_template.json record. */
+export interface RoomTemplateRecordJson {
+    name: string;
+    type: number;
+    rating: number;
+    rows: number;
+    columns: number;
+    doors: number;
+    tval: string;
+    D: string[];
+    flags?: string[];
+}
+/** vault.json record. */
+export interface VaultRecordJson {
+    name: string;
+    type: string;
+    rating: number;
+    rows: number;
+    columns: number;
+    "min-depth"?: number;
+    "max-depth"?: number;
+    D: string[];
+    flags?: string[];
+}
+export interface RoomTemplate {
+    name: string;
+    typ: number;
+    rat: number;
+    hgt: number;
+    wid: number;
+    dor: number;
+    tval: number;
+    rows: string[];
+    fewEntrances: boolean;
+}
+export interface Vault {
+    name: string;
+    typ: string;
+    rat: number;
+    hgt: number;
+    wid: number;
+    minLev: number;
+    maxLev: number;
+    rows: string[];
+    fewEntrances: boolean;
+}
+/** Load room templates from parsed room_template.json records. */
+export declare function loadRoomTemplates(records: RoomTemplateRecordJson[]): RoomTemplate[];
+/**
+ * Load vaults from parsed vault.json records - the port's init_parse_vault
+ * (generate.c L595): name/type/rating/rows/columns/min-depth/max-depth/flags/D.
+ * The C parser's error paths (PARSE_ERROR_VAULT_TOO_BIG against
+ * room_builders[i].max_height/max_width, PARSE_ERROR_NO_ROOM_FOUND,
+ * PARSE_ERROR_VAULT_DESC_WRONG_LENGTH) are validation of the raw text file and
+ * live in the content-pack build, not here. `maxDepth` is z_info->max_depth
+ * (constants world:max-depth): a vault max-depth of 0 means "no maximum", so it
+ * defaults to maxDepth exactly like parse_vault_max_depth (generate.c L562).
+ * Without this, randomVault's `maxLev >= depth` filter hides every 0-max vault
+ * (128 of 161) from the dungeon.
+ */
+export declare function loadVaults(records: VaultRecordJson[], maxDepth: number): Vault[];
+/** The template/vault data a room registry closes over. */
+export interface RoomData {
+    templates: RoomTemplate[];
+    vaults: Vault[];
+}
+/** symmetry_transform: rotate (clockwise), reflect, then translate. */
+export declare function symmetryTransform(grid: Loc, y0: number, x0: number, height: number, width: number, rotate: number, reflect: boolean): Loc;
+export interface SymmetryResult {
+    rotate: number;
+    reflect: boolean;
+    theight: number;
+    twidth: number;
+}
+/** get_random_symmetry_transform. */
+export declare function getRandomSymmetryTransform(g: Gen, height: number, width: number, flags: number, transposeWeightIn: number): SymmetryResult;
+/** calc_default_transpose_weight. */
+export declare function calcDefaultTransposeWeight(height: number, width: number): number;
+export declare function buildRoomTemplate(g: Gen, centreIn: Loc, ymax: number, xmax: number, doors: number, rows: string[], tval: number, fewEntrances: boolean): boolean;
+/** build_vault: draw a vault from its grid text. */
+export declare function buildVault(g: Gen, centreIn: Loc, v: Vault): boolean;
+/**
+ * vault_chunk (gen-cave.c L3212): build a fresh chunk that consists only of a
+ * greater vault, filled around with granite. Picks a greater-vault type at the
+ * given depth (one_in_(2) chooses the "(new)" variant), sizes a sub-chunk to
+ * the vault, and builds the vault into it via build_vault. NEW exported helper.
+ *
+ * `makeSubGen(height, width, depth)` mints a Gen bound to a fresh sub-chunk of
+ * that size (supplied by the caller so Gen/Chunk construction stays in cave.ts
+ * and there is no circular import). The vault's name/type draws happen on the
+ * shared `rng` before the sub-chunk exists, so RNG order is preserved.
+ *
+ * Returns the built sub-chunk's Gen, or null on failure (no greater vault at
+ * depth, or build_vault failed). Faithful to the C control flow (return failure
+ * on either path); the C-side uncreate_artifacts/cave_free cleanup is not
+ * needed because the caller simply discards this sub-chunk on failure.
+ */
+export declare function vaultChunk(rng: Rng, vaults: Vault[], depth: number, makeSubGen: (height: number, width: number, depth: number) => Gen): Gen | null;
+/** A room entry in a dungeon profile's room list. */
+export interface RoomProfile {
+    name: string;
+    /** Registry key resolved from list-rooms.h. */
+    builder: string;
+    rating: number;
+    height: number;
+    width: number;
+    level: number;
+    pit: boolean;
+    rarity: number;
+    cutoff: number;
+}
+export type RoomBuilder = (g: Gen, centre: Loc, rating: number) => boolean;
+/** The runtime-registrable, string-keyed room builder registry. */
+export declare class RoomRegistry {
+    private readonly data;
+    private readonly map;
+    constructor(data: RoomData);
+    /** The loaded vault list (used by hard_centre's vault_chunk). */
+    get vaults(): Vault[];
+    register(name: string, builder: RoomBuilder): void;
+    get(name: string): RoomBuilder;
+    has(name: string): boolean;
+    names(): string[];
+}
+/** Create a registry populated with the upstream builders bound to data. */
+export declare function createRoomRegistry(data: RoomData): RoomRegistry;
+/**
+ * room_build: attempt to build a room of the given profile at a block, or (if
+ * findsOwnSpace) let the builder find its own space. The builder is resolved
+ * from the string-keyed registry, so modded builders dispatch identically.
+ */
+export declare function roomBuild(g: Gen, by0: number, bx0: number, profile: RoomProfile, findsOwnSpace: boolean, registry: RoomRegistry): boolean;
+//# sourceMappingURL=room.d.ts.map

package/dist/gen/room.d.ts.map

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