qunitx 1.2.17 → 1.2.19

package/dist/deno/module.d.ts

@@ -27,21 +27,21 @@ import type { HooksObject } from '../types.d.ts';
  * });
  * ```
  */
-export default function module(moduleName: string, moduleContent: (hooks: HooksObject<Assert>, meta: {
+declare function module(moduleName: string, moduleContent: (hooks: HooksObject<Assert>, meta: {
     moduleName: string;
     options: unknown;
     context: Record<string, unknown>;
 }) => void): void;
+declare namespace module {
+    var skip: (moduleName: string, _moduleContent?: unknown) => void;
+    var todo: (moduleName: string, _moduleContent?: unknown) => void;
+}
 /** Defines a test module (suite) with optional Deno BDD runtime options forwarded to `describe()`. */
 declare function module(moduleName: string, runtimeOptions: object, moduleContent: (hooks: HooksObject<Assert>, meta: {
     moduleName: string;
     options: unknown;
     context: Record<string, unknown>;
 }) => void): void;
-declare namespace module {
-    var skip: (moduleName: string, _moduleContent?: unknown) => void;
-    var todo: (moduleName: string, _moduleContent?: unknown) => void;
-}
 export default module;
 export type { Assert };
 export type { HookFn, HooksObject, PushResultInfo } from '../types.d.ts';

package/dist/deno/module.js

@@ -1,4 +1,4 @@
-import { afterAll, beforeAll, describe } from "jsr:@std/testing/bdd";
+import { afterAll, beforeAll, describe } from "jsr:@std/testing@^1.0.17/bdd";
 import ModuleContext from "../shared/module-context.js";
 function module(moduleName, runtimeOptions, moduleContent) {
   const targetRuntimeOptions = moduleContent ? runtimeOptions : {};
@@ -59,6 +59,7 @@ module.todo = function todoModule(moduleName, _moduleContent) {
   describe(moduleName, { ignore: true }, function() {
   });
 };
+var module_default = module;
 export {
-  module as default
+  module_default as default
 };

package/dist/deno/test.d.ts

@@ -30,21 +30,21 @@ import type Assert from '../shared/assert.d.ts';
  * });
  * ```
  */
