@logtape/testing-node 2.3.0-dev.0

package/dist/autoload.js

@@ -0,0 +1,159 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { ConfigError, configureSync, getConfig } from "@logtape/logtape";
+import nodeTest, { after, afterEach, before, beforeEach, describe, it as it$1, mock, run, suite } from "node:test";
+import { createFailureLogReporter } from "@logtape/testing/reporter";
+
+//#region src/mod.ts
+/**
+* Creates a `node:test` test function that reports LogTape records from failed
+* test callbacks.
+*
+* The returned function preserves Node.js test options and shorthand helpers
+* such as `test.only()`, `test.skip()`, and `test.todo()`.  Only callback
+* arguments are adapted; options are passed through to `node:test`.
+*
+* @param options Failure log reporter options.
+* @returns A configured `node:test`-compatible test function.
+* @since 2.3.0
+*/
+function createTest(options = {}) {
+	return createNodeTestFunction(nodeTest, options);
+}
+/**
+* Creates an `it()` alias that reports LogTape records from failed test
+* callbacks.
+*
+* @param options Failure log reporter options.
+* @returns A configured `node:test`-compatible `it()` function.
+* @since 2.3.0
+*/
+function createIt(options = {}) {
+	return createNodeTestFunction(it$1, options);
+}
+/**
+* A `node:test` test function that reports LogTape records from failed test
+* callbacks using the default reporter options.
+*
+* @since 2.3.0
+*/
+const test = createTest();
+/**
+* A `node:test` `it()` alias that reports LogTape records from failed test
+* callbacks using the default reporter options.
+*
+* @since 2.3.0
+*/
+const it = createIt();
+/**
+* Shorthand for marking a test as `only`.
+*
+* @since 2.3.0
+*/
+const only = test.only;
+/**
+* Shorthand for skipping a test.
+*
+* @since 2.3.0
+*/
+const skip = test.skip;
+/**
+* Shorthand for marking a test as TODO.
+*
+* @since 2.3.0
+*/
+const todo = test.todo;
+/**
+* Shorthand for expecting a test to fail when supported by the active Node.js
+* runtime.
+*
+* @since 2.3.0
+*/
+const expectFailure = test.expectFailure;
+/**
+* Node.js' test assertion tracker when supported by the active runtime.
+*
+* @since 2.3.0
+*/
+const assert = test.assert;
+/**
+* Node.js' snapshot helper when supported by the active runtime.
+*
+* @since 2.3.0
+*/
+const snapshot = test.snapshot;
+var src_default = test;
+function createNodeTestFunction(baseTest, options, includeExtendedProperties = true) {
+	const register = (...args) => Reflect.apply(baseTest, void 0, wrapCallbackArgument(args, options));
+	const baseExpectFailure = baseTest.expectFailure;
+	const wrapped = Object.assign(register, baseTest, {
+		only: (...args) => Reflect.apply(baseTest.only, void 0, wrapCallbackArgument(args, options)),
+		skip: (...args) => Reflect.apply(baseTest.skip, void 0, wrapCallbackArgument(args, options)),
+		todo: (...args) => Reflect.apply(baseTest.todo, void 0, wrapCallbackArgument(args, options)),
+		expectFailure: typeof baseExpectFailure === "function" ? (...args) => Reflect.apply(baseExpectFailure, void 0, wrapCallbackArgument(args, options)) : void 0
+	});
+	if (includeExtendedProperties) {
+		if (typeof baseTest.it === "function") Object.defineProperty(wrapped, "it", {
+			configurable: true,
+			enumerable: true,
+			value: createNodeTestFunction(baseTest.it, options, false),
+			writable: true
+		});
+		if (typeof baseTest.test === "function") Object.defineProperty(wrapped, "test", {
+			configurable: true,
+			enumerable: true,
+			value: wrapped,
+			writable: true
+		});
+	}
+	return wrapped;
+}
+function wrapCallbackArgument(args, options) {
+	const callback = args.at(-1);
+	if (typeof callback !== "function") return [...args];
+	const reporter = createFailureLogReporter(options);
+	const wrapped = wrapNodeCallback(reporter.wrap.bind(reporter), callback);
+	return [...args.slice(0, -1), wrapped];
+}
+function wrapNodeCallback(wrap, callback) {
+	if (callback.length >= 2) return function(context, done) {
+		const runCallback = (...args) => Reflect.apply(callback, this, args);
+		wrap(() => new Promise((resolve, reject) => {
+			let settled = false;
+			const wrappedDone = (error) => {
+				if (settled) return;
+				settled = true;
+				if (error == null) resolve();
+				else reject(error);
+			};
+			try {
+				runCallback(context, wrappedDone);
+			} catch (error) {
+				reject(error);
+			}
+		}))().then(() => done(), (error) => done(error));
+	};
+	if (callback.length === 0) return function() {
+		return wrap(() => Reflect.apply(callback, this, []))();
+	};
+	return function(context) {
+		return wrap(() => Reflect.apply(callback, this, [context]))();
+	};
+}
+
+//#endregion
+//#region src/autoload.ts
+const config = getConfig();
+if (config == null) configureSync({
+	contextLocalStorage: new AsyncLocalStorage(),
+	sinks: {},
+	loggers: [{
+		category: ["logtape", "meta"],
+		sinks: []
+	}]
+});
+else if (config.contextLocalStorage == null) throw new ConfigError("@logtape/testing-node/autoload requires the existing LogTape configuration to provide contextLocalStorage.");
+var autoload_default = src_default;
+
+//#endregion
+export { after, afterEach, assert, before, beforeEach, createIt, createTest, autoload_default as default, describe, expectFailure, it, mock, only, run, skip, snapshot, suite, src_default as test, todo };
+//# sourceMappingURL=autoload.js.map

