1 files changed, 39 insertions, 0 deletions
diff --git a/engine/entities/world-event.ts b/engine/entities/world-event.ts
new file mode 100644
index 0000000..e414bf4
--- /dev/null
+++ b/engine/entities/world-event.ts
@@ -0,0 +1,39 @@
+import type { GameTime } from 'time'
+import type { BaseEntity, PersonId, PlaceId, WorldEventId } from './base'
+
+export type EventCategory =
+  | 'pandemic'
+  | 'war'
+  | 'economic'
+  | 'political'
+  | 'natural_disaster'
+  | 'cultural'
+  | 'scientific'
+  | 'religious'
+  | 'social_movement'
+  | 'crime'
+  | 'notable_individual'
+
+export type SeverityLevel = 'mild' | 'moderate' | 'severe' | 'catastrophic'
+
+/**
+ * A named macro event decorating the timeline. See docs/02-world-events.md.
+ * The character-level impact of each event is applied per-person via
+ * templates referenced by contentRef; this entity is the world-scale record.
+ */
+export interface WorldEvent extends BaseEntity<WorldEventId, 'world_event'> {
+  readonly contentRef: string
+  readonly nameFormal: string
+  readonly nameColloquial: string
+  readonly category: EventCategory
+
+  readonly startedAt: GameTime
+  readonly endedAt: GameTime | null
+
+  readonly affectedRegions: ReadonlyMap<PlaceId, SeverityLevel>
+
+  readonly description: string
+
+  /** IDs of people who have had this event's per-person impact applied. */
+  readonly impactsApplied: readonly PersonId[]
+}