@rpgm-tools/neo-angband-core 0.10.0

package/dist/game/equip-cmp.js

@@ -0,0 +1,363 @@
+/**
+ * The equipment-comparison grid's data model, ported from
+ * reference/src/ui-equip-cmp.c (initialize_summary, filter_items,
+ * sort_items, compute_player_and_equipment_values, set_short_name).
+ *
+ * Upstream builds one big screen: property columns (resistances / abilities
+ * / hindrances / modifiers / stat_modifiers, each scoped to category
+ * "EQUIPCMP_SCREEN") across every wearable item the player has seen - worn,
+ * carried, on the floor underfoot, at home, or in the (non-home) stores -
+ * plus a combined "@" row showing what the player + current equipment adds
+ * up to. This module reuses the same ui-entry compute/render backend the
+ * character screen uses (game/ui-entry.ts); it does not re-derive any
+ * combat/resist arithmetic.
+ *
+ * Deliberately simplified vs. the C, per the port's shell-adaptation plan:
+ *  - The intricate terminal-width-driven 2/3-"view" column repartition
+ *    (reconfigure_for_term_if_necessary) is reduced to a fixed 2-view split
+ *    (all categories, then stat_modifiers alone) plus an optional 3-view
+ *    split that also breaks out "modifiers" - correct data, simpler paging,
+ *    as the port's shell-adaptation notes explicitly allow.
+ *  - The dump-to-file command (d) writes a text file and rides the port's
+ *    host-io layer with the other dumps.
+ *
+ * The quick attribute filter (q / !, prompt_for_easy_filter) IS here:
+ * matchEquipCmpFilter does its label lookup and equipCmpFilterKeeps its six
+ * selector functions, applied through EquipCmpOptions.filter. It was called a
+ * "UI convenience" and skipped, which was wrong - it is a default part of the
+ * screen on every platform. The source-cycle (c), reverse (r), and reset (R)
+ * behaviours are faithful.
+ *
+ * No RNG: every value here is a deterministic function of already-computed
+ * object/player state (curses, runes, equipment) - this is a pure display
+ * model, like the rest of the ui-entry backend it is built on.
+ */
+import { gearGet } from "./gear.js";
+import { floorPile } from "./floor.js";
+import { wieldSlot } from "./gear.js";
+import { ignoreLevelOf, IGNORE } from "../obj/ignore.js";
+import { objectFullyKnown, objectKnownShadow } from "../obj/known-object.js";
+import { tvalIsWearable } from "../obj/object.js";
+import { describeObject, knownDescOf } from "./describe.js";
+import { ODESC } from "../obj/desc.js";
+import { colorCharToAttr } from "../color.js";
+import { FEAT } from "../generated/index.js";
+import { buildUiEntryConfig, equipCmpCategories, equipCmpColumnLabel, equipCmpFilterLabel3, combineEntryValues, computeObjectValues, computePlayerValues, applyRenderer, resolveUiDeps, isUiEntryForKnownRune, } from "./ui-entry.js";
+import { playerFlags } from "../player/calcs.js";
+const SOURCE_ORDER = ["worn", "pack", "floor", "home", "store"];
+const QUALITY_ORDER = ["artifact", "ego", "good", "average", "bad"];
+/** cycle_sources (ui-equip-cmp.c L687-758): NO_STORE -> ONLY_STORE -> YES_STORE -> ONLY_CARRIED -> NO_STORE. */
+export function cycleStoreInclusion(cur) {
+    switch (cur) {
+        case "no-store":
+            return "only-store";
+        case "only-store":
+            return "yes-store";
+        case "yes-store":
+            return "only-carried";
+        default:
+            return "no-store";
+    }
+}
+/** get_string's prompt for the quick filter (ui-equip-cmp.c:1237). */
+export const EQUIP_CMP_FILTER_PROMPT = "Enter 2 or 3 (for stat) character code and return or return to clear ";
+/** The failure message, shown in the dialogue line (ui-equip-cmp.c:1231). */
+export const EQUIP_CMP_FILTER_NO_MATCH = "Did not find attribute with that name; filter unchanged";
+/**
+ * The four capitalisation attempts prompt_for_easy_filter makes before giving up
+ * (ui-equip-cmp.c:1273-1330), in order. A 3-character code only gets the first
+ * three: the fourth attempt writes a 2-character string, and the loop's
+ * `threec && itry >= 3` guard stops before it.
+ */
+function filterCodeAttempts(code) {
+    const up = (s) => s.toUpperCase();
+    const lo = (s) => s.toLowerCase();
+    const head = code.slice(0, 1);
+    const tail = code.slice(1);
+    const attempts = [
+        up(head) + lo(tail),
+        up(head) + up(tail),
+        lo(head) + lo(tail),
+    ];
+    /* itry 3 only ever produces two characters (ctry[2] = '\0'). */
+    if (code.length <= 2)
+        attempts.push(lo(head) + up(tail));
+    return attempts;
+}
+/**
+ * prompt_for_easy_filter's label lookup (ui-equip-cmp.c:1258-1360): find the
+ * property column whose label matches the typed code under any of upstream's
+ * capitalisation attempts. A 3-character code is matched against the 3-char
+ * label (all three characters, pad included); anything else against the first
+ * two characters of the 2-char column header, which is how a 1-character code
+ * fails to match anything.
+ *
+ * Returns null for upstream's "Did not find attribute with that name".
+ */
+export function matchEquipCmpFilter(columns, code, not) {
+    const threec = code.length >= 3;
+    const typed = code.slice(0, 3);
+    for (const attempt of filterCodeAttempts(typed)) {
+        for (let i = 0; i < columns.length; i++) {
+            const col = columns[i];
+            const label = threec ? col.label3 : col.label;
+            const hit = threec
+                ? label.slice(0, 3) === attempt.slice(0, 3)
+                : label.slice(0, 2) === attempt.slice(0, 2);
+            if (hit)
+                return { column: i, not };
+        }
+    }
+    return null;
+}
+/**
+ * The selector prompt_for_easy_filter installs, chosen by the property's
+ * category (its `switch (j)`, ui-equip-cmp.c:1372-1425) and applied to the raw
+ * value (the six sel_* functions, L1643-1682):
+ *
+ * - resistances:    val >= 1        (sel_at_least_resists)
+ * - abilities:      val != 0        (sel_has_flag - a flag where on is wanted)
+ * - hindrances:     val == 0        (sel_does_not_have_flag - INVERTED, because
+ *                                   for a hindrance the desirable state is off)
+ * - modifiers,
+ *   stat_modifiers: val > 0         (sel_has_pos_mod)
+ *
+ * `not` swaps each for its complement.
+ */
+export function equipCmpFilterKeeps(columns, filter, vals) {
+    const col = columns[filter.column];
+    if (!col)
+        return true;
+    const val = vals[filter.column] ?? 0;
+    let keep;
+    switch (col.category) {
+        case "resistances":
+            keep = val >= 1;
+            break;
+        case "abilities":
+            keep = val !== 0;
+            break;
+        case "hindrances":
+            keep = val === 0;
+            break;
+        default:
+            keep = val > 0;
+            break;
+    }
+    return filter.not ? !keep : keep;
+}
+let cachedConfig = null;
+let cachedConfigKey = null;
+/** Memoise buildUiEntryConfig per pack (it is pure and pack-shaped, not per-call). */
+function uiEntryConfigFor(packs) {
+    if (cachedConfig && cachedConfigKey === packs)
+        return cachedConfig;
+    cachedConfig = buildUiEntryConfig(packs);
+    cachedConfigKey = packs;
+    return cachedConfig;
+}
+/** set_short_name (ui-equip-cmp.c L1601), truncated to 20 chars (nshortnm cap). */
+function shortName(state, obj) {
+    const cap = 20;
+    if (obj.artifact) {
+        const n = obj.artifact.name;
+        return n.length <= cap ? n : n.slice(n.length - cap);
+    }
+    if (obj.ego) {
+        const n = obj.ego.name;
+        return n.length <= cap ? n : n.slice(n.length - cap);
+    }
+    const n = describeObject(state, obj, ODESC.COMBAT | ODESC.SINGULAR | ODESC.TERSE);
+    return n.length <= cap ? n : n.slice(0, cap);
+}
+/** equippable_quality (add_obj_to_summary L2080-2104). */
+function quality(obj) {
+    switch (ignoreLevelOf(obj)) {
+        case IGNORE.GOOD:
+            return "good";
+        case IGNORE.AVERAGE:
+            return "average";
+        case IGNORE.BAD:
+            return "bad";
+        default:
+            if (obj.artifact)
+                return "artifact";
+            if (obj.ego)
+                return "ego";
+            return "average";
+    }
+}
+/** initialize_summary's five visitors (L2386 body): worn / pack / floor / home / store. */
+function gatherItems(state) {
+    const out = [];
+    const player = state.actor.player;
+    // WORN: apply_visitor_to_equipped (select_any).
+    for (let i = 0; i < player.body.count; i++) {
+        const handle = player.equipment[i] ?? 0;
+        const obj = handle ? gearGet(state.gear, handle) : null;
+        if (obj)
+            out.push({ obj, src: "worn" });
+    }
+    // PACK: select_nonequipped_wearable over p->gear (the pack list already
+    // excludes equipped handles - see game/gear.ts Gear.pack).
+    for (const handle of state.gear.pack) {
+        const obj = gearGet(state.gear, handle);
+        if (obj && tvalIsWearable(obj.tval))
+            out.push({ obj, src: "pack" });
+    }
+    // FLOOR: select_seen_wearable over square_object(cave, player->grid).
+    for (const obj of floorPile(state, state.actor.grid)) {
+        if (tvalIsWearable(obj.tval))
+            out.push({ obj, src: "floor" });
+    }
+    // HOME / STORE: guarded - the web shell may have no live stores/home stock.
+    for (const store of state.stores ?? []) {
+        const src = store.feat === FEAT.HOME ? "home" : "store";
+        for (const obj of store.stock) {
+            if (tvalIsWearable(obj.tval))
+                out.push({ obj, src });
+        }
+    }
+    return out;
+}
+/** sel_exclude_src / sel_only_src (L1701-1712) for the easy_filt source cycle. */
+function passesSourceFilter(src, mode) {
+    switch (mode) {
+        case "no-store":
+            return src !== "store";
+        case "only-store":
+            return src === "store";
+        case "yes-store":
+            return true;
+        case "only-carried":
+            return src === "worn" || src === "pack";
+    }
+}
+const SRC_RANK = {
+    worn: 0,
+    pack: 1,
+    floor: 2,
+    home: 3,
+    store: 4,
+};
+const QUAL_RANK = {
+    artifact: 0,
+    ego: 1,
+    good: 2,
+    average: 3,
+    bad: 4,
+};
+/** cmp_by_slot -> cmp_by_location -> cmp_by_quality -> cmp_by_short_name (L1900-1919, default_sort). */
+function compareItems(a, b) {
+    if (a.slot !== b.slot)
+        return a.slot - b.slot;
+    const sa = SRC_RANK[a.src];
+    const sb = SRC_RANK[b.src];
+    if (sa !== sb)
+        return sa - sb;
+    const qa = QUAL_RANK[a.quality];
+    const qb = QUAL_RANK[b.quality];
+    if (qa !== qb)
+        return qa - qb;
+    return a.shortName < b.shortName ? -1 : a.shortName > b.shortName ? 1 : 0;
+}
+/**
+ * equipCmpSummary: the equip-cmp grid model - columns (with faithful 2-char
+ * labels), the "@" combined row, and the filtered/sorted item rows. Reuses
+ * computeObjectValues / computePlayerValues / combineEntryValues / applyRenderer
+ * (ui-entry.ts) so no combat/resist value is re-derived here.
+ */
+export function equipCmpSummary(state, packs, opts = {}) {
+    const config = uiEntryConfigFor(packs);
+    const player = state.actor.player;
+    const source = opts.source ?? "no-store";
+    const rd = resolveUiDeps(player, opts.entryDeps ?? {});
+    const untimedCache = { untimed: playerFlags(player) };
+    const cats = equipCmpCategories(config);
+    const columns = [];
+    for (const cat of cats) {
+        for (const entry of cat.entries) {
+            columns.push({
+                key: entry.name,
+                label: equipCmpColumnLabel(entry),
+                label3: equipCmpFilterLabel3(entry),
+                category: cat.key,
+            });
+        }
+    }
+    const flatEntries = cats.flatMap((c) => c.entries);
+    // Equipped objects (for the "@" combined row): compute_player_and_equipment_values.
+    const equipped = [];
+    for (let i = 0; i < player.body.count; i++) {
+        const handle = player.equipment[i] ?? 0;
+        const obj = handle ? gearGet(state.gear, handle) : null;
+        if (obj)
+            equipped.push(obj);
+    }
+    /* obj->known, synthesised once per object: object_flag_is_known and
+     * object_element_is_known both take object_fully_known as their first route
+     * out (obj-knowledge.c:777, 799), and mundane gear carries no runes at all, so
+     * it IS fully known and must print '.' down every column. Reading p->obj_k
+     * alone printed '?' for a plain torch or soft leather armour - the same defect
+     * the character sheet's resist grid had (its fix is ui-entry.ts:1857), which
+     * this screen never got. */
+    const knownDesc = knownDescOf(state);
+    const fullyKnown = (obj) => objectFullyKnown(obj, objectKnownShadow(obj, player, state.runeEnv, knownDesc), player, state.runeEnv);
+    const combinedCells = flatEntries.map((entry) => {
+        const playerVal = computePlayerValues(entry, player, rd, untimedCache);
+        const vals = [playerVal.val];
+        const auxs = [playerVal.auxval];
+        for (const obj of equipped) {
+            const ov = computeObjectValues(entry, obj, player, fullyKnown(obj));
+            vals.push(ov.val);
+            auxs.push(ov.auxval);
+        }
+        const { accum, accumAux } = combineEntryValues(entry, vals, auxs);
+        const renderer = config.renderers[entry.rendererIndex - 1];
+        if (!renderer)
+            return { symbol: " ", color: 1 };
+        const rendered = applyRenderer(renderer, [accum], [accumAux], {
+            knownRune: isUiEntryForKnownRune(entry, player),
+            alternateColorFirst: false,
+        });
+        return rendered.cells[0] ?? { symbol: " ", color: 1 };
+    });
+    const gathered = gatherItems(state).filter((g) => passesSourceFilter(g.src, source));
+    let items = gathered.map(({ obj, src }) => {
+        const vals = [];
+        const known = fullyKnown(obj);
+        const cells = flatEntries.map((entry) => {
+            const ov = computeObjectValues(entry, obj, player, known);
+            vals.push(ov.val);
+            const renderer = config.renderers[entry.rendererIndex - 1];
+            if (!renderer)
+                return { symbol: " ", color: 1 };
+            const rendered = applyRenderer(renderer, [ov.val], [ov.auxval], {
+                knownRune: isUiEntryForKnownRune(entry, player),
+                alternateColorFirst: false,
+            });
+            return rendered.cells[0] ?? { symbol: " ", color: 1 };
+        });
+        return {
+            obj,
+            vals,
+            shortName: shortName(state, obj),
+            src,
+            quality: quality(obj),
+            slot: wieldSlot(player.body, obj.tval, player.equipment),
+            equippyCh: obj.kind.dChar,
+            equippyAttr: colorCharToAttr(obj.kind.dAttr),
+            cells,
+        };
+    });
+    /* filter_items then sort_items (prompt_for_easy_filter L1428-1429): the quick
+     * filter narrows the gathered set before the ordering is applied. */
+    const filter = opts.filter ?? null;
+    if (filter)
+        items = items.filter((it) => equipCmpFilterKeeps(columns, filter, it.vals));
+    items = items.sort(compareItems);
+    if (opts.reverse)
+        items = items.slice().reverse();
+    return { columns, combinedCells, items, stores: source };
+}
+//# sourceMappingURL=equip-cmp.js.map