package/dist/autoload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoload.js","names":["options: FailureLogReporterOptions","nodeIt","test: NodeTestFunction","it: NodeTestFunction","only: NodeTestFunction","skip: NodeTestFunction","todo: NodeTestFunction","expectFailure: NodeTestFunction | undefined","assert: unknown","snapshot: unknown","baseTest: BaseNodeTestFunction","args: readonly unknown[]","wrap: ReturnType<typeof createFailureLogReporter>[\"wrap\"]","callback: AnyFunction","context: TestContext","done: NodeDoneCallback","wrappedDone: NodeDoneCallback","error?: unknown","error: unknown","test"],"sources":["../src/mod.ts","../src/autoload.ts"],"sourcesContent":["import nodeTest, { it as nodeIt } from \"node:test\";\nimport type { TestContext } from \"node:test\";\n\nimport {\n  createFailureLogReporter,\n  type FailureLogReporterOptions,\n} from \"@logtape/testing/reporter\";\n\nexport type {\n  FailureLogReporterOptions,\n  FailureLogReportMode,\n} from \"@logtape/testing/reporter\";\nexport {\n  after,\n  afterEach,\n  before,\n  beforeEach,\n  describe,\n  mock,\n  run,\n  suite,\n} from \"node:test\";\n\n/**\n * Options accepted by Node.js `test()` and `it()` functions.\n *\n * The shape intentionally mirrors Node's documented option bag while allowing\n * newer Node.js options to pass through even when a runtime's bundled TypeScript\n * declarations lag behind the current documentation.\n *\n * @since 2.3.0\n */\nexport interface NodeTestOptions {\n  readonly concurrency?: number | boolean;\n  readonly expectFailure?:\n    | boolean\n    | string\n    | RegExp\n    | ((error: unknown) => boolean)\n    | object\n    | Error;\n  readonly only?: boolean;\n  readonly signal?: AbortSignal;\n  readonly skip?: boolean | string;\n  readonly tags?: readonly string[];\n  readonly todo?: boolean | string;\n  readonly timeout?: number;\n  readonly plan?: number;\n}\n\n/**\n * A callback passed to Node.js `test()` or `it()`.\n *\n * @since 2.3.0\n */\nexport type NodeTestCallback = (\n  context: TestContext,\n  done?: NodeDoneCallback,\n) => unknown;\n\n/**\n * A Node.js `test()`-compatible function.\n *\n * @since 2.3.0\n */\nexport interface NodeTestFunction {\n  (name?: string, options?: NodeTestOptions, fn?: NodeTestCallback): Promise<\n    void\n  >;\n  (name?: string, fn?: NodeTestCallback): Promise<void>;\n  (options?: NodeTestOptions, fn?: NodeTestCallback): Promise<void>;\n  (fn?: NodeTestCallback): Promise<void>;\n  readonly only: NodeTestFunction;\n  readonly skip: NodeTestFunction;\n  readonly todo: NodeTestFunction;\n  readonly expectFailure?: NodeTestFunction;\n  readonly it?: NodeTestFunction;\n  readonly test?: NodeTestFunction;\n}\n\ntype NodeDoneCallback = (error?: unknown) => void;\ntype AnyFunction = (...args: never[]) => unknown;\ntype BaseNodeTestFunction = AnyFunction & {\n  readonly only: AnyFunction;\n  readonly skip: AnyFunction;\n  readonly todo: AnyFunction;\n  readonly expectFailure?: AnyFunction;\n  readonly it?: AnyFunction;\n  readonly test?: AnyFunction;\n};\n\n/**\n * Creates a `node:test` test function that reports LogTape records from failed\n * test callbacks.\n *\n * The returned function preserves Node.js test options and shorthand helpers\n * such as `test.only()`, `test.skip()`, and `test.todo()`.  Only callback\n * arguments are adapted; options are passed through to `node:test`.\n *\n * @param options Failure log reporter options.\n * @returns A configured `node:test`-compatible test function.\n * @since 2.3.0\n */\nexport function createTest(\n  options: FailureLogReporterOptions = {},\n): NodeTestFunction {\n  return createNodeTestFunction(\n    nodeTest as unknown as BaseNodeTestFunction,\n    options,\n  );\n}\n\n/**\n * Creates an `it()` alias that reports LogTape records from failed test\n * callbacks.\n *\n * @param options Failure log reporter options.\n * @returns A configured `node:test`-compatible `it()` function.\n * @since 2.3.0\n */\nexport function createIt(\n  options: FailureLogReporterOptions = {},\n): NodeTestFunction {\n  return createNodeTestFunction(\n    nodeIt as unknown as BaseNodeTestFunction,\n    options,\n  );\n}\n\n/**\n * A `node:test` test function that reports LogTape records from failed test\n * callbacks using the default reporter options.\n *\n * @since 2.3.0\n */\nexport const test: NodeTestFunction = createTest();\n\n/**\n * A `node:test` `it()` alias that reports LogTape records from failed test\n * callbacks using the default reporter options.\n *\n * @since 2.3.0\n */\nexport const it: NodeTestFunction = createIt();\n\n/**\n * Shorthand for marking a test as `only`.\n *\n * @since 2.3.0\n */\nexport const only: NodeTestFunction = test.only;\n\n/**\n * Shorthand for skipping a test.\n *\n * @since 2.3.0\n */\nexport const skip: NodeTestFunction = test.skip;\n\n/**\n * Shorthand for marking a test as TODO.\n *\n * @since 2.3.0\n */\nexport const todo: NodeTestFunction = test.todo;\n\n/**\n * Shorthand for expecting a test to fail when supported by the active Node.js\n * runtime.\n *\n * @since 2.3.0\n */\nexport const expectFailure: NodeTestFunction | undefined = test.expectFailure;\n\n/**\n * Node.js' test assertion tracker when supported by the active runtime.\n *\n * @since 2.3.0\n */\nexport const assert: unknown = (test as { readonly assert?: unknown }).assert;\n\n/**\n * Node.js' snapshot helper when supported by the active runtime.\n *\n * @since 2.3.0\n */\nexport const snapshot: unknown = (test as { readonly snapshot?: unknown })\n  .snapshot;\n\nexport default test;\n\nfunction createNodeTestFunction(\n  baseTest: BaseNodeTestFunction,\n  options: FailureLogReporterOptions,\n  includeExtendedProperties = true,\n): NodeTestFunction {\n  const register = ((...args: unknown[]) =>\n    Reflect.apply(\n      baseTest,\n      undefined,\n      wrapCallbackArgument(args, options),\n    )) as NodeTestFunction;\n\n  const baseExpectFailure = baseTest.expectFailure;\n  const wrapped = Object.assign(register, baseTest, {\n    only: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.only,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"only\"],\n    skip: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.skip,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"skip\"],\n    todo: ((...args: unknown[]) =>\n      Reflect.apply(\n        baseTest.todo,\n        undefined,\n        wrapCallbackArgument(args, options),\n      )) as NodeTestFunction[\"todo\"],\n    expectFailure: typeof baseExpectFailure === \"function\"\n      ? ((...args: unknown[]) =>\n        Reflect.apply(\n          baseExpectFailure,\n          undefined,\n          wrapCallbackArgument(args, options),\n        )) as NodeTestFunction[\"expectFailure\"]\n      : undefined,\n  });\n\n  if (includeExtendedProperties) {\n    if (typeof baseTest.it === \"function\") {\n      Object.defineProperty(wrapped, \"it\", {\n        configurable: true,\n        enumerable: true,\n        value: createNodeTestFunction(\n          baseTest.it as BaseNodeTestFunction,\n          options,\n          false,\n        ),\n        writable: true,\n      });\n    }\n    if (typeof baseTest.test === \"function\") {\n      Object.defineProperty(wrapped, \"test\", {\n        configurable: true,\n        enumerable: true,\n        value: wrapped,\n        writable: true,\n      });\n    }\n  }\n\n  return wrapped;\n}\n\nfunction wrapCallbackArgument(\n  args: readonly unknown[],\n  options: FailureLogReporterOptions,\n): unknown[] {\n  const callback = args.at(-1);\n  if (typeof callback !== \"function\") return [...args];\n\n  const reporter = createFailureLogReporter(options);\n  const wrapped = wrapNodeCallback(\n    reporter.wrap.bind(reporter),\n    callback as unknown as AnyFunction,\n  );\n  return [...args.slice(0, -1), wrapped];\n}\n\nfunction wrapNodeCallback(\n  wrap: ReturnType<typeof createFailureLogReporter>[\"wrap\"],\n  callback: AnyFunction,\n): AnyFunction {\n  if (callback.length >= 2) {\n    return function (\n      this: unknown,\n      context: TestContext,\n      done: NodeDoneCallback,\n    ): void {\n      const runCallback = (...args: readonly unknown[]): unknown =>\n        Reflect.apply(callback, this, args);\n      void wrap(() =>\n        new Promise<void>((resolve, reject) => {\n          let settled = false;\n          const wrappedDone: NodeDoneCallback = ((error?: unknown) => {\n            if (settled) return;\n            settled = true;\n            if (error == null) resolve();\n            else reject(error);\n          }) as NodeDoneCallback;\n\n          try {\n            runCallback(context, wrappedDone);\n          } catch (error) {\n            reject(error);\n          }\n        })\n      )().then(\n        () => done(),\n        (error: unknown) => done(error),\n      );\n    };\n  }\n\n  if (callback.length === 0) {\n    return function (this: unknown): Promise<unknown> {\n      return wrap(() => Reflect.apply(callback, this, []))();\n    };\n  }\n\n  return function (this: unknown, context: TestContext): Promise<unknown> {\n    return wrap(() => Reflect.apply(callback, this, [context]))();\n  };\n}\n\nexport type { TestContext };\n","import { AsyncLocalStorage } from \"node:async_hooks\";\n\nimport {\n  ConfigError,\n  configureSync,\n  type ContextLocalStorage,\n  getConfig,\n} from \"@logtape/logtape\";\n\nimport {\n  after,\n  afterEach,\n  assert,\n  before,\n  beforeEach,\n  createIt,\n  createTest,\n  default as test,\n  describe,\n  expectFailure,\n  it,\n  mock,\n  only,\n  run,\n  skip,\n  snapshot,\n  suite,\n  todo,\n} from \"./mod.ts\";\n\nexport type {\n  FailureLogReporterOptions,\n  FailureLogReportMode,\n  NodeTestCallback,\n  NodeTestFunction,\n  NodeTestOptions,\n  TestContext,\n} from \"./mod.ts\";\n\nconst config = getConfig();\n\nif (config == null) {\n  configureSync({\n    contextLocalStorage: new AsyncLocalStorage() as ContextLocalStorage<\n      Record<string, unknown>\n    >,\n    sinks: {},\n    loggers: [\n      { category: [\"logtape\", \"meta\"], sinks: [] },\n    ],\n  });\n} else if (config.contextLocalStorage == null) {\n  throw new ConfigError(\n    \"@logtape/testing-node/autoload requires the existing LogTape \" +\n      \"configuration to provide contextLocalStorage.\",\n  );\n}\n\nexport {\n  after,\n  afterEach,\n  assert,\n  before,\n  beforeEach,\n  createIt,\n  createTest,\n  describe,\n  expectFailure,\n  it,\n  mock,\n  only,\n  run,\n  skip,\n  snapshot,\n  suite,\n  test,\n  todo,\n};\nexport default test;\n"],"mappings":"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"}

