From 4ccc7bf3acf37f977610427cb2403743a45571cc Mon Sep 17 00:00:00 2001
From: Steve Gravrock <sdg@panix.com>
Date: Sun, 14 Sep 2025 13:18:10 -0700
Subject: [PATCH] Document the order property of jasmineStarted and jasmineDone

---
 lib/jasmine-core/jasmine.js | 6 ++++++
 src/core/Runner.js          | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/lib/jasmine-core/jasmine.js b/lib/jasmine-core/jasmine.js
index 153f00d0..8ab0ec67 100644
--- a/lib/jasmine-core/jasmine.js
+++ b/lib/jasmine-core/jasmine.js
@@ -9530,6 +9530,12 @@ getJasmineRequireObj().Runner = function(j$) {
         // In parallel mode, the jasmineStarted event is separately dispatched
         // by jasmine-npm. This event only reaches reporters in non-parallel.
         totalSpecsDefined,
+        /**
+         * Information about the ordering (random or not) of this execution of the suite.
+         * @typedef Order
+         * @property {boolean} random - Whether the suite is running in random order
+         * @property {string} seed - The random seed
+         */
         order: order,
         parallel: false
       });
diff --git a/src/core/Runner.js b/src/core/Runner.js
index 4cf29970..db44c639 100644
--- a/src/core/Runner.js
+++ b/src/core/Runner.js
@@ -103,6 +103,12 @@ getJasmineRequireObj().Runner = function(j$) {
         // In parallel mode, the jasmineStarted event is separately dispatched
         // by jasmine-npm. This event only reaches reporters in non-parallel.
         totalSpecsDefined,
+        /**
+         * Information about the ordering (random or not) of this execution of the suite.
+         * @typedef Order
+         * @property {boolean} random - Whether the suite is running in random order
+         * @property {string} seed - The random seed
+         */
         order: order,
         parallel: false
       });