-export default function test(testName: string, testContent: (assert: Assert, meta: {
+declare function test(testName: string, testContent: (assert: Assert, meta: {
     testName: string;
     options: unknown;
     context: Record<string, unknown>;
 }) => void | Promise<void>): void;
+declare namespace test {
+    var skip: (testName: string, _testContent?: unknown) => void;
+    var todo: (testName: string, _testContent?: unknown) => void;
+}
 /** Defines an individual test with optional Deno BDD runtime options forwarded to `it()`. */
 declare function test(testName: string, runtimeOptions: object, testContent: (assert: Assert, meta: {
     testName: string;
     options: unknown;
     context: Record<string, unknown>;
 }) => void | Promise<void>): void;
-declare namespace test {
-    var skip: (testName: string, _testContent?: unknown) => void;
-    var todo: (testName: string, _testContent?: unknown) => void;
-}
 export default test;
 export type { Assert };
 export type { PushResultInfo } from '../types.d.ts';

package/dist/deno/test.js

@@ -1,4 +1,4 @@
-import { it } from "jsr:@std/testing/bdd";
+import { it } from "jsr:@std/testing@^1.0.17/bdd";
 import ModuleContext from "../shared/module-context.js";
 import TestContext from "../shared/test-context.js";
 function test(testName, runtimeOptions, testContent) {
@@ -55,6 +55,7 @@ test.todo = function todoTest(testName, _testContent) {
   it(testName, { ignore: true }, async function() {
   });
 };
+var test_default = test;
 export {
-  test as default
+  test_default as default
 };

package/dist/node/index.d.ts

@@ -1,10 +1,10 @@
-import Assert from '../shared/assert.d.ts';
-import Module from './module.d.ts';
-import Test from './test.d.ts';
+import type Assert from '../shared/assert.d.ts';
+import type Module from './module.d.ts';
+import type Test from './test.d.ts';
 export { Assert };
-export { default as module } from './module.d.ts';
+export { default as module } from './module.js';
 export declare const skip: (testName: string, _testContent?: unknown) => void;
-export { default as test } from './test.d.ts';
+export { default as test } from './test.js';
 export declare const todo: (testName: string, testContent?: (assert: Assert, meta: {
     testName: string;
     options: unknown;

package/dist/node/module.d.ts

@@ -33,19 +33,19 @@ import type { HooksObject } from '../types.d.ts';
  * });
  * ```
  */
-export default function module(moduleName: string, moduleContent: (hooks: HooksObject<Assert>, meta: {
+declare function module(moduleName: string, moduleContent: (hooks: HooksObject<Assert>, meta: {
     moduleName: string;
     options: unknown;
     context: Record<string, unknown>;
 }) => void): void;
+declare namespace module {
+    var skip: (moduleName: string, _moduleContent?: unknown) => void;
+    var todo: (moduleName: string, _moduleContent?: unknown) => void;
+}
 /** Defines a test module (suite) with optional Node test runner options forwarded to `describe()`. */
 declare function module(moduleName: string, runtimeOptions: object, moduleContent: (hooks: HooksObject<Assert>, meta: {
     moduleName: string;
     options: unknown;
     context: Record<string, unknown>;
 }) => void): void;
-declare namespace module {
-    var skip: (moduleName: string, _moduleContent?: unknown) => void;
-    var todo: (moduleName: string, _moduleContent?: unknown) => void;
-}
 export default module;

package/dist/node/module.js

@@ -61,6 +61,7 @@ module.todo = function todoModule(moduleName, _moduleContent) {
   callAtLocation(describe, captureCallerLocation(todoModule), moduleName, { skip: true }, function() {
   });
 };
+var module_default = module;
 export {
-  module as default
+  module_default as default
 };

package/dist/node/test.d.ts

@@ -31,13 +31,7 @@ import type Assert from '../shared/assert.d.ts';
  * });
  * ```
  */
-export default function test(testName: string, testContent: (assert: Assert, meta: {
-    testName: string;
-    options: unknown;
-    context: Record<string, unknown>;
-}) => void | Promise<void>): void;
-/** Defines an individual test with optional Node test runner options forwarded to `it()`. */
-declare function test(testName: string, runtimeOptions: object, testContent: (assert: Assert, meta: {
+declare function test(testName: string, testContent: (assert: Assert, meta: {
     testName: string;
     options: unknown;
     context: Record<string, unknown>;
@@ -49,4 +43,10 @@ declare namespace test {
         options: unknown;
     }) => void | Promise<void>) => void;
 }
+/** Defines an individual test with optional Node test runner options forwarded to `it()`. */
+declare function test(testName: string, runtimeOptions: object, testContent: (assert: Assert, meta: {
+    testName: string;
+    options: unknown;
+    context: Record<string, unknown>;
+}) => void | Promise<void>): void;
 export default test;

package/dist/node/test.js

@@ -62,6 +62,7 @@ test.todo = function todoTest(testName, testContent) {
   }
   test(testName, { todo: true }, testContent);
 };
+var test_default = test;
 export {
-  test as default
+  test_default as default
 };

package/dist/shared/assert.d.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.d.ts';
 /**
@@ -356,3 +376,4 @@ export default class Assert {
      */
     rejects(promise: unknown, expectedInput?: unknown, assertionMessage?: string): Promise<void>;
 }
+export type { PushResultInfo } from '../types.d.ts';

package/dist/shared/module-context.d.ts

@@ -1,6 +1,6 @@
 import type { HookFn } from '../types.d.ts';
 import type Assert from './assert.d.ts';
-import TestContext from './test-context.d.ts';
+import type TestContext from './test-context.d.ts';
 export default class ModuleContext {
     static Assert: typeof Assert;
     static currentModuleChain: ModuleContext[];

package/dist/types.d.ts

@@ -50,6 +50,7 @@ export interface ModuleState {
 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;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "qunitx",
   "type": "module",
-  "version": "1.2.17",
+  "version": "1.2.19",
   "description": "Universal test library — run the same test file in Node.js, Deno, and the browser with QUnit's battle-tested assertion API",
   "author": "Izel Nakri",
   "license": "MIT",
@@ -81,13 +81,10 @@
     "format": "prettier --check \"test/**/*.ts\" \"*.ts\" \"package.json\"",
     "format:fix": "prettier --write \"test/**/*.ts\" \"*.ts\" \"package.json\"",
     "lint": "deno lint shims/",
-    "lint:docs": "deno doc --lint shims/deno/module.ts shims/deno/test.ts",
+    "lint:docs": "deno doc --lint shims/deno/index.ts shims/deno/module.ts shims/deno/test.ts shims/shared/assert.ts",
     "build": "node build.ts",
     "build:cold": "rm -rf dist && node build.ts",
     "pretest": "node build.ts && node --input-type=module -e \"import{symlinkSync}from'fs';try{symlinkSync('..','node_modules/qunitx','junction')}catch(_){}\"",
-    "run:all": "npm run run:node && npm run run:deno",
-    "run:node": "node --test test/helpers/passing-tests.ts && node --test test/helpers/failing-tests.ts",
-    "run:deno": "deno test test/helpers/passing-tests.ts && deno test test/helpers/failing-tests.ts",
     "changelog:unreleased": "git-cliff --unreleased --strip all",
     "changelog:preview": "git-cliff",
     "changelog:update": "git-cliff --output CHANGELOG.md",
@@ -104,15 +101,21 @@
     "bench": "deno task bench",
     "bench:check": "deno task bench:check",
     "bench:update": "deno task bench:update",
-    "docs": "deno doc --html --name=\"QUnitX\" --output=docs/src shims/deno/index.ts"
+    "docs": "deno doc --html --name=\"QUnitX\" --output=docs/src shims/deno/index.ts",
+    "run:node": "node --test test/truthy-test.ts test/helpers/failing-location-fixture.ts",
+    "run:deno": "deno test --allow-read test/truthy-test.ts test/helpers/failing-location-fixture.ts",
+    "prerun:node": "npm run build",
+    "version": "node scripts/sync-jsr-version.ts",
+    "lint:jsr": "deno publish --dry-run --allow-dirty"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "playwright-core": "^1.59.1",
-    "prettier": "^3.8.1",
-    "qunit": "^2.25.0",
-    "qunitx-cli": "^0.9.10",
-    "typescript": "^6.0.2"
+    "@types/node": "^26.2.0",
+    "esbuild": "0.28.2",
+    "playwright-core": "^1.62.1",
+    "prettier": "^3.9.6",
+    "qunit": "^2.26.0",
+    "qunitx-cli": "^0.34.3",
+    "typescript": "^7.0.2"
   },
   "volta": {
     "node": "24.14.0"

package/shims/deno/index.ts

@@ -25,7 +25,7 @@
  * @module
  */
 import '../../vendor/qunit.js';
-import { AssertionError as DenoAssertionError } from 'jsr:@std/assert';
+import { AssertionError as DenoAssertionError } from 'jsr:@std/assert@^1.0.17';
 import Assert from '../shared/assert.ts';
 import { filterStack } from '../shared/filter-stack.ts';
 import ModuleContext from '../shared/module-context.ts';
@@ -53,6 +53,15 @@ import Test from './test.ts';
  * ```
  */
 export class AssertionError extends DenoAssertionError {
+  /**
+   * Builds an assertion failure, trimming the stack to the caller's frame.
+   *
+   * @param {object} object - Failure details.
+   * @param {string} [object.message] - Failure message; defaults to `"Assertion failed"`.
+   * @param {Function} [object.stackStartFn] - Frames at and above this function are cut
+   *   from the stack, so the trace starts at the caller's assertion rather than inside
+   *   QUnitX.
+   */
   constructor(object: AssertionErrorOptions) {
     super(object.message ?? 'Assertion failed');
     if (object.stackStartFn) Error.captureStackTrace(this, object.stackStartFn);
@@ -131,7 +140,7 @@ export { default as module } from './module.ts';
  * });
  * ```
  */
-export const skip = Test.skip;
+export const skip: (testName: string, _testContent?: unknown) => void = Test.skip;
 
 /**
  * Defines an individual test. Wraps Deno's `it()` and handles the full QUnit
@@ -164,7 +173,25 @@ export const skip = Test.skip;
  * ```
  */
 export { default as test } from './test.ts';
-export const todo = Test.todo;
+
+/**
+ * Registers a todo test. Equivalent to `test.todo`. The test body is never executed
+ * and the test is reported as ignored by Deno's runner, which has no native todo concept.
+ *
+ * @param {string} testName - Name of the test to mark as todo.
+ * @param {function} [_testContent] - Optional body (ignored — the test will not run).
+ * @example
+ * ```js
+ * import { module, todo } from "qunitx";
+ *
+ * module("Math", () => {
+ *   todo("addition is not yet implemented", (assert) => {
+ *     assert.equal(1 + 1, 2);
+ *   });
+ * });
+ * ```
+ */
+export const todo: (testName: string, _testContent?: unknown) => void = Test.todo;
 
 /**
  * The default export provides the full QUnitX API as a single object.
@@ -192,3 +219,6 @@ export const todo = Test.todo;
  *   for future QUnit config compatibility).
  */
 export default { AssertionError: Assert.AssertionError, module: Module, test: Test, config: {} };
+
+/** Public types referenced by the signatures above, so consumers can name them. */
+export type { HookFn, HooksObject, PushResultInfo, TestFn } from '../types.ts';

package/shims/deno/module.ts

@@ -1,4 +1,4 @@
-import { afterAll, beforeAll, describe } from 'jsr:@std/testing/bdd';
+import { afterAll, beforeAll, describe } from 'jsr:@std/testing@^1.0.17/bdd';
 import type Assert from '../shared/assert.ts';
 import ModuleContext from '../shared/module-context.ts';
 import type { HookFn, HooksObject } from '../types.ts';
@@ -30,10 +30,10 @@ import type { HookFn, HooksObject } from '../types.ts';
  * });
  * ```
  */
-export default function module(moduleName: string, moduleContent: (hooks: HooksObject<Assert>, meta: { moduleName: string; options: unknown; context: Record<string, unknown> }) => void): void;
+function module(moduleName: string, moduleContent: (hooks: HooksObject<Assert>, meta: { moduleName: string; options: unknown; context: Record<string, unknown> }) => void): void;
 /** Defines a test module (suite) with optional Deno BDD runtime options forwarded to `describe()`. */
-export default function module(moduleName: string, runtimeOptions: object, moduleContent: (hooks: HooksObject<Assert>, meta: { moduleName: string; options: unknown; context: Record<string, unknown> }) => void): void;
-export default function module(
+function module(moduleName: string, runtimeOptions: object, moduleContent: (hooks: HooksObject<Assert>, meta: { moduleName: string; options: unknown; context: Record<string, unknown> }) => void): void;
+function module(
   moduleName: string,
   runtimeOptions: object | ((hooks: HooksObject<Assert>) => void),
   moduleContent?: (hooks: HooksObject<Assert>, meta: { moduleName: string; options: unknown; context: Record<string, unknown> }) => void,
@@ -149,5 +149,11 @@ module.todo = function todoModule(moduleName: string, _moduleContent?: unknown):
   describe(moduleName, { ignore: true }, function () {});
 };
 
+// Exported here rather than on the declarations above: `export default function` on an
+// overload set that also carries a namespace merge (.skip/.todo) emits a .d.ts with two
+// `export default` statements, which is invalid TypeScript (TS2528/TS2652/TS2383) and
+// breaks consumers that typecheck with `skipLibCheck: false`.
+export default module;
+
 export type { Assert };
 export type { HookFn, HooksObject, PushResultInfo } from '../types.ts';

package/shims/deno/test.ts

@@ -1,4 +1,4 @@
-import { it } from 'jsr:@std/testing/bdd';
+import { it } from 'jsr:@std/testing@^1.0.17/bdd';
 import type Assert from '../shared/assert.ts';
 import ModuleContext from '../shared/module-context.ts';
 import TestContext from '../shared/test-context.ts';
@@ -34,10 +34,10 @@ import TestContext from '../shared/test-context.ts';
  * });
  * ```
  */
-export default function test(testName: string, testContent: (assert: Assert, meta: { testName: string; options: unknown; context: Record<string, unknown> }) => void | Promise<void>): void;
+function test(testName: string, testContent: (assert: Assert, meta: { testName: string; options: unknown; context: Record<string, unknown> }) => void | Promise<void>): void;
 /** Defines an individual test with optional Deno BDD runtime options forwarded to `it()`. */
-export default function test(testName: string, runtimeOptions: object, testContent: (assert: Assert, meta: { testName: string; options: unknown; context: Record<string, unknown> }) => void | Promise<void>): void;
-export default function test(
+function test(testName: string, runtimeOptions: object, testContent: (assert: Assert, meta: { testName: string; options: unknown; context: Record<string, unknown> }) => void | Promise<void>): void;
+function test(
   testName: string,
   runtimeOptions: object | ((assert: Assert, meta: { testName: string; options: unknown; context: Record<string, unknown> }) => void | Promise<void>),
   testContent?: (assert: Assert, meta: { testName: string; options: unknown; context: Record<string, unknown> }) => void | Promise<void>,
@@ -150,5 +150,11 @@ test.todo = function todoTest(testName: string, _testContent?: unknown): void {
   it(testName, { ignore: true }, async function () {});
 };
 
+// Exported here rather than on the declarations above: `export default function` on an
+// overload set that also carries a namespace merge (.skip/.todo) emits a .d.ts with two
+// `export default` statements, which is invalid TypeScript (TS2528/TS2652/TS2383) and
+// breaks consumers that typecheck with `skipLibCheck: false`.
+export default test;
+
 export type { Assert };
 export type { PushResultInfo } from '../types.ts';

package/shims/deno/vendor-types/jsr-std-assert.d.ts

@@ -1,4 +1,4 @@
-declare module 'jsr:@std/assert' {
+declare module 'jsr:@std/assert@^1.0.17' {
   class AssertionError extends Error {
     constructor(message: string, options?: ErrorOptions);
   }

package/shims/deno/vendor-types/jsr-std-testing-bdd.d.ts

@@ -1,4 +1,4 @@
-declare module 'jsr:@std/testing/bdd' {
+declare module 'jsr:@std/testing@^1.0.17/bdd' {
   function describe(name: string, options: Record<string, unknown>, fn: () => void): void;
   function describe(name: string, fn: () => void): void;
   function beforeAll(fn: () => void | Promise<void>): void;

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);
+      }
     });
   })();