package/dist/mod.cjs

@@ -0,0 +1,202 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const node_test = require_rolldown_runtime.__toESM(require("node:test"));
+const __logtape_testing_reporter = require_rolldown_runtime.__toESM(require("@logtape/testing/reporter"));
+
+//#region src/mod.ts
+/**
+* Creates a `node:test` test function that reports LogTape records from failed
+* test callbacks.
+*
+* The returned function preserves Node.js test options and shorthand helpers
+* such as `test.only()`, `test.skip()`, and `test.todo()`.  Only callback
+* arguments are adapted; options are passed through to `node:test`.
+*
+* @param options Failure log reporter options.
+* @returns A configured `node:test`-compatible test function.
+* @since 2.3.0
+*/
+function createTest(options = {}) {
+	return createNodeTestFunction(node_test.default, options);
+}
+/**
+* Creates an `it()` alias that reports LogTape records from failed test
+* callbacks.
+*
+* @param options Failure log reporter options.
+* @returns A configured `node:test`-compatible `it()` function.
+* @since 2.3.0
+*/
+function createIt(options = {}) {
+	return createNodeTestFunction(node_test.it, options);
+}
+/**
+* A `node:test` test function that reports LogTape records from failed test
+* callbacks using the default reporter options.
+*
+* @since 2.3.0
+*/
+const test = createTest();
+/**
+* A `node:test` `it()` alias that reports LogTape records from failed test
+* callbacks using the default reporter options.
+*
+* @since 2.3.0
+*/
+const it = createIt();
+/**
+* Shorthand for marking a test as `only`.
+*
+* @since 2.3.0
+*/
+const only = test.only;
+/**
+* Shorthand for skipping a test.
+*
+* @since 2.3.0
+*/
+const skip = test.skip;
+/**
+* Shorthand for marking a test as TODO.
+*
+* @since 2.3.0
+*/
+const todo = test.todo;
+/**
+* Shorthand for expecting a test to fail when supported by the active Node.js
+* runtime.
+*
+* @since 2.3.0
+*/
+const expectFailure = test.expectFailure;
+/**
+* Node.js' test assertion tracker when supported by the active runtime.
+*
+* @since 2.3.0
+*/
+const assert = test.assert;
+/**
+* Node.js' snapshot helper when supported by the active runtime.
+*
+* @since 2.3.0
+*/
+const snapshot = test.snapshot;
+var src_default = test;
+function createNodeTestFunction(baseTest, options, includeExtendedProperties = true) {
+	const register = (...args) => Reflect.apply(baseTest, void 0, wrapCallbackArgument(args, options));
+	const baseExpectFailure = baseTest.expectFailure;
+	const wrapped = Object.assign(register, baseTest, {
+		only: (...args) => Reflect.apply(baseTest.only, void 0, wrapCallbackArgument(args, options)),
+		skip: (...args) => Reflect.apply(baseTest.skip, void 0, wrapCallbackArgument(args, options)),
+		todo: (...args) => Reflect.apply(baseTest.todo, void 0, wrapCallbackArgument(args, options)),
+		expectFailure: typeof baseExpectFailure === "function" ? (...args) => Reflect.apply(baseExpectFailure, void 0, wrapCallbackArgument(args, options)) : void 0
+	});
+	if (includeExtendedProperties) {
+		if (typeof baseTest.it === "function") Object.defineProperty(wrapped, "it", {
+			configurable: true,
+			enumerable: true,
+			value: createNodeTestFunction(baseTest.it, options, false),
+			writable: true
+		});
+		if (typeof baseTest.test === "function") Object.defineProperty(wrapped, "test", {
+			configurable: true,
+			enumerable: true,
+			value: wrapped,
+			writable: true
+		});
+	}
+	return wrapped;
+}
+function wrapCallbackArgument(args, options) {
+	const callback = args.at(-1);
+	if (typeof callback !== "function") return [...args];
+	const reporter = (0, __logtape_testing_reporter.createFailureLogReporter)(options);
+	const wrapped = wrapNodeCallback(reporter.wrap.bind(reporter), callback);
+	return [...args.slice(0, -1), wrapped];
+}
+function wrapNodeCallback(wrap, callback) {
+	if (callback.length >= 2) return function(context, done) {
+		const runCallback = (...args) => Reflect.apply(callback, this, args);
+		wrap(() => new Promise((resolve, reject) => {
+			let settled = false;
+			const wrappedDone = (error) => {
+				if (settled) return;
+				settled = true;
+				if (error == null) resolve();
+				else reject(error);
+			};
+			try {
+				runCallback(context, wrappedDone);
+			} catch (error) {
+				reject(error);
+			}
+		}))().then(() => done(), (error) => done(error));
+	};
+	if (callback.length === 0) return function() {
+		return wrap(() => Reflect.apply(callback, this, []))();
+	};
+	return function(context) {
+		return wrap(() => Reflect.apply(callback, this, [context]))();
+	};
+}
+
+//#endregion
+Object.defineProperty(exports, 'after', {
+  enumerable: true,
+  get: function () {
+    return node_test.after;
+  }
+});
+Object.defineProperty(exports, 'afterEach', {
+  enumerable: true,
+  get: function () {
+    return node_test.afterEach;
+  }
+});
+exports.assert = assert;
+Object.defineProperty(exports, 'before', {
+  enumerable: true,
+  get: function () {
+    return node_test.before;
+  }
+});
+Object.defineProperty(exports, 'beforeEach', {
+  enumerable: true,
+  get: function () {
+    return node_test.beforeEach;
+  }
+});
+exports.createIt = createIt;
+exports.createTest = createTest;
+exports.default = src_default;
+Object.defineProperty(exports, 'describe', {
+  enumerable: true,
+  get: function () {
+    return node_test.describe;
+  }
+});
+exports.expectFailure = expectFailure;
+exports.it = it;
+Object.defineProperty(exports, 'mock', {
+  enumerable: true,
+  get: function () {
+    return node_test.mock;
+  }
+});
+exports.only = only;
+Object.defineProperty(exports, 'run', {
+  enumerable: true,
+  get: function () {
+    return node_test.run;
+  }
+});
+exports.skip = skip;
+exports.snapshot = snapshot;
+Object.defineProperty(exports, 'suite', {
+  enumerable: true,
+  get: function () {
+    return node_test.suite;
+  }
+});
+exports.test = test;
+exports.todo = todo;

