@noma.to/qwik-mock 1.0.2 → 1.1.0

package/lib/lib/qwik-mock.cjs

@@ -2,10 +2,28 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const qwik = require("@builder.io/qwik");
 const vi_2VT5v0um = require("../node_modules/.pnpm/vitest@4.0.18_@types_node@25.1.0_@vitest_ui@4.0.18_happy-dom@20.0.11_jiti@2.4.2_jsdom@26.1.0__pd2l5poczrcnqygjcqiguyknnm/node_modules/vitest/dist/chunks/vi.2VT5v0um.cjs");
-const mockQrl = (_callbackQrl) => {
-  return qwik.$(vi_2VT5v0um.v.fn());
-};
-const mock$ = qwik.implicit$FirstArg(mockQrl);
+function mockQrl(implQrl) {
+  const mockFn = vi_2VT5v0um.v.fn(implQrl?.resolved);
+  if (implQrl && !mockFn.getMockImplementation()) {
+    implQrl.resolve().then((impl) => mockFn.mockImplementation(impl));
+  }
+  const qrl = qwik.$(mockFn);
+  return new Proxy(qrl, {
+    get(target, prop, receiver) {
+      if (!(prop in target) && prop in mockFn) {
+        const value = mockFn[prop];
+        return typeof value === "function" ? value.bind(mockFn) : value;
+      }
+      return Reflect.get(target, prop, receiver);
+    },
+    has(target, prop) {
+      return Reflect.has(target, prop) || Reflect.has(mockFn, prop);
+    }
+  });
+}
+function mock$(impl) {
+  return mockQrl(impl ? qwik.$(impl) : void 0);
+}
 function clearAllMocks() {
   vi_2VT5v0um.v.clearAllMocks();
 }

package/lib/lib/qwik-mock.mjs

@@ -1,9 +1,27 @@
-import { implicit$FirstArg, $ } from "@builder.io/qwik";
+import { $ } from "@builder.io/qwik";
 import { v as vi } from "../node_modules/.pnpm/vitest@4.0.18_@types_node@25.1.0_@vitest_ui@4.0.18_happy-dom@20.0.11_jiti@2.4.2_jsdom@26.1.0__pd2l5poczrcnqygjcqiguyknnm/node_modules/vitest/dist/chunks/vi.2VT5v0um.mjs";
-const mockQrl = (_callbackQrl) => {
-  return $(vi.fn());
-};
-const mock$ = implicit$FirstArg(mockQrl);
+function mockQrl(implQrl) {
+  const mockFn = vi.fn(implQrl?.resolved);
+  if (implQrl && !mockFn.getMockImplementation()) {
+    implQrl.resolve().then((impl) => mockFn.mockImplementation(impl));
+  }
+  const qrl = $(mockFn);
+  return new Proxy(qrl, {
+    get(target, prop, receiver) {
+      if (!(prop in target) && prop in mockFn) {
+        const value = mockFn[prop];
+        return typeof value === "function" ? value.bind(mockFn) : value;
+      }
+      return Reflect.get(target, prop, receiver);
+    },
+    has(target, prop) {
+      return Reflect.has(target, prop) || Reflect.has(mockFn, prop);
+    }
+  });
+}
+function mock$(impl) {
+  return mockQrl(impl ? $(impl) : void 0);
+}
 function clearAllMocks() {
   vi.clearAllMocks();
 }

package/lib-types/index.d.ts

@@ -1 +1,2 @@
-export * from "./lib/qwik-mock";
+export { clearAllMocks, mock$, mockQrl } from "./lib/qwik-mock";
+export type { QrlMock } from "./lib/qwik-mock";

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

@@ -1,35 +1,37 @@
 import { type QRL } from "@builder.io/qwik";
 import { type Mock } from "vitest";
+/**
+ * A mock that can be passed as a component callback prop (`onClick$`, `onChange$`, etc.)
+ * and asserted on directly with `expect()`.
+ */
+export type QrlMock<T extends (...args: any[]) => any = (...args: any[]) => any> = QRL<T> & Mock<T>;
+/** @internal Called by the Qwik optimizer — use {@link mock$} instead. */
+export declare function mockQrl<T extends (...args: any[]) => any = (...args: any[]) => any>(implQrl?: QRL<T>): QrlMock<T>;
 /**
  * @experimental
  *
- * Create a QRL mock that can be used in tests to verify interactions.
+ * Create a mock for a component callback prop (`onClick$`, `onChange$`, etc.).
+ *
+ * Pass it to a component like any other `$` prop, then assert on it directly —
+ * no need to resolve.
  *
- * As Qwik is an async framework, you need to `resolve()` the mock before making your verifications.
- * And remember to clear the mocks before each test to start with a clean slate!
+ * @param impl - Optional implementation function for the mock.
  *
  * @example
  * ```tsx
- * describe('<MyButton />', () => {
- *   beforeEach(() => {
- *     clearAllMocks();
- *   });
+ * const onClickMock = mock$();
+ * await render(<MyButton onClick$={onClickMock} />);
  *
- *   it('should call onClick$', async () => {
- *     const onClickMock = mock$();
- *     await render(<MyButton onClick$={onClickMock} />);
+ * await userEvent.click(screen.getByRole('button'));
  *
- *     await userEvent.click(screen.getByRole('button'));
- *
- *     await waitFor(() => expect(onClickMock.resolve()).resolves.toHaveBeenCalled());
- *   });
- * });
+ * await waitFor(() => expect(onClickMock).toHaveBeenCalled());
  * ```
  */
-export declare const mockQrl: (_callbackQrl: QRL<(...args: any[]) => any>) => QRL<Mock>;
-export declare const mock$: (qrl: (...args: any[]) => any) => QRL<Mock>;
+export declare function mock$<T extends (...args: any[]) => any = (...args: any[]) => any>(impl?: T): QrlMock<T>;
 /**
- * Will call `.mockClear()` on all spies. This will clear mock history, but not reset its implementation to the
- * default one.
+ * Clear mock history on all mocks created with {@link mock$}.
+ * Does not reset their implementation.
+ *
+ * Typically called in `beforeEach` to start each test with a clean slate.
  */
 export declare function clearAllMocks(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noma.to/qwik-mock",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Small utility to mock Qwik QRLs",
   "repository": "https://github.com/ianlet/qwik-testing-library",
   "homepage": "https://github.com/ianlet/qwik-testing-library",