qunitx 1.2.18 → 1.3.0

package/shims/shared/assert.ts

@@ -1,3 +1,23 @@
+/**
+ * QUnitX's assertion API, on its own.
+ *
+ * The same {@linkcode Assert} instance every `test()` callback receives, importable
+ * directly for code that wants QUnit's assertions without QUnitX's runner wrapper —
+ * a custom harness, a helper that takes `assert` and adds domain checks, or a runtime
+ * where no test runner is involved at all. This entrypoint touches no runner API, so
+ * unlike the package root it runs anywhere: Deno, Node.js and the browser.
+ *
+ * @example
+ * ```ts
+ * import Assert from '@izelnakri/qunitx/assert';
+ *
+ * function assertIsEven(assert: Assert, value: number) {
+ *   assert.strictEqual(value % 2, 0, `${value} is even`);
+ * }
+ * ```
+ *
+ * @module
+ */
 import '../../vendor/qunit.js';
 import type { AssertionErrorConstructor, InspectFn, ModuleState, PushResultInfo, QUnitObject, TestState } from '../types.ts';
 import { objectValues, objectValuesSubset, validateException, validateExpectedExceptionArgs } from './index.ts';
@@ -717,3 +737,7 @@ function lcsDiff(a: string[], b: string[]): DiffEntry[] {
   }
   return result.reverse();
 }
+
+// Re-exported so the public signature of Assert#pushResult does not reference a type
+// that consumers of this entrypoint cannot name (deno doc: private-type-ref).
+export type { PushResultInfo } from '../types.ts';

package/shims/types.ts

@@ -49,6 +49,7 @@ export interface ModuleState {
 
 /** A lifecycle hook callback that receives an {@linkcode Assert} instance and a meta object with the shared context. */
 export type HookFn<A = unknown> = (assert: A, meta: { context: Record<string, unknown> }) => void | Promise<void>;
+/** A test body: receives an {@linkcode Assert} instance and a meta object naming the test, its runtime options, and the shared context. */
 export type TestFn<A = unknown> = (
   assert: A,
   meta: { testName: string; options: unknown; context: Record<string, unknown> },

package/vendor/qunit.css

@@ -1,5 +1,5 @@
 /*!
- * QUnit 2.25.0
+ * QUnit 2.26.0
  * https://qunitjs.com/
  *
  * Copyright OpenJS Foundation and other contributors

package/vendor/qunit.js

@@ -5,7 +5,7 @@
   }
 })();
 /*!
- * QUnit 2.25.0
+ * QUnit 2.26.0
  * https://qunitjs.com/
  *
  * Copyright OpenJS Foundation and other contributors
@@ -716,6 +716,7 @@
     failOnZeroTests: true,
     // Select by pattern or case-insensitive substring match against "moduleName: testName"
     filter: undefined,
+    ignoreUnhandledRejections: false,
     testFilter: null,
     // TODO: Make explicit in QUnit 3.
     // fixture: undefined,
@@ -1945,6 +1946,7 @@
           expected: expected,
           message: message
         });
+        return actual;
       }
     }, {
       key: "rejects",
@@ -1986,6 +1988,7 @@
             message: message
           });
           done();
+          return actual;
         });
       }
     }]);
@@ -5529,7 +5532,7 @@
   QUnit.isLocal = window$1 && window$1.location && window$1.location.protocol === 'file:';
 
   // Expose the current QUnit version
-  QUnit.version = '2.25.0';
+  QUnit.version = '2.26.0';
   extend(QUnit, {
     config: config,
     diff: diff,
@@ -7484,7 +7487,9 @@
       return ret;
     };
     window$1.addEventListener('unhandledrejection', function (event) {
-      QUnit.onUncaughtException(event.reason);
+      if (!QUnit.config.ignoreUnhandledRejections) {
+        QUnit.onUncaughtException(event.reason);
+      }
     });
   })();