package/dist/mod.d.cts

@@ -0,0 +1,125 @@
+import { TestContext, after, afterEach, before, beforeEach, describe, mock, run, suite } from "node:test";
+import { FailureLogReportMode, FailureLogReporterOptions, FailureLogReporterOptions as FailureLogReporterOptions$1 } from "@logtape/testing/reporter";
+
+//#region src/mod.d.ts
+
+/**
+ * Options accepted by Node.js `test()` and `it()` functions.
+ *
+ * The shape intentionally mirrors Node's documented option bag while allowing
+ * newer Node.js options to pass through even when a runtime's bundled TypeScript
+ * declarations lag behind the current documentation.
+ *
+ * @since 2.3.0
+ */
+interface NodeTestOptions {
+  readonly concurrency?: number | boolean;
+  readonly expectFailure?: boolean | string | RegExp | ((error: unknown) => boolean) | object | Error;
+  readonly only?: boolean;
+  readonly signal?: AbortSignal;
+  readonly skip?: boolean | string;
+  readonly tags?: readonly string[];
+  readonly todo?: boolean | string;
+  readonly timeout?: number;
+  readonly plan?: number;
+}
+/**
+ * A callback passed to Node.js `test()` or `it()`.
+ *
+ * @since 2.3.0
+ */
+type NodeTestCallback = (context: TestContext, done?: NodeDoneCallback) => unknown;
+/**
+ * A Node.js `test()`-compatible function.
+ *
+ * @since 2.3.0
+ */
+interface NodeTestFunction {
+  (name?: string, options?: NodeTestOptions, fn?: NodeTestCallback): Promise<void>;
+  (name?: string, fn?: NodeTestCallback): Promise<void>;
+  (options?: NodeTestOptions, fn?: NodeTestCallback): Promise<void>;
+  (fn?: NodeTestCallback): Promise<void>;
+  readonly only: NodeTestFunction;
+  readonly skip: NodeTestFunction;
+  readonly todo: NodeTestFunction;
+  readonly expectFailure?: NodeTestFunction;
+  readonly it?: NodeTestFunction;
+  readonly test?: NodeTestFunction;
+}
+type NodeDoneCallback = (error?: unknown) => void;
+/**
+ * Creates a `node:test` test function that reports LogTape records from failed
+ * test callbacks.
+ *
+ * The returned function preserves Node.js test options and shorthand helpers
+ * such as `test.only()`, `test.skip()`, and `test.todo()`.  Only callback
+ * arguments are adapted; options are passed through to `node:test`.
+ *
+ * @param options Failure log reporter options.
+ * @returns A configured `node:test`-compatible test function.
+ * @since 2.3.0
+ */
+declare function createTest(options?: FailureLogReporterOptions$1): NodeTestFunction;
+/**
+ * Creates an `it()` alias that reports LogTape records from failed test
+ * callbacks.
+ *
+ * @param options Failure log reporter options.
+ * @returns A configured `node:test`-compatible `it()` function.
+ * @since 2.3.0
+ */
+declare function createIt(options?: FailureLogReporterOptions$1): NodeTestFunction;
+/**
+ * A `node:test` test function that reports LogTape records from failed test
+ * callbacks using the default reporter options.
+ *
+ * @since 2.3.0
+ */
+declare const test: NodeTestFunction;
+/**
+ * A `node:test` `it()` alias that reports LogTape records from failed test
+ * callbacks using the default reporter options.
+ *
+ * @since 2.3.0
+ */
+declare const it: NodeTestFunction;
+/**
+ * Shorthand for marking a test as `only`.
+ *
+ * @since 2.3.0
+ */
+declare const only: NodeTestFunction;
+/**
+ * Shorthand for skipping a test.
+ *
+ * @since 2.3.0
+ */
+declare const skip: NodeTestFunction;
+/**
+ * Shorthand for marking a test as TODO.
+ *
+ * @since 2.3.0
+ */
+declare const todo: NodeTestFunction;
+/**
+ * Shorthand for expecting a test to fail when supported by the active Node.js
+ * runtime.
+ *
+ * @since 2.3.0
+ */
+declare const expectFailure: NodeTestFunction | undefined;
+/**
+ * Node.js' test assertion tracker when supported by the active runtime.
+ *
+ * @since 2.3.0
+ */
+declare const assert: unknown;
+/**
+ * Node.js' snapshot helper when supported by the active runtime.
+ *
+ * @since 2.3.0
+ */
+declare const snapshot: unknown;
+//#endregion
+export { FailureLogReportMode, FailureLogReporterOptions, NodeTestCallback, NodeTestFunction, NodeTestOptions, TestContext, after, afterEach, assert, before, beforeEach, createIt, createTest, test as default, test, describe, expectFailure, it, mock, only, run, skip, snapshot, suite, todo };
+//# sourceMappingURL=mod.d.cts.map

