✨Feature: add level 1 content including room templates, encounter tables, and room generation logic
- Introduced contentHelpers for table and room template lookups. - Created level1Rooms.ts with various room templates for level 1. - Added level1Tables.ts containing encounter tables for animals, martial, dogs, people, fungal, guards, workers, and room types. - Implemented room generation functions in rooms.ts to create rooms based on templates and tables. - Added tests for room generation logic in rooms.test.ts to ensure correct functionality.
This commit is contained in:
Keith Solomon
91
src/rules/rooms.test.ts
Normal file
91
src/rules/rooms.test.ts
Normal file
@@ -0,0 +1,91 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
|
||||
import { sampleContentPack } from "@/data/sampleContentPack";
|
||||
|
||||
import {
|
||||
createLevelShell,
|
||||
createRoomStateFromTemplate,
|
||||
generateLevel1StartRoom,
|
||||
generateRoomFromTable,
|
||||
} from "./rooms";
|
||||
|
||||
function createSequenceRoller(values: number[]) {
|
||||
let index = 0;
|
||||
|
||||
return () => {
|
||||
const next = values[index];
|
||||
index += 1;
|
||||
return next;
|
||||
};
|
||||
}
|
||||
|
||||
describe("room generation", () => {
|
||||
it("creates the level 1 start room from its template", () => {
|
||||
const result = generateLevel1StartRoom(sampleContentPack);
|
||||
|
||||
expect(result.templateSource).toBe("direct-template");
|
||||
expect(result.room.roomClass).toBe("start");
|
||||
expect(result.room.position).toEqual({ x: 0, y: 0 });
|
||||
expect(result.room.exits).toHaveLength(1);
|
||||
expect(result.room.exits[0]?.direction).toBe("north");
|
||||
});
|
||||
|
||||
it("generates a small room from the encoded small-room table", () => {
|
||||
const result = generateRoomFromTable({
|
||||
content: sampleContentPack,
|
||||
roomId: "room.level1.small.001",
|
||||
level: 1,
|
||||
roomTableCode: "L1SR",
|
||||
position: { x: 2, y: 1 },
|
||||
roller: createSequenceRoller([5, 5]),
|
||||
});
|
||||
|
||||
expect(result.lookup?.roll.total).toBe(10);
|
||||
expect(result.room.templateId).toBe("room.level1.small.heated-space");
|
||||
expect(result.room.dimensions).toEqual({ width: 2, height: 3 });
|
||||
expect(result.room.exits).toHaveLength(1);
|
||||
});
|
||||
|
||||
it("generates a large room from the encoded large-room table", () => {
|
||||
const result = generateRoomFromTable({
|
||||
content: sampleContentPack,
|
||||
roomId: "room.level1.large.001",
|
||||
level: 1,
|
||||
roomTableCode: "L1LR",
|
||||
position: { x: 4, y: 3 },
|
||||
roller: createSequenceRoller([4, 4]),
|
||||
});
|
||||
|
||||
expect(result.lookup?.roll.total).toBe(8);
|
||||
expect(result.room.templateId).toBe("room.level1.large.sparring-chamber");
|
||||
expect(result.room.dimensions).toEqual({ width: 6, height: 6 });
|
||||
expect(result.room.exits).toHaveLength(3);
|
||||
expect(result.room.flags).toContain("large");
|
||||
});
|
||||
|
||||
it("respects explicit template exits when they are defined", () => {
|
||||
const room = createRoomStateFromTemplate(
|
||||
sampleContentPack,
|
||||
"room.level1.custom.start",
|
||||
1,
|
||||
"room.level1.entry",
|
||||
{ x: 0, y: 0 },
|
||||
);
|
||||
|
||||
expect(room.exits).toEqual([
|
||||
expect.objectContaining({
|
||||
direction: "north",
|
||||
exitType: "door",
|
||||
discovered: true,
|
||||
}),
|
||||
]);
|
||||
});
|
||||
|
||||
it("creates a clean level shell for future dungeon state", () => {
|
||||
const level = createLevelShell(1);
|
||||
|
||||
expect(level.themeName).toBe("The Entry");
|
||||
expect(level.rooms).toEqual({});
|
||||
expect(level.discoveredRoomOrder).toEqual([]);
|
||||
});
|
||||
});
|
||||
198
src/rules/rooms.ts
Normal file
198
src/rules/rooms.ts
Normal file
@@ -0,0 +1,198 @@
|
||||
import {
|
||||
findRoomTemplateById,
|
||||
findRoomTemplateForLookup,
|
||||
findTableByCode,
|
||||
} from "@/data/contentHelpers";
|
||||
import type { ContentPack, ExitType, RoomClass } from "@/types/content";
|
||||
import type { RoomExitState, RoomState } from "@/types/state";
|
||||
|
||||
import { lookupTable, type TableLookupResult } from "./tables";
|
||||
import type { DiceRoller } from "./dice";
|
||||
|
||||
export type RoomGenerationOptions = {
|
||||
content: ContentPack;
|
||||
roomId: string;
|
||||
level: number;
|
||||
roomTemplateId?: string;
|
||||
roomTableCode?: string;
|
||||
roomClass?: RoomClass;
|
||||
position?: {
|
||||
x: number;
|
||||
y: number;
|
||||
};
|
||||
roller?: DiceRoller;
|
||||
};
|
||||
|
||||
export type RoomGenerationResult = {
|
||||
room: RoomState;
|
||||
lookup?: TableLookupResult;
|
||||
templateSource: "direct-template" | "table-lookup";
|
||||
};
|
||||
|
||||
const DEFAULT_ROOM_DIMENSIONS: Record<RoomClass, { width: number; height: number }> = {
|
||||
start: { width: 4, height: 4 },
|
||||
normal: { width: 4, height: 4 },
|
||||
small: { width: 2, height: 3 },
|
||||
large: { width: 6, height: 6 },
|
||||
special: { width: 4, height: 4 },
|
||||
stairs: { width: 4, height: 4 },
|
||||
};
|
||||
|
||||
const DEFAULT_DIRECTIONS = ["north", "east", "south", "west"] as const;
|
||||
|
||||
function inferExitType(exitHint?: string): ExitType {
|
||||
const normalized = exitHint?.toLowerCase() ?? "";
|
||||
|
||||
if (normalized.includes("reinforced")) {
|
||||
return "locked";
|
||||
}
|
||||
|
||||
if (normalized.includes("curtain")) {
|
||||
return "open";
|
||||
}
|
||||
|
||||
if (normalized.includes("archway")) {
|
||||
return "open";
|
||||
}
|
||||
|
||||
if (normalized.includes("wooden")) {
|
||||
return "door";
|
||||
}
|
||||
|
||||
return "door";
|
||||
}
|
||||
|
||||
function inferExitCount(roomClass: RoomClass, exitHint?: string) {
|
||||
const normalized = exitHint?.toLowerCase() ?? "";
|
||||
|
||||
if (normalized.includes("random")) {
|
||||
return roomClass === "large" ? 3 : 2;
|
||||
}
|
||||
|
||||
if (normalized.includes("archway")) {
|
||||
return roomClass === "large" ? 3 : 2;
|
||||
}
|
||||
|
||||
if (roomClass === "small") {
|
||||
return 1;
|
||||
}
|
||||
|
||||
if (roomClass === "large") {
|
||||
return 3;
|
||||
}
|
||||
|
||||
return 2;
|
||||
}
|
||||
|
||||
function createExits(
|
||||
roomId: string,
|
||||
roomClass: RoomClass,
|
||||
exitHint?: string,
|
||||
): RoomExitState[] {
|
||||
const exitCount = inferExitCount(roomClass, exitHint);
|
||||
const exitType = inferExitType(exitHint);
|
||||
|
||||
return DEFAULT_DIRECTIONS.slice(0, exitCount).map((direction, index) => ({
|
||||
id: `${roomId}.exit.${index + 1}`,
|
||||
direction,
|
||||
exitType,
|
||||
discovered: roomClass === "start",
|
||||
traversable: true,
|
||||
}));
|
||||
}
|
||||
|
||||
export function createRoomStateFromTemplate(
|
||||
content: ContentPack,
|
||||
roomId: string,
|
||||
level: number,
|
||||
roomTemplateId: string,
|
||||
position = { x: 0, y: 0 },
|
||||
): RoomState {
|
||||
const template = findRoomTemplateById(content, roomTemplateId);
|
||||
const dimensions = template.dimensions ?? DEFAULT_ROOM_DIMENSIONS[template.roomClass];
|
||||
const exits =
|
||||
template.exits?.map((exit, index) => ({
|
||||
id: `${roomId}.exit.${index + 1}`,
|
||||
direction: exit.direction ?? DEFAULT_DIRECTIONS[index] ?? "north",
|
||||
exitType: exit.exitType,
|
||||
discovered: template.roomClass === "start",
|
||||
traversable: exit.exitType !== "locked",
|
||||
destinationLevel: exit.destinationLevel,
|
||||
})) ?? createExits(roomId, template.roomClass, template.exitHint);
|
||||
|
||||
return {
|
||||
id: roomId,
|
||||
level,
|
||||
templateId: template.id,
|
||||
position,
|
||||
dimensions,
|
||||
roomClass: template.roomClass,
|
||||
exits,
|
||||
discovery: {
|
||||
generated: true,
|
||||
entered: template.roomClass === "start",
|
||||
cleared: false,
|
||||
searched: false,
|
||||
},
|
||||
encounter: undefined,
|
||||
objects: [],
|
||||
notes: [template.text ?? template.title].filter(Boolean),
|
||||
flags: [
|
||||
`table:${template.tableCode}`,
|
||||
`entry:${template.tableEntryKey}`,
|
||||
...(template.unique ? ["unique"] : []),
|
||||
...template.tags,
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
export function generateRoomFromTable(
|
||||
options: RoomGenerationOptions,
|
||||
): RoomGenerationResult {
|
||||
if (!options.roomTableCode) {
|
||||
throw new Error("Room table code is required for table-based room generation.");
|
||||
}
|
||||
|
||||
const table = findTableByCode(options.content, options.roomTableCode);
|
||||
const lookup = lookupTable(table, { roller: options.roller });
|
||||
const template = findRoomTemplateForLookup(options.content, lookup);
|
||||
const room = createRoomStateFromTemplate(
|
||||
options.content,
|
||||
options.roomId,
|
||||
options.level,
|
||||
template.id,
|
||||
options.position,
|
||||
);
|
||||
|
||||
return {
|
||||
room,
|
||||
lookup,
|
||||
templateSource: "table-lookup",
|
||||
};
|
||||
}
|
||||
|
||||
export function generateLevel1StartRoom(
|
||||
content: ContentPack,
|
||||
roomId = "room.level1.start",
|
||||
): RoomGenerationResult {
|
||||
const room = createRoomStateFromTemplate(content, roomId, 1, "room.level1.entry", {
|
||||
x: 0,
|
||||
y: 0,
|
||||
});
|
||||
|
||||
return {
|
||||
room,
|
||||
templateSource: "direct-template",
|
||||
};
|
||||
}
|
||||
|
||||
export function createLevelShell(level: number) {
|
||||
return {
|
||||
level,
|
||||
themeName: level === 1 ? "The Entry" : undefined,
|
||||
rooms: {},
|
||||
discoveredRoomOrder: [],
|
||||
secretDoorUsed: false,
|
||||
exhaustedExitSearch: false,
|
||||
};
|
||||
}
|
||||
Reference in New Issue
Block a user