we ball I guess

types/story/story.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright (c) 2026 Dominic Masters
+ *
+ * This software is released under the MIT License.
+ * https://opensource.org/licenses/MIT
+ */
+
+/** Opaque type alias for story flag identifier constants. */
+type StoryFlag = number;
+
+/** Story flag read/write access. */
+interface StoryNamespace {
+  /**
+   * Returns the current value of a story flag (0–255).
+   * @param flagId - A `STORY_FLAG_*` constant.
+   */
+  get(flagId: StoryFlag): number;
+
+  /**
+   * Sets a story flag to a new value.
+   * @param flagId - A `STORY_FLAG_*` constant.
+   * @param value  - New value, 0–255.
+   */
+  set(flagId: StoryFlag, value: number): void;
+}
+
+declare var Story: StoryNamespace;
+
+// Story flag constants — injected as globals by the engine at startup.
+declare var STORY_FLAG_TEST: StoryFlag;