package/dist/mod.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.cts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;AAgCA;;;;;AAU+B;AAa/B;;;AAES,UAzBQ,eAAA,CAyBR;EAAgB,SAAA,WAAA,CAAA,EAAA,MAAA,GAAA,OAAA;EAQR,SAAA,aAAgB,CAAA,EAAA,OAAA,GAAA,MAAA,GA5B3B,MA4B2B,GAAA,CAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,GAAA,MAAA,GAzB3B,KAyB2B;EAAA,SAAA,IAAA,CAAA,EAAA,OAAA;EAAA,SACL,MAAA,CAAA,EAxBR,WAwBQ;EAAe,SAAO,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,IAAA,CAAA,EAAA,SAAA,MAAA,EAAA;EAAO,SAGrD,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,OAAA,CAAA,EAAA,MAAA;EAAO,SACpC,IAAA,CAAA,EAAA,MAAA;;;;;;;AAII,KAnBL,gBAAA,GAmBK,CAAA,OAAA,EAlBN,WAkBM,EAAA,IAAA,CAAA,EAjBR,gBAiBQ,EAAA,GAAA,OAAA;;;;AAGiB;AACjC;AAyBe,UAtCC,gBAAA,CAsCS;EAAA,CAAA,IAAA,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EArCE,eAqCF,EAAA,EAAA,CAAA,EArCwB,gBAqCxB,CAAA,EArC2C,OAqC3C,CAAA,IAAA,CAAA;EAAA,CAAA,IACf,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,EAnCY,gBAmCZ,CAAA,EAnC+B,OAmC/B,CAAA,IAAA,CAAA;EAA8B,CAAA,OACtC,CAAA,EAnCU,eAmCV,EAAA,EAAA,CAAA,EAnCgC,gBAmChC,CAAA,EAnCmD,OAmCnD,CAAA,IAAA,CAAA;EAAgB,CAAA,EAAA,CAAA,EAlCX,gBAkCW,CAAA,EAlCQ,OAkCR,CAAA,IAAA,CAAA;EAeH,SAAA,IAAQ,EAhDP,gBAgDO;EAAA,SAAA,IAAA,EA/CP,gBA+CO;EAAA,SACb,IAAA,EA/CM,gBA+CN;EAA8B,SACtC,aAAA,CAAA,EA/CwB,gBA+CxB;EAAgB,SAAA,EAAA,CAAA,EA9CH,gBA8CG;EAaN,SAAqC,IAAA,CAAA,EA1DhC,gBA0DC;AAQnB;AAOA,KAtEK,gBAAA,GAsEc,CAAA,KAA4B,CAA5B,EAAA,OAA4B,EAAA,GAAA,IAAA;AAO/C;AAOA;AAQA;AAOA;AAOA;;;;;;;;iBAnFgB,UAAA,WACL,8BACR;;;;;;;;;iBAea,QAAA,WACL,8BACR;;;;;;;cAaU,MAAM;;;;;;;cAQN,IAAI;;;;;;cAOJ,MAAM;;;;;;cAON,MAAM;;;;;;cAON,MAAM;;;;;;;cAQN,eAAe;;;;;;cAOf;;;;;;cAOA"}

