BlueGit

timfa questward

Files

questward / shared / world / doors.js

doors.js

doors.js 3.5 KiB Download Raw
1import { WoodTier, WOOD_TIER_ORDER, MATERIAL_DISPLAY_NAME } from "../definitions/materialTiers.js";
2
3/** Facing axes placeable in the editor (E/W reuse N/S art). */
4export const DoorFacing = Object.freeze({
5 n: "n",
6 s: "s"
7});
8
9export const DoorOpenness = Object.freeze({
10 open: "open",
11 closed: "closed"
12});
13
14/**
15 * Visual aliases (documentation / future E-W placement):
16 * - n-open ≈ e-closed
17 * - s-open ≈ w-closed
18 * - s-closed ≈ w-open
19 * - n-closed ≈ e-open
20 */
21export const DOOR_FACING_ALIASES = Object.freeze({
22 "n-open": "e-closed",
23 "s-open": "w-closed",
24 "s-closed": "w-open",
25 "n-closed": "e-open"
26});
27
28export const DOOR_FACINGS = Object.freeze([DoorFacing.n, DoorFacing.s]);
29export const DOOR_OPENNESS = Object.freeze([DoorOpenness.closed, DoorOpenness.open]);
30
31/** Asset stem under `blocks/door/` (without wood tier). */
32export function doorAssetStem (facing, open)
33{
34 const face = facing === DoorFacing.n ? "n" : "s";
35 const openness = open ? "open" : "closed";
36 return `door-${face}-${openness}`;
37}
38
39/**
40 * Authored / runtime door state: `${wood}-${facing}-${open|closed}`.
41 * @returns {{ wood: string, facing: string, open: boolean } | null}
42 */
43export function parseDoorState (state)
44{
45 const text = String(state ?? "");
46 const match = /^(pine|birch|oak|ebony|lignum|heartwood|elder)-(n|s)-(open|closed)$/u.exec(text);
47 if (!match)
48 { return null; }
49 return {
50 wood: match[1],
51 facing: match[2],
52 open: match[3] === DoorOpenness.open
53 };
54}
55
56export function composeDoorState (wood, facing, open)
57{
58 const material = WOOD_TIER_ORDER.includes(wood) ? wood : WoodTier.pine;
59 const face = facing === DoorFacing.n ? DoorFacing.n : DoorFacing.s;
60 const openness = open ? DoorOpenness.open : DoorOpenness.closed;
61 return `${material}-${face}-${openness}`;
62}
63
64export function flipDoorState (state)
65{
66 const parsed = parseDoorState(state);
67 if (!parsed)
68 { return null; }
69 return composeDoorState(parsed.wood, parsed.facing, !parsed.open);
70}
71
72export function isDoorOpenState (state)
73{
74 return !!parseDoorState(state)?.open;
75}
76
77/**
78 * Y-sort sub-order within the door's tile (see `ySortLayer`).
79 * N-closed draws behind blocks/entities; S-closed in front of them;
80 * still shares the tile's sortY so the row above stays behind.
81 * Open doors use the default entity sub-order.
82 */
83export function doorSortSubOrder (state, defaultSubOrder = 3)
84{
85 const parsed = parseDoorState(state);
86 if (!parsed || parsed.open)
87 { return defaultSubOrder; }
88 if (parsed.facing === DoorFacing.n)
89 { return 1; }
90 return 4;
91}
92
93/**
94 * Passability for a door block. Closed doors are walkable only when the mover
95 * can open them (they auto-open on approach).
96 */
97export function isDoorTraversable (block, { canOpenDoors = false } = {})
98{
99 if (isDoorOpenState(block?.state))
100 { return true; }
101 return !!canOpenDoors;
102}
103
104export function listDoorStatesForWood (wood)
105{
106 const states = [];
107 for (const facing of DOOR_FACINGS)
108 {
109 for (const openness of DOOR_OPENNESS)
110 {
111 states.push(composeDoorState(wood, facing, openness === DoorOpenness.open));
112 }
113 }
114 return states;
115}
116
117export function listAllDoorStates ()
118{
119 const states = [];
120 for (const wood of WOOD_TIER_ORDER)
121 { states.push(...listDoorStatesForWood(wood)); }
122 return states;
123}
124
125export function doorPaletteDisplayName (state)
126{
127 const parsed = parseDoorState(state);
128 if (!parsed)
129 { return "Door"; }
130 const wood = MATERIAL_DISPLAY_NAME[parsed.wood] ?? parsed.wood;
131 const face = parsed.facing === DoorFacing.n ? "N" : "S";
132 const open = parsed.open ? "open" : "closed";
133 return `${wood} door (${face} ${open})`;
134}