| 1 | import { 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). */ |
| 4 | export const DoorFacing = Object.freeze({ |
| 5 | n: "n", |
| 6 | s: "s" |
| 7 | }); |
| 8 | |
| 9 | export 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 | */ |
| 21 | export 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 | |
| 28 | export const DOOR_FACINGS = Object.freeze([DoorFacing.n, DoorFacing.s]); |
| 29 | export const DOOR_OPENNESS = Object.freeze([DoorOpenness.closed, DoorOpenness.open]); |
| 30 | |
| 31 | /** Asset stem under `blocks/door/` (without wood tier). */ |
| 32 | export 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 | */ |
| 43 | export 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 | |
| 56 | export 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 | |
| 64 | export 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 | |
| 72 | export 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 | */ |
| 83 | export 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 | */ |
| 97 | export function isDoorTraversable (block, { canOpenDoors = false } = {}) |
| 98 | { |
| 99 | if (isDoorOpenState(block?.state)) |
| 100 | { return true; } |
| 101 | return !!canOpenDoors; |
| 102 | } |
| 103 | |
| 104 | export 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 | |
| 117 | export function listAllDoorStates () |
| 118 | { |
| 119 | const states = []; |
| 120 | for (const wood of WOOD_TIER_ORDER) |
| 121 | { states.push(...listDoorStatesForWood(wood)); } |
| 122 | return states; |
| 123 | } |
| 124 | |
| 125 | export 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 | } |