package/dist/game/equip-cmp.js.map

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

package/dist/game/floor.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Floor object piles, ported from reference/src/obj-pile.c (Angband 4.2.6):
+ * the live-cave half that lets squares carry objects - floor_carry,
+ * drop_near (with drop_find_grid's scored placement scan and the artifact
+ * rescue walk), floor_object_for_use, and the pile primitives. Piles live on
+ * the GameState (state.floor, keyed by grid index) with the newest object at
+ * the head, exactly as upstream's square->obj linked list (pile_insert
+ * prepends).
+ *
+ * Unported-subsystem seams are grouped on FloorEnv with inert defaults:
+ * - isIgnored (ignore_item_ok, obj-ignore.c, task #24): nothing is ignored,
+ *   so the oldest-ignored eviction never fires and *note stays truthful.
+ * - isTrap (square_istrap, task #21): no traps, so drops may land anywhere
+ *   a floor grid allows.
+ * - birthStacking (OPT birth_stacking): defaults true as shipped.
+ * - onBreak / onDrop / onNote: message and redraw hooks (UI layer).
+ *
+ * DEFERRED with their subsystems (ledgered in parity/ledger/game-floor.yaml):
+ * push_object (needs doors/traps interplay), the known-object shadow cave
+ * (player->cave, knowledge #24), list_object/delist_object oidx bookkeeping
+ * (the pile map is the object list), and mimicked-object handling.
+ */
+import type { Loc } from "../loc.js";
+import type { GameObject, StackLimits } from "../obj/object.js";
+import type { GameState } from "./context.js";
+/** Unported-subsystem hooks for the floor routines; every slot is optional. */
+export interface FloorEnv {
+    /** ignore_item_ok (obj-ignore.c, #24). Default: nothing is ignored. */
+    isIgnored?: (obj: GameObject) => boolean;
+    /** square_istrap (trap.c, #21). Default: no traps. */
+    isTrap?: (grid: Loc) => boolean;
+    /** OPT(player, birth_stacking). Default true (shipped default). */
+    birthStacking?: boolean;
+    /** The dropped object broke / disappeared (message hook). */
+    onBreak?: (obj: GameObject, broke: boolean) => void;
+    /** An object landed on the floor (message / redraw hook). */
+    onDrop?: (obj: GameObject, grid: Loc) => void;
+    /** Quiver stacking limits; floor stacks never read them (shipped values). */
+    limits?: StackLimits;
+}
+/** square_object(c, grid): the pile at a grid, head (newest) first. */
+export declare function floorPile(state: GameState, grid: Loc): readonly GameObject[];
+/**
+ * pile_contains (obj-pile.c L268). The pile is an array here, so the walk down
+ * obj->next is indexOf; kept as a named function so the intent (and the C
+ * symbol) is visible where the pile identity check matters.
+ */
+export declare function pileContains(pile: readonly GameObject[], obj: GameObject): boolean;
+/**
+ * square_holds_object (cave-square.c L1015): whether this exact object is in
+ * the pile at `grid`. Identity, not equality - it answers "is this the object I
+ * am holding a reference to, still here".
+ */
+export declare function squareHoldsObject(state: GameState, grid: Loc, obj: GameObject): boolean;
+/**
+ * item_is_available (obj-pile.c L1427): the object is somewhere the player can
+ * act on it - carried, or in the pile underfoot. Upstream's do_cmd_fire uses it
+ * to reject a command whose ammo is no longer there (player-attack.c:1338), the
+ * case where two fire commands were queued for the same stack.
+ */
+export declare function itemIsAvailable(state: GameState, obj: GameObject): boolean;
+/**
+ * pile_last_item (obj-pile.c L248): the tail of a pile, or null when empty.
+ * Upstream's two consumers (gear_last_item -> combine_pack, obj-ignore.c
+ * ignore_drop) both use it to walk gear BACKWARDS; here that is a reversed
+ * array walk (game/gear.ts combinePack, game/ignore-cmd.ts).
+ */
+export declare function pileLastItem(pile: readonly GameObject[]): GameObject | null;
+/** object_floor_t (obj-pile.h L43): scan_floor's mode bits. */
+export declare const OFLOOR: {
+    readonly NONE: 0;
+    /** Verify the item tester. */
+    readonly TEST: 1;
+    /** Sensed or known items only. */
+    readonly SENSE: 2;
+    /** Only the top item. */
+    readonly TOP: 4;
+    /** Visible items only. */
+    readonly VISIBLE: 8;
+};
+/** get_item mode bits (game-input.h L28-40), the subset scan_items reads. */
+export declare const USE_MODE: {
+    readonly EQUIP: 1;
+    readonly INVEN: 2;
+    readonly FLOOR: 4;
+    readonly QUIVER: 8;
+};
+/** item_tester: null accepts everything (object_test, obj-util.c). */
+export type ItemTester = ((obj: GameObject) => boolean) | null;
+/**
+ * scan_floor (obj-pile.c L1295): the objects at the player's grid that pass
+ * `mode`, newest first, capped at maxSize.
+ *
+ * OFLOOR_SENSE (`!obj->known`) has no counterpart: this port has no per-object
+ * known twin (see the module header), so nothing is dropped for being unsensed.
+ * OFLOOR_VISIBLE is `!is_unknown(obj) && ignore_item_ok(p, obj) -> skip`; with
+ * no unknown_item_kind marker, is_unknown is always false and the term reduces
+ * to the ignore check, which rides env.isIgnored.
+ */
+export declare function scanFloor(state: GameState, maxSize: number, mode: number, tester: ItemTester, env?: FloorEnv): GameObject[];
+/**
+ * scan_items (obj-pile.c L1376): the "valid" objects a get_item picker over
+ * `mode` may offer, in upstream's source order - inventory, then equipment,
+ * then quiver, then the floor. ORDER IS BEHAVIOUR: it decides which letter each
+ * item gets. The floor pass is scan_floor with
+ * OFLOOR_TEST | OFLOOR_SENSE | OFLOOR_VISIBLE (L1411).
+ *
+ * Upstream stops at item_max across ALL passes; that cap is kept.
+ *
+ * The inventory pass walks p->upkeep->inven[], which calc_inventory fills
+ * DISJOINTLY from p->upkeep->quiver[] (player-calcs.c L1023: each non-equipped
+ * gear item is assigned to exactly one of the two). This port's gear.pack is
+ * the raw gear list and keeps quiver members, so the inven pass excludes them
+ * with objectIsInQuiver - otherwise USE_INVEN | USE_QUIVER would list a quivered
+ * stack twice and shift every later letter.
+ */
+export declare function scanItems(state: GameState, itemMax: number, mode: number, tester: ItemTester, env?: FloorEnv): GameObject[];
+/**
+ * square_excise_object / pile_excise: remove an object from the pile at a
+ * grid. Returns whether it was found.
+ *
+ * square_set_obj (cave-square.c:1291) has no counterpart: upstream stores a
+ * `square->obj` linked-list HEAD, and its only two calls both set it to NULL
+ * (cave-square.c:1035 inside square_excise_pile, obj-pile.c:1201 inside
+ * push_object). Here the pile IS the Map entry, so emptying it is the delete
+ * below - and square_excise_pile (cave-square.c:1031) is the caller-side loop
+ * `for (obj of [...floorPile(...)]) floorExcise(...)`.
+ */
+export declare function floorExcise(state: GameState, grid: Loc, obj: GameObject): boolean;
+/**
+ * floor_carry: let the floor at a grid carry an object - merge into a
+ * compatible stack, or add to the pile if it has room (evicting the oldest
+ * ignored object when full). Returns false when the square can't take it;
+ * the caller deals with the object.
+ */
+export declare function floorCarry(state: GameState, grid: Loc, drop: GameObject, env?: FloorEnv, 
+/**
+ * floor_carry's `bool *note` (obj-pile.c:906), an in/out box: cleared when the
+ * drop merged into a pile the player IGNORES, so drop_near knows the landing
+ * is not worth mentioning (:927-930). Omit it when the caller does not care.
+ */
+note?: {
+    value: boolean;
+}): boolean;
+/**
+ * drop_find_grid: find a grid near the given one for an object to fall on -
+ * the scored 7x7 scan (close and uncluttered wins, ties break one_in_2),
+ * then the artifact rescue walk when nothing scores. Returns the grid to
+ * drop at (the input grid when no better one is found).
+ */
+export declare function dropFindGrid(state: GameState, drop: GameObject, preferPile: boolean, start: Loc, env?: FloorEnv): Loc;
+/** square_canputitem: floor that holds objects, no trap, no pile yet. */
+export declare function squareCanPutItem(state: GameState, grid: Loc, env?: FloorEnv): boolean;
+/**
+ * drop_near: let an object fall to the ground at or near a location.
+ * `chance` is the percentage chance the item disappears instead (breakage
+ * on a thrown object); artifacts never break. Returns the grid the object
+ * landed on, or null when it broke or the floor failed to carry it.
+ */
+export declare function dropNear(state: GameState, drop: GameObject, chance: number, grid: Loc, 
+/**
+ * drop_near's `verbose` (obj-pile.c:1129), in its upstream position. When set
+ * and the object is not ignored, a landing on the PLAYER'S OWN grid announces
+ * "You feel something roll beneath your feet." (:1152-1154).
+ *
+ * The port used to have no such parameter, and `preferPile` sat in this slot -
+ * so several call sites were passing the C's verbose argument as preferPile.
+ * That is not cosmetic: prefer_pile drops drop_find_grid's penalty for mixing
+ * item types in one square, so the wrong value lands objects on different
+ * grids from upstream.
+ */
+verbose: boolean, preferPile: boolean, env?: FloorEnv): Loc | null;
+/**
+ * floor_object_for_use: detach `num` items from a floor stack for use -
+ * split off a part, or excise the whole object when it is all taken.
+ * Returns the detached object and whether none is left on the floor.
+ */
+export declare function floorObjectForUse(state: GameState, obj: GameObject, num: number): {
+    usable: GameObject;
+    noneLeft: boolean;
+};
+//# sourceMappingURL=floor.d.ts.map

package/dist/game/floor.d.ts.map

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