package/dist/mod.d.ts

@@ -0,0 +1,125 @@
+import { TestContext, after, afterEach, before, beforeEach, describe, mock, run, suite } from "node:test";
+import { FailureLogReportMode, FailureLogReporterOptions, FailureLogReporterOptions as FailureLogReporterOptions$1 } from "@logtape/testing/reporter";
+
+//#region src/mod.d.ts
+
+/**
+ * Options accepted by Node.js `test()` and `it()` functions.
+ *
+ * The shape intentionally mirrors Node's documented option bag while allowing
+ * newer Node.js options to pass through even when a runtime's bundled TypeScript
+ * declarations lag behind the current documentation.
+ *
+ * @since 2.3.0
+ */
+interface NodeTestOptions {
+  readonly concurrency?: number | boolean;
+  readonly expectFailure?: boolean | string | RegExp | ((error: unknown) => boolean) | object | Error;
+  readonly only?: boolean;
+  readonly signal?: AbortSignal;
+  readonly skip?: boolean | string;
+  readonly tags?: readonly string[];
+  readonly todo?: boolean | string;
+  readonly timeout?: number;
+  readonly plan?: number;
+}
+/**
+ * A callback passed to Node.js `test()` or `it()`.
+ *
+ * @since 2.3.0
+ */
+type NodeTestCallback = (context: TestContext, done?: NodeDoneCallback) => unknown;
+/**
+ * A Node.js `test()`-compatible function.
+ *
+ * @since 2.3.0
+ */
+interface NodeTestFunction {
+  (name?: string, options?: NodeTestOptions, fn?: NodeTestCallback): Promise<void>;
+  (name?: string, fn?: NodeTestCallback): Promise<void>;
+  (options?: NodeTestOptions, fn?: NodeTestCallback): Promise<void>;
+  (fn?: NodeTestCallback): Promise<void>;
+  readonly only: NodeTestFunction;
+  readonly skip: NodeTestFunction;
+  readonly todo: NodeTestFunction;
+  readonly expectFailure?: NodeTestFunction;
+  readonly it?: NodeTestFunction;
+  readonly test?: NodeTestFunction;
+}
+type NodeDoneCallback = (error?: unknown) => void;
+/**
+ * Creates a `node:test` test function that reports LogTape records from failed
+ * test callbacks.
+ *
+ * The returned function preserves Node.js test options and shorthand helpers
+ * such as `test.only()`, `test.skip()`, and `test.todo()`.  Only callback
+ * arguments are adapted; options are passed through to `node:test`.
+ *
+ * @param options Failure log reporter options.
+ * @returns A configured `node:test`-compatible test function.
+ * @since 2.3.0
+ */
+declare function createTest(options?: FailureLogReporterOptions$1): NodeTestFunction;
+/**
+ * Creates an `it()` alias that reports LogTape records from failed test
+ * callbacks.
+ *
+ * @param options Failure log reporter options.
+ * @returns A configured `node:test`-compatible `it()` function.
+ * @since 2.3.0
+ */
+declare function createIt(options?: FailureLogReporterOptions$1): NodeTestFunction;
+/**
+ * A `node:test` test function that reports LogTape records from failed test
+ * callbacks using the default reporter options.
+ *
+ * @since 2.3.0
+ */
+declare const test: NodeTestFunction;
+/**
+ * A `node:test` `it()` alias that reports LogTape records from failed test
+ * callbacks using the default reporter options.
+ *
+ * @since 2.3.0
+ */
+declare const it: NodeTestFunction;
+/**
+ * Shorthand for marking a test as `only`.
+ *
+ * @since 2.3.0
+ */
+declare const only: NodeTestFunction;
+/**
+ * Shorthand for skipping a test.
+ *
+ * @since 2.3.0
+ */
+declare const skip: NodeTestFunction;
+/**
+ * Shorthand for marking a test as TODO.
+ *
+ * @since 2.3.0
+ */
+declare const todo: NodeTestFunction;
+/**
+ * Shorthand for expecting a test to fail when supported by the active Node.js
+ * runtime.
+ *
+ * @since 2.3.0
+ */
+declare const expectFailure: NodeTestFunction | undefined;
+/**
+ * Node.js' test assertion tracker when supported by the active runtime.
+ *
+ * @since 2.3.0
+ */
+declare const assert: unknown;
+/**
+ * Node.js' snapshot helper when supported by the active runtime.
+ *
+ * @since 2.3.0
+ */
+declare const snapshot: unknown;
+//#endregion
+export { FailureLogReportMode, FailureLogReporterOptions, NodeTestCallback, NodeTestFunction, NodeTestOptions, TestContext, after, afterEach, assert, before, beforeEach, createIt, createTest, test as default, test, describe, expectFailure, it, mock, only, run, skip, snapshot, suite, todo };
+//# sourceMappingURL=mod.d.ts.map

