feat(mystery): sample 3-room world for engine validation

src/world/encounters.ts

@@ -0,0 +1,29 @@
+import type { EncounterDef } from './types'
+
+export const encounters: Record<string, EncounterDef> = {
+  rat: {
+    id: 'rat',
+    startsIn: 'cellar-stair',
+    initialPhase: 'lurking',
+    phases: {
+      lurking: {
+        description: 'A heavy rat watches you from the third step. Its eyes catch the light.',
+        transitions: [
+          {
+            verb: 'attack',
+            target: 'rat',
+            narration: 'You stamp. The rat squeals and is gone into the dark.',
+            to: 'resolved',
+          },
+          {
+            verb: 'wait',
+            narration: 'The rat does not move. Neither do you.',
+            to: 'lurking',
+          },
+        ],
+      },
+    },
+    onResolved: { setFlags: { ratGone: true } },
+    defaultWrongVerbNarration: 'The rat watches.',
+  },
+}

src/world/index.ts

@@ -0,0 +1,14 @@
+import type { World } from './types'
+import { rooms } from './rooms'
+import { items } from './items'
+import { encounters } from './encounters'
+import { endings } from './story'
+
+export const world: World = {
+  startingRoom: 'foyer',
+  startingInventory: ['matches'],
+  rooms,
+  items,
+  encounters,
+  endings,
+}

src/world/items.ts

@@ -0,0 +1,28 @@
+import type { Item } from './types'
+
+export const items: Record<string, Item> = {
+  matches: {
+    id: 'matches',
+    names: ['matches', 'safety matches', 'box'],
+    short: 'a box of safety matches',
+    long: 'A small cardboard box of safety matches. Half-full.',
+    initialState: {},
+    takeable: true,
+  },
+  lamp: {
+    id: 'lamp',
+    names: ['lamp', 'oil lamp', 'torch'],
+    short: 'an oil lamp',
+    long: 'An iron oil lamp with a glass chimney. Currently unlit.',
+    initialState: { lit: false },
+    takeable: true,
+  },
+  letter: {
+    id: 'letter',
+    names: ['letter', 'folded letter', 'paper'],
+    short: 'a folded letter',
+    long: 'A folded letter on yellowed paper. The hand is unfamiliar. It reads: "Come at once. The thing in the cellar is waking."',
+    initialState: {},
+    takeable: true,
+  },
+}

src/world/rooms.ts

@@ -0,0 +1,44 @@
+import type { Room } from './types'
+
+export const rooms: Record<string, Room> = {
+  foyer: {
+    id: 'foyer',
+    title: '[ Foyer ]',
+    descriptions: {
+      firstVisit:
+        'You stand in the foyer of a house you do not remember entering. The door behind you has closed without sound. A folded letter lies on a small table. A hallway leads north.',
+      revisit: 'The foyer. The door behind you is still closed.',
+      examined:
+        'A foyer with peeling paper. A small table holds nothing but the letter. The air smells of cold stone. A hallway leads north.',
+    },
+    exits: { n: 'hallway' },
+    items: ['letter'],
+    safe: true,
+  },
+  hallway: {
+    id: 'hallway',
+    title: '[ Hallway ]',
+    descriptions: {
+      firstVisit:
+        'A long hallway, lit by nothing. An iron oil lamp sits on a side table. The foyer is south. A stair descends east.',
+      revisit: 'The long hallway.',
+      examined:
+        'The hallway runs further than the house should be wide. The dust on the floor is undisturbed except where you have walked. The oil lamp is on the side table.',
+    },
+    exits: { s: 'foyer', e: 'cellar-stair' },
+    items: ['lamp'],
+  },
+  'cellar-stair': {
+    id: 'cellar-stair',
+    title: '[ Cellar Stair ]',
+    descriptions: {
+      firstVisit:
+        'The stair drops into wet stone. The hallway is west. Something at the bottom is breathing.',
+      revisit: 'The stair to the cellar.',
+      examined: 'The stairs are stone, slick with damp. You can hear water below, and something else.',
+    },
+    exits: { w: 'hallway' },
+    items: [],
+    encounter: 'rat',
+  },
+}

src/world/story.ts

@@ -0,0 +1,17 @@
+import type { World } from './types'
+
+export const endings: World['endings'] = {
+  true: {
+    whenFlags: { ratGone: true },
+    narration:
+      'You stand at the top of the stair. The thing below has settled. The door behind you opens, and outside, finally, is morning.',
+  },
+  wrong: {
+    whenFlags: {},
+    narration: '',  // unreachable in sample world
+  },
+  bad: {
+    whenFlags: {},
+    narration: '',  // unreachable in sample world
+  },
+}