@noma.to/qwik-testing-library 1.5.1 → 1.6.0

package/README.md

@@ -92,6 +92,7 @@ src="https://raw.githubusercontent.com/ianlet/qwik-testing-library/main/high-vol
 - [Setup](#setup)
 - [Examples](#examples)
     - [Qwikstart](#qwikstart)
+    - [Testing Hooks (experimental)](#testing-hooks-experimental)
     - [Mocking Component Callbacks (experimental)](#mocking-component-callbacks-experimental)
     - [Qwik City - `server$` calls](#qwik-city---server-calls)
 - [Gotchas](#gotchas)
@@ -264,6 +265,109 @@ describe("<Counter />", () => {
 })
 ```
 
+### Testing Hooks (experimental)
+
+> [!WARNING]
+> This feature is under a testing phase and thus experimental.
+> Its API may change in the future, so use it at your own risk.
+
+`renderHook` lets you test custom hooks in isolation, without building a wrapper component by hand.
+This is especially useful for library authors who need to battle-test the hooks they provide to their users.
+
+```tsx
+// use-counter.tsx
+
+import { $, useSignal } from "@builder.io/qwik";
+
+export function useCounter(initial = 0) {
+  const count = useSignal(initial);
+  const increment$ = $(() => count.value++);
+
+  return { count, increment$ };
+}
+```
+
+```tsx
+// use-counter.spec.tsx
+
+import { renderHook } from "@noma.to/qwik-testing-library";
+import { useCounter } from "./use-counter";
+
+describe("useCounter", () => {
+  it("should start at 0", async () => {
+    const { result } = await renderHook(useCounter);
+
+    expect(result.count.value).toBe(0);
+  });
+
+  it("should increment", async () => {
+    const { result } = await renderHook(useCounter);
+
+    await result.increment$();
+
+    expect(result.count.value).toBe(1);
+  });
+});
+```
+
+The `result` is the direct return value of your hook callback. Because Qwik signals are stable reactive
+references, you can read and mutate them directly — no `.current` wrapper needed.
+
+#### ESLint `qwik/use-method-usage`
+
+The Qwik ESLint plugin only allows `use*` calls inside `component$` or `use*`-named functions.
+This is a known limitation — a discussion is in progress with the Qwik team to relax their ESLint rule.
+In the meantime, when you need to pass arguments to your hook, wrap it in a `use*`-named function to stay lint-clean:
+
+```tsx
+// passing the hook by reference — lint-clean
+const { result } = await renderHook(useCounter);
+
+// passing arguments — extract a use*-named function
+function useCounterFrom10() {
+  return useCounter(10);
+}
+const { result } = await renderHook(useCounterFrom10);
+```
+
+#### Providing Context
+
+If your hook depends on context, use the `wrapper` option to provide it:
+
+```tsx
+import { renderHook } from "@noma.to/qwik-testing-library";
+import { component$, createContextId, useContextProvider, useStore, Slot } from "@builder.io/qwik";
+import { useTheme } from "./use-theme";
+
+const ThemeContext = createContextId<{ mode: string }>("theme");
+
+const ThemeProvider = component$(() => {
+  useContextProvider(ThemeContext, useStore({ mode: "dark" }));
+  return <Slot />;
+});
+
+it("should read theme from context", async () => {
+  const { result } = await renderHook(useTheme, {
+    wrapper: ThemeProvider,
+  });
+
+  expect(result.mode).toBe("dark");
+});
+```
+
+#### Cleanup
+
+`renderHook` integrates with automatic cleanup, just like `render`.
+You can also call `unmount()` manually if needed:
+
+```tsx
+const { result, unmount } = await renderHook(useCounter);
+
+// ... assertions ...
+
+unmount();
+```
+
 ### Mocking Component Callbacks (experimental)
 
 > [!WARNING]
@@ -290,7 +394,7 @@ Here's an example on how to use the `mock$` function:
 // import qwik-testing methods
 import {render, screen, waitFor} from "@noma.to/qwik-testing-library";
 // import qwik-mock methods
-import {mock$, clearAllMock} from "@noma.to/qwik-mock";
+import {clearAllMocks, mock$} from "@noma.to/qwik-mock";
 // import the userEvent methods to interact with the DOM
 import {userEvent} from "@testing-library/user-event";
 
@@ -300,9 +404,7 @@ import {Counter} from "./counter";
 // describe the test suite
 describe("<Counter />", () => {
   // initialize a mock
-  // note: the empty callback is required but currently unused
-  const onChangeMock = mock$(() => {
-  });
+  const onChangeMock = mock$();
 
   // setup beforeEach block to run before each test
   beforeEach(() => {
@@ -325,15 +427,25 @@ describe("<Counter />", () => {
       await user.click(decrementBtn);
 
       // assert that the onChange$ callback was called with the right value
-      // note: QRLs are async in Qwik, so we need to resolve them to verify interactions
       await waitFor(() =>
-        expect(onChangeMock.resolve()).resolves.toHaveBeenCalledWith(-1),
+        expect(onChangeMock).toHaveBeenCalledWith(-1),
       );
     });
   });
 })
 ```
 
+You can also provide a default implementation to `mock$`:
+
+```tsx
+const onSubmitMock = mock$(() => "success");
+
+await render(<SubmitForm onSubmit$={onSubmitMock} />);
+await user.click(screen.getByRole("button", { name: "Submit" }));
+
+expect(await screen.findByText("success")).toBeInTheDocument();
+```
+
 ### Qwik City - `server$` calls
 
 If one of your Qwik components uses `server$` calls, your tests might fail with a rather cryptic message (e.g. `QWIK

package/lib/_virtual/_rolldown/runtime.qwik.cjs

@@ -0,0 +1,28 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+//#endregion
+exports.__exportAll = __exportAll;
+exports.__reExport = __reExport;

package/lib/_virtual/_rolldown/runtime.qwik.mjs

@@ -0,0 +1,27 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+//#endregion
+export { __exportAll, __reExport };

package/lib/index.qwik.cjs

@@ -1,12 +1,16 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const qwikTestingLibrary = require("./lib/qwik-testing-library.qwik.cjs");
-const dom = require("@testing-library/dom");
-exports.cleanup = qwikTestingLibrary.cleanup;
-exports.render = qwikTestingLibrary.render;
-Object.keys(dom).forEach((k) => {
-  if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: () => dom[k]
-  });
+require("./_virtual/_rolldown/runtime.qwik.cjs");
+const require_qwik_testing_library = require("./lib/qwik-testing-library.qwik.cjs");
+//#endregion
+exports.cleanup = require_qwik_testing_library.cleanup;
+exports.render = require_qwik_testing_library.render;
+exports.renderHook = require_qwik_testing_library.renderHook;
+var _testing_library_dom = require("@testing-library/dom");
+Object.keys(_testing_library_dom).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _testing_library_dom[k];
+		}
+	});
 });

package/lib/index.qwik.mjs

@@ -1,6 +1,5 @@
-import { cleanup, render } from "./lib/qwik-testing-library.qwik.mjs";
+import "./_virtual/_rolldown/runtime.qwik.mjs";
+import { cleanup, render, renderHook } from "./lib/qwik-testing-library.qwik.mjs";
 export * from "@testing-library/dom";
-export {
-  cleanup,
-  render
-};
+//#endregion
+export { cleanup, render, renderHook };

package/lib/lib/qwik-testing-library.qwik.cjs

@@ -1,106 +1,90 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const jsxRuntime = require("@builder.io/qwik/jsx-runtime");
-const dom = require("@testing-library/dom");
-const server = require("@builder.io/qwik/server");
+require("../_virtual/_rolldown/runtime.qwik.cjs");
+let _testing_library_dom = require("@testing-library/dom");
+let _builder_io_qwik_server = require("@builder.io/qwik/server");
+let _builder_io_qwik_jsx_runtime = require("@builder.io/qwik/jsx-runtime");
+//#region src/lib/qwik-testing-library.tsx
 if (typeof HTMLTemplateElement !== "undefined") {
-  const testTemplate = document.createElement("template");
-  const testNode = document.createComment("test");
-  testTemplate.insertBefore(testNode, null);
-  const needsPatch = testTemplate.childNodes.length === 0;
-  testNode.remove();
-  if (needsPatch) {
-    Object.defineProperty(HTMLTemplateElement.prototype, "childNodes", {
-      get() {
-        return this.content.childNodes;
-      }
-    });
-  }
+	const testTemplate = document.createElement("template");
+	const testNode = document.createComment("test");
+	testTemplate.insertBefore(testNode, null);
+	const needsPatch = testTemplate.childNodes.length === 0;
+	testNode.remove();
+	if (needsPatch) Object.defineProperty(HTMLTemplateElement.prototype, "childNodes", { get() {
+		return this.content.childNodes;
+	} });
 }
 if (typeof process === "undefined" || !process.env?.QTL_SKIP_AUTO_CLEANUP) {
-  if (typeof afterEach === "function") {
-    afterEach(() => {
-      cleanup();
-    });
-  }
+	if (typeof afterEach === "function") afterEach(() => {
+		cleanup();
+	});
 }
-const mountedContainers = /* @__PURE__ */ new Set();
+var mountedContainers = /* @__PURE__ */ new Set();
 async function render(ui, options = {}) {
-  const qwik = await import("@builder.io/qwik");
-  let { container, baseElement = container, wrapper: Wrapper } = options;
-  const { queries, serverData } = options;
-  if (!baseElement) {
-    baseElement = document.body;
-  }
-  if (!container) {
-    container = baseElement.insertBefore(
-      document.createElement("host"),
-      baseElement.firstChild
-    );
-  }
-  const wrappedUi = !Wrapper ? ui : /* @__PURE__ */ jsxRuntime.jsx(Wrapper, { children: ui });
-  const doc = baseElement.ownerDocument;
-  const win = doc.defaultView;
-  new Function("document", "window", server.getQwikLoaderScript())(doc, win);
-  const { cleanup: cleanup2 } = await qwik.render(container, wrappedUi, { serverData });
-  mountedContainers.add({ container, componentCleanup: cleanup2 });
-  return {
-    container,
-    baseElement,
-    asFragment: () => {
-      if (typeof document.createRange === "function") {
-        return document.createRange().createContextualFragment(container.innerHTML);
-      } else {
-        const template = document.createElement("template");
-        template.innerHTML = container.innerHTML;
-        return template.content;
-      }
-    },
-    debug: (el = baseElement, maxLength, options2) => Array.isArray(el) ? el.forEach((e) => console.log(dom.prettyDOM(e, maxLength, options2))) : console.log(
-      dom.prettyDOM(el, maxLength, { ...options2, filterNode: () => true })
-    ),
-    unmount: cleanup2,
-    ...dom.getQueriesForElement(container, queries)
-  };
+	const qwik = await import("@builder.io/qwik");
+	let { container, baseElement = container } = options;
+	const { wrapper: Wrapper } = options;
+	const { queries, serverData } = options;
+	if (!baseElement) baseElement = document.body;
+	if (!container) container = baseElement.insertBefore(document.createElement("host"), baseElement.firstChild);
+	const wrappedUi = !Wrapper ? ui : /* @__PURE__ */ (0, _builder_io_qwik_jsx_runtime.jsx)(Wrapper, { children: ui });
+	const doc = baseElement.ownerDocument;
+	const win = doc.defaultView;
+	new Function("document", "window", (0, _builder_io_qwik_server.getQwikLoaderScript)())(doc, win);
+	const { cleanup } = await qwik.render(container, wrappedUi, { serverData });
+	mountedContainers.add({
+		container,
+		componentCleanup: cleanup
+	});
+	return {
+		container,
+		baseElement,
+		asFragment: () => {
+			if (typeof document.createRange === "function") return document.createRange().createContextualFragment(container.innerHTML);
+			else {
+				const template = document.createElement("template");
+				template.innerHTML = container.innerHTML;
+				return template.content;
+			}
+		},
+		debug: (el = baseElement, maxLength, options) => Array.isArray(el) ? el.forEach((e) => console.log((0, _testing_library_dom.prettyDOM)(e, maxLength, options))) : console.log((0, _testing_library_dom.prettyDOM)(el, maxLength, {
+			...options,
+			filterNode: () => true
+		})),
+		unmount: cleanup,
+		...(0, _testing_library_dom.getQueriesForElement)(container, queries)
+	};
 }
 function cleanupAtContainer(ref) {
-  const { container, componentCleanup } = ref;
-  componentCleanup();
-  if (container?.parentNode === document.body) {
-    document.body.removeChild(container);
-  }
-  mountedContainers.delete(ref);
+	const { container, componentCleanup } = ref;
+	componentCleanup();
+	if (container?.parentNode === document.body) document.body.removeChild(container);
+	mountedContainers.delete(ref);
 }
 function cleanup() {
-  mountedContainers.forEach(cleanupAtContainer);
+	mountedContainers.forEach(cleanupAtContainer);
 }
+async function renderHook(callback, options = {}) {
+	const { component$, noSerialize } = await import("@builder.io/qwik");
+	const callbackRef = noSerialize(callback);
+	const resultRef = noSerialize({ current: void 0 });
+	const { unmount } = await render(/* @__PURE__ */ (0, _builder_io_qwik_jsx_runtime.jsx)(component$(() => {
+		resultRef.current = callbackRef();
+		return /* @__PURE__ */ (0, _builder_io_qwik_jsx_runtime.jsx)(_builder_io_qwik_jsx_runtime.Fragment, {});
+	}), {}), { wrapper: options.wrapper });
+	return {
+		result: resultRef.current,
+		unmount
+	};
+}
+//#endregion
 exports.cleanup = cleanup;
 exports.render = render;
-Object.keys(dom).forEach((k) => {
-  if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
-    enumerable: true,
-    get: () => dom[k]
-  });
+exports.renderHook = renderHook;
+Object.keys(_testing_library_dom).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _testing_library_dom[k];
+		}
+	});
 });

package/lib/lib/qwik-testing-library.qwik.mjs

@@ -1,79 +1,81 @@
-import { jsx } from "@builder.io/qwik/jsx-runtime";
+import "../_virtual/_rolldown/runtime.qwik.mjs";
 import { getQueriesForElement, prettyDOM } from "@testing-library/dom";
-export * from "@testing-library/dom";
 import { getQwikLoaderScript } from "@builder.io/qwik/server";
+import { Fragment, jsx } from "@builder.io/qwik/jsx-runtime";
+export * from "@testing-library/dom";
+//#region src/lib/qwik-testing-library.tsx
 if (typeof HTMLTemplateElement !== "undefined") {
-  const testTemplate = document.createElement("template");
-  const testNode = document.createComment("test");
-  testTemplate.insertBefore(testNode, null);
-  const needsPatch = testTemplate.childNodes.length === 0;
-  testNode.remove();
-  if (needsPatch) {
-    Object.defineProperty(HTMLTemplateElement.prototype, "childNodes", {
-      get() {
-        return this.content.childNodes;
-      }
-    });
-  }
+	const testTemplate = document.createElement("template");
+	const testNode = document.createComment("test");
+	testTemplate.insertBefore(testNode, null);
+	const needsPatch = testTemplate.childNodes.length === 0;
+	testNode.remove();
+	if (needsPatch) Object.defineProperty(HTMLTemplateElement.prototype, "childNodes", { get() {
+		return this.content.childNodes;
+	} });
 }
 if (typeof process === "undefined" || !process.env?.QTL_SKIP_AUTO_CLEANUP) {
-  if (typeof afterEach === "function") {
-    afterEach(() => {
-      cleanup();
-    });
-  }
+	if (typeof afterEach === "function") afterEach(() => {
+		cleanup();
+	});
 }
-const mountedContainers = /* @__PURE__ */ new Set();
+var mountedContainers = /* @__PURE__ */ new Set();
 async function render(ui, options = {}) {
-  const qwik = await import("@builder.io/qwik");
-  let { container, baseElement = container, wrapper: Wrapper } = options;
-  const { queries, serverData } = options;
-  if (!baseElement) {
-    baseElement = document.body;
-  }
-  if (!container) {
-    container = baseElement.insertBefore(
-      document.createElement("host"),
-      baseElement.firstChild
-    );
-  }
-  const wrappedUi = !Wrapper ? ui : /* @__PURE__ */ jsx(Wrapper, { children: ui });
-  const doc = baseElement.ownerDocument;
-  const win = doc.defaultView;
-  new Function("document", "window", getQwikLoaderScript())(doc, win);
-  const { cleanup: cleanup2 } = await qwik.render(container, wrappedUi, { serverData });
-  mountedContainers.add({ container, componentCleanup: cleanup2 });
-  return {
-    container,
-    baseElement,
-    asFragment: () => {
-      if (typeof document.createRange === "function") {
-        return document.createRange().createContextualFragment(container.innerHTML);
-      } else {
-        const template = document.createElement("template");
-        template.innerHTML = container.innerHTML;
-        return template.content;
-      }
-    },
-    debug: (el = baseElement, maxLength, options2) => Array.isArray(el) ? el.forEach((e) => console.log(prettyDOM(e, maxLength, options2))) : console.log(
-      prettyDOM(el, maxLength, { ...options2, filterNode: () => true })
-    ),
-    unmount: cleanup2,
-    ...getQueriesForElement(container, queries)
-  };
+	const qwik = await import("@builder.io/qwik");
+	let { container, baseElement = container } = options;
+	const { wrapper: Wrapper } = options;
+	const { queries, serverData } = options;
+	if (!baseElement) baseElement = document.body;
+	if (!container) container = baseElement.insertBefore(document.createElement("host"), baseElement.firstChild);
+	const wrappedUi = !Wrapper ? ui : /* @__PURE__ */ jsx(Wrapper, { children: ui });
+	const doc = baseElement.ownerDocument;
+	const win = doc.defaultView;
+	new Function("document", "window", getQwikLoaderScript())(doc, win);
+	const { cleanup } = await qwik.render(container, wrappedUi, { serverData });
+	mountedContainers.add({
+		container,
+		componentCleanup: cleanup
+	});
+	return {
+		container,
+		baseElement,
+		asFragment: () => {
+			if (typeof document.createRange === "function") return document.createRange().createContextualFragment(container.innerHTML);
+			else {
+				const template = document.createElement("template");
+				template.innerHTML = container.innerHTML;
+				return template.content;
+			}
+		},
+		debug: (el = baseElement, maxLength, options) => Array.isArray(el) ? el.forEach((e) => console.log(prettyDOM(e, maxLength, options))) : console.log(prettyDOM(el, maxLength, {
+			...options,
+			filterNode: () => true
+		})),
+		unmount: cleanup,
+		...getQueriesForElement(container, queries)
+	};
 }
 function cleanupAtContainer(ref) {
-  const { container, componentCleanup } = ref;
-  componentCleanup();
-  if (container?.parentNode === document.body) {
-    document.body.removeChild(container);
-  }
-  mountedContainers.delete(ref);
+	const { container, componentCleanup } = ref;
+	componentCleanup();
+	if (container?.parentNode === document.body) document.body.removeChild(container);
+	mountedContainers.delete(ref);
 }
 function cleanup() {
-  mountedContainers.forEach(cleanupAtContainer);
+	mountedContainers.forEach(cleanupAtContainer);
+}
+async function renderHook(callback, options = {}) {
+	const { component$, noSerialize } = await import("@builder.io/qwik");
+	const callbackRef = noSerialize(callback);
+	const resultRef = noSerialize({ current: void 0 });
+	const { unmount } = await render(/* @__PURE__ */ jsx(component$(() => {
+		resultRef.current = callbackRef();
+		return /* @__PURE__ */ jsx(Fragment, {});
+	}), {}), { wrapper: options.wrapper });
+	return {
+		result: resultRef.current,
+		unmount
+	};
 }
-export {
-  cleanup,
-  render
-};
+//#endregion
+export { cleanup, render, renderHook };

package/lib/setup.qwik.cjs

@@ -1,8 +1,9 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/setup.ts
 globalThis.qTest = false;
 globalThis.qRuntimeQrl = true;
 globalThis.qDev = true;
 globalThis.qInspector = false;
-const __qwikSetupComplete = true;
+var __qwikSetupComplete = true;
+//#endregion
 exports.__qwikSetupComplete = __qwikSetupComplete;

package/lib/setup.qwik.mjs

@@ -1,8 +1,8 @@
+//#region src/setup.ts
 globalThis.qTest = false;
 globalThis.qRuntimeQrl = true;
 globalThis.qDev = true;
 globalThis.qInspector = false;
-const __qwikSetupComplete = true;
-export {
-  __qwikSetupComplete
-};
+var __qwikSetupComplete = true;
+//#endregion
+export { __qwikSetupComplete };

package/lib-types/lib/qwik-testing-library.d.ts

@@ -1,6 +1,7 @@
 import type { JSXOutput } from "@builder.io/qwik";
-import type { Options, Result } from "./types";
-declare function render(ui: JSXOutput, options?: Options): Promise<Result>;
+import type { RenderOptions, RenderHookOptions, RenderHookResult, Result } from "./types";
+declare function render(ui: JSXOutput, options?: RenderOptions): Promise<Result>;
 declare function cleanup(): void;
+declare function renderHook<Result>(callback: () => Result, options?: RenderHookOptions): Promise<RenderHookResult<Result>>;
 export * from "@testing-library/dom";
-export { cleanup, render };
+export { cleanup, render, renderHook };

package/lib-types/lib/types.d.ts

@@ -1,7 +1,7 @@
 import type { BoundFunctions, prettyFormat, Queries } from "@testing-library/dom";
 import { queries } from "@testing-library/dom";
-import type { Component, RenderOptions } from "@builder.io/qwik";
-export interface Options extends RenderOptions {
+import type { Component, RenderOptions as QwikRenderOptions } from "@builder.io/qwik";
+export interface RenderOptions extends QwikRenderOptions {
     container?: HTMLElement;
     baseElement?: HTMLElement;
     queries?: Queries & typeof queries;
@@ -19,3 +19,8 @@ export type ComponentRef = {
     container: HTMLElement;
     componentCleanup: () => void;
 };
+export type RenderHookOptions = Pick<RenderOptions, 'wrapper'>;
+export interface RenderHookResult<Result> {
+    result: Result;
+    unmount: () => void;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noma.to/qwik-testing-library",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "description": "Simple and complete Qwik testing utilities that encourage good testing practices.",
   "repository": "https://github.com/ianlet/qwik-testing-library",
   "homepage": "https://github.com/ianlet/qwik-testing-library",
@@ -39,18 +39,18 @@
     "validate": "pnpm build"
   },
   "devDependencies": {
-    "@types/eslint": "8.56.10",
-    "@types/node": "25.1.0",
-    "@typescript-eslint/eslint-plugin": "8.54.0",
-    "@typescript-eslint/parser": "8.54.0",
-    "eslint": "8.57.1",
-    "eslint-plugin-qwik": "1.19.0",
-    "prettier": "3.8.1",
-    "typescript": "5.9.3",
+    "@eslint/js": "10",
+    "@types/node": "25.6.0",
+    "eslint": "10",
+    "eslint-plugin-qwik": "1.19.2",
+    "globals": "^17.4.0",
+    "prettier": "3.8.2",
+    "typescript": "6.0.2",
+    "typescript-eslint": "^8.58.1",
     "undici": "*",
-    "vite": "7.3.1",
-    "vite-tsconfig-paths": "^6.0.5",
-    "vitest": "^4.0.18"
+    "vite": "8.0.8",
+    "vite-tsconfig-paths": "^6.1.1",
+    "vitest": "^4.1.4"
   },
   "peerDependencies": {
     "@builder.io/qwik": ">= 1.12.0 < 2",