package/dist/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","names":[],"sources":["../src/mod.ts"],"sourcesContent":[],"mappings":";;;;;AAgCA;;;;;AAU+B;AAa/B;;;AAES,UAzBQ,eAAA,CAyBR;EAAgB,SAAA,WAAA,CAAA,EAAA,MAAA,GAAA,OAAA;EAQR,SAAA,aAAgB,CAAA,EAAA,OAAA,GAAA,MAAA,GA5B3B,MA4B2B,GAAA,CAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAAA,OAAA,CAAA,GAAA,MAAA,GAzB3B,KAyB2B;EAAA,SAAA,IAAA,CAAA,EAAA,OAAA;EAAA,SACL,MAAA,CAAA,EAxBR,WAwBQ;EAAe,SAAO,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,IAAA,CAAA,EAAA,SAAA,MAAA,EAAA;EAAO,SAGrD,IAAA,CAAA,EAAA,OAAA,GAAA,MAAA;EAAgB,SAAG,OAAA,CAAA,EAAA,MAAA;EAAO,SACpC,IAAA,CAAA,EAAA,MAAA;;;;;;;AAII,KAnBL,gBAAA,GAmBK,CAAA,OAAA,EAlBN,WAkBM,EAAA,IAAA,CAAA,EAjBR,gBAiBQ,EAAA,GAAA,OAAA;;;;AAGiB;AACjC;AAyBe,UAtCC,gBAAA,CAsCS;EAAA,CAAA,IAAA,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EArCE,eAqCF,EAAA,EAAA,CAAA,EArCwB,gBAqCxB,CAAA,EArC2C,OAqC3C,CAAA,IAAA,CAAA;EAAA,CAAA,IACf,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,EAnCY,gBAmCZ,CAAA,EAnC+B,OAmC/B,CAAA,IAAA,CAAA;EAA8B,CAAA,OACtC,CAAA,EAnCU,eAmCV,EAAA,EAAA,CAAA,EAnCgC,gBAmChC,CAAA,EAnCmD,OAmCnD,CAAA,IAAA,CAAA;EAAgB,CAAA,EAAA,CAAA,EAlCX,gBAkCW,CAAA,EAlCQ,OAkCR,CAAA,IAAA,CAAA;EAeH,SAAA,IAAQ,EAhDP,gBAgDO;EAAA,SAAA,IAAA,EA/CP,gBA+CO;EAAA,SACb,IAAA,EA/CM,gBA+CN;EAA8B,SACtC,aAAA,CAAA,EA/CwB,gBA+CxB;EAAgB,SAAA,EAAA,CAAA,EA9CH,gBA8CG;EAaN,SAAqC,IAAA,CAAA,EA1DhC,gBA0DC;AAQnB;AAOA,KAtEK,gBAAA,GAsEc,CAAA,KAA4B,CAA5B,EAAA,OAA4B,EAAA,GAAA,IAAA;AAO/C;AAOA;AAQA;AAOA;AAOA;;;;;;;;iBAnFgB,UAAA,WACL,8BACR;;;;;;;;;iBAea,QAAA,WACL,8BACR;;;;;;;cAaU,MAAM;;;;;;;cAQN,IAAI;;;;;;cAOJ,MAAM;;;;;;cAON,MAAM;;;;;;cAON,MAAM;;;;;;;cAQN,eAAe;;;;;;cAOf;;;;;;cAOA"}