twd-js 1.1.2 → 1.2.1

package/dist/runner.es.js

@@ -1,121 +1,178 @@
-const r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Map(), a = [], h = () => Math.random().toString(36).substr(2, 9), p = (o, t) => {
-  const s = h(), e = a.at(-1);
-  r.set(s, {
-    id: s,
-    name: o,
+const r = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), h = /* @__PURE__ */ new Map(), o = [], p = () => Math.random().toString(36).substr(2, 9), d = (s, t) => {
+  const e = p(), n = o.at(-1);
+  r.set(e, {
+    id: e,
+    name: s,
     type: "suite",
     children: [],
     logs: [],
-    depth: a.length,
-    parent: e,
+    depth: o.length,
+    parent: n,
     handler: t
-  }), e && r.get(e).children.push(s), a.push(s), t(), a.pop();
-}, l = (o, t) => {
-  const s = h(), e = a.at(-1), n = {
-    id: s,
-    name: o,
+  }), n && r.get(n).children.push(e), o.push(e), t(), o.pop();
+};
+d.only = (s, t) => {
+  const e = p(), n = o.at(-1);
+  r.set(e, {
+    id: e,
+    name: s,
+    type: "suite",
+    children: [],
+    logs: [],
+    depth: o.length,
+    parent: n,
+    handler: t,
+    only: !0
+  }), n && r.get(n).children.push(e), o.push(e), t(), o.pop();
+};
+d.skip = (s, t) => {
+  const e = p(), n = o.at(-1);
+  r.set(e, {
+    id: e,
+    name: s,
+    type: "suite",
+    children: [],
+    logs: [],
+    depth: o.length,
+    parent: n,
+    handler: t,
+    skip: !0
+  }), n && r.get(n).children.push(e), o.push(e), t(), o.pop();
+};
+const g = (s, t) => {
+  const e = p(), n = o.at(-1), i = {
+    id: e,
+    name: s,
     type: "test",
-    depth: a.length,
+    depth: o.length,
     handler: t,
     logs: [],
-    parent: e
+    parent: n
   };
-  e && r.get(e).children.push(s), r.set(s, n);
+  n && r.get(n).children.push(e), r.set(e, i);
 };
-l.only = (o, t) => {
-  const s = h(), e = a.at(-1), n = {
-    id: s,
-    name: o,
+g.only = (s, t) => {
+  const e = p(), n = o.at(-1), i = {
+    id: e,
+    name: s,
     type: "test",
-    depth: a.length,
+    depth: o.length,
     handler: t,
     logs: [],
-    parent: e,
+    parent: n,
     only: !0
   };
-  e && r.get(e).children.push(s), r.set(s, n);
+  n && r.get(n).children.push(e), r.set(e, i);
 };
-l.skip = (o, t) => {
-  const s = h(), e = a.at(-1), n = {
-    id: s,
-    name: o,
+g.skip = (s, t) => {
+  const e = p(), n = o.at(-1), i = {
+    id: e,
+    name: s,
     type: "test",
-    depth: a.length,
+    depth: o.length,
     handler: t || (() => {
     }),
     logs: [],
-    parent: e,
+    parent: n,
     skip: !0
   };
-  e && r.get(e).children.push(s), r.set(s, n);
+  n && r.get(n).children.push(e), r.set(e, i);
 };
-const d = (o) => {
-  const t = a.at(-1);
+const w = (s) => {
+  const t = o.at(-1);
   if (!t) throw new Error("beforeEach() must be inside a describe()");
-  i.has(t) || i.set(t, []), i.get(t).push(o);
-}, g = (o) => {
-  const t = a.at(-1);
+  a.has(t) || a.set(t, []), a.get(t).push(s);
+}, b = (s) => {
+  const t = o.at(-1);
   if (!t) throw new Error("afterEach() must be inside a describe()");
-  c.has(t) || c.set(t, []), c.get(t).push(o);
-}, u = (o) => {
-  const t = [], s = [];
-  let e = o;
-  for (; e; )
-    i.has(e) && t.unshift(...i.get(e)), c.has(e) && s.push(...c.get(e)), e = r.get(e)?.parent;
-  return { before: t, after: s };
-}, y = () => {
-  r.clear(), i.clear(), c.clear();
+  h.has(t) || h.set(t, []), h.get(t).push(s);
+}, y = (s) => {
+  const t = [], e = [];
+  let n = s;
+  for (; n; )
+    a.has(n) && t.unshift(...a.get(n)), h.has(n) && e.push(...h.get(n)), n = r.get(n)?.parent;
+  return { before: t, after: e };
+}, u = (s) => {
+  const t = r.get(s);
+  return t ? t.only ? !0 : t.children ? t.children.some((e) => u(e)) : !1 : !1;
+}, k = (s) => {
+  let t = r.get(s);
+  for (; t?.parent; ) {
+    const e = r.get(t.parent);
+    if (e?.only) return !0;
+    t = e;
+  }
+  return !1;
+}, f = (s) => {
+  let t = r.get(s);
+  for (; t; ) {
+    if (t.skip) return !0;
+    if (!t.parent) break;
+    t = r.get(t.parent);
+  }
+  return !1;
+}, v = () => {
+  r.clear(), a.clear(), h.clear();
 };
-class f {
+class S {
   events;
   constructor(t) {
     this.events = t;
   }
   async runAll() {
     const t = Array.from(r.values()).filter(
-      (e) => !e.parent && e.type === "suite"
-    ), s = Array.from(r.values()).some((e) => e.only);
-    for (const e of t)
-      await this.runSuite(e, s);
+      (n) => !n.parent && n.type === "suite"
+    ), e = Array.from(r.values()).some((n) => n.only);
+    for (const n of t)
+      await this.runSuite(n, e);
     return r;
   }
   async runSingle(t) {
-    const s = r.get(t);
-    if (!s || s.type !== "test") return;
-    await this.runTest(s, !1);
+    const e = r.get(t);
+    if (!e || e.type !== "test") return;
+    await this.runTest(e, !1);
   }
-  async runSuite(t, s) {
+  async runSuite(t, e) {
+    if (f(t.id) && !u(t.id)) {
+      this.events.onSkip?.(t);
+      return;
+    }
+    if (e && !u(t.id)) return;
     this.events.onSuiteStart?.(t);
-    const e = (t.children || []).map((n) => r.get(n));
-    for (const n of e)
-      n.type === "suite" ? await this.runSuite(n, s) : n.type === "test" && await this.runTest(n, s);
+    const i = (t.children || []).map((c) => r.get(c));
+    for (const c of i)
+      c.type === "suite" ? await this.runSuite(c, e) : c.type === "test" && await this.runTest(c, e);
     this.events.onSuiteEnd?.(t);
   }
-  async runTest(t, s) {
-    if (t.skip) {
+  async runTest(t, e) {
+    if ((f(t.id) || t.skip) && !t.only) {
+      this.events.onSkip(t);
+      return;
+    }
+    const i = k(t.id);
+    if (e && !t.only && !i) {
       this.events.onSkip(t);
       return;
     }
-    if (s && !t.only) return;
     this.events.onStart?.(t);
-    const e = u(t.parent);
+    const c = y(t.parent);
     try {
-      for (const n of e.before) await n();
+      for (const l of c.before) await l();
       t.logs = [], await t.handler(), this.events.onPass(t);
-    } catch (n) {
-      this.events.onFail(t, n);
+    } catch (l) {
+      this.events.onFail(t, l);
     } finally {
-      for (const n of e.after) await n();
+      for (const l of c.after) await l();
     }
   }
 }
-window.__testRunner = f;
+window.__testRunner = S;
 export {
-  f as TestRunner,
-  g as afterEach,
-  d as beforeEach,
-  y as clearTests,
-  p as describe,
+  S as TestRunner,
+  b as afterEach,
+  w as beforeEach,
+  v as clearTests,
+  d as describe,
   r as handlers,
-  l as it
+  g as it
 };

package/dist/ui.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./jsx-runtime-DN5DOl8k.js");function r({name:n,children:o}){const e=t.getMockForComponent(n);return e?t.jsxRuntimeExports.jsx(e,{...o.props}):o}exports.MockedComponent=r;

package/dist/ui.d.ts

@@ -0,0 +1,10 @@
+import { JSX } from 'react/jsx-runtime';
+
+export declare function MockedComponent<TProps extends Record<string, any>>({ name, children, }: MockedComponentProps<TProps>): JSX.Element;
+
+declare interface MockedComponentProps<TProps = any> {
+    name: string;
+    children: React.ReactElement<TProps>;
+}
+
+export { }

package/dist/ui.es.js

@@ -0,0 +1,11 @@
+import { g as r, j as e } from "./jsx-runtime-CtyxV31n.mjs";
+function s({
+  name: n,
+  children: o
+}) {
+  const t = r(n);
+  return t ? /* @__PURE__ */ e.jsx(t, { ...o.props }) : o;
+}
+export {
+  s as MockedComponent
+};

package/dist/vite-plugin.d.ts

@@ -1 +1,21 @@
-export { removeMockServiceWorker } from './plugin/removeMockServiceWorker';
+import { Plugin as Plugin_2 } from 'vite';
+
+/**
+ * Vite plugin to remove the mock service worker file from the build output.
+ * This is useful for production builds where you don't want the mock service worker to be included.
+ *
+ * @example
+ * ```ts
+ * import { removeMockServiceWorker } from 'twd-js';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     // ... other plugins
+ *     removeMockServiceWorker()
+ *   ]
+ * });
+ * ```
+ */
+export declare function removeMockServiceWorker(): Plugin_2;
+
+export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twd-js",
-  "version": "1.1.2",
+  "version": "1.2.1",
   "description": "Test While Developing (TWD) - in-browser testing",
   "license": "MIT",
   "author": "BRIKEV",
@@ -38,6 +38,11 @@
       "types": "./dist/runner-ci.d.ts",
       "import": "./dist/runner-ci.es.js",
       "require": "./dist/runner-ci.cjs.js"
+    },
+    "./ui": {
+      "types": "./dist/ui.d.ts",
+      "import": "./dist/ui.es.js",
+      "require": "./dist/ui.cjs.js"
     }
   },
   "files": [
@@ -65,18 +70,17 @@
   "devDependencies": {
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.0",
-    "@types/chai": "^5.2.3",
-    "@types/react": "^19.2.3",
-    "@types/react-dom": "^19.2.2",
-    "@vitejs/plugin-react": "^5.1.0",
-    "@vitest/coverage-v8": "^4.0.8",
+    "@types/react": "^19.2.6",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "@vitest/coverage-v8": "^4.0.13",
     "conventional-changelog": "^7.1.1",
-    "jsdom": "^27.1.0",
+    "jsdom": "^27.2.0",
     "typescript": "^5.9.3",
-    "vite": "^7.2.2",
+    "vite": "^7.2.4",
     "vite-plugin-dts": "^4.5.4",
     "vitepress": "^2.0.0-alpha.12",
-    "vitest": "^4.0.8"
+    "vitest": "^4.0.13"
   },
   "keywords": [
     "testing",
@@ -91,7 +95,8 @@
   "dependencies": {
     "@testing-library/dom": "^10.4.1",
     "@testing-library/user-event": "^14.6.1",
+    "@types/chai": "^5.2.3",
     "chai": "^6.2.1",
-    "chalk": "^5.6.2"
+    "picocolors": "^1.1.1"
   }
 }

package/dist/asserts/index.d.ts

@@ -1,2 +0,0 @@
-import { AnyAssertion } from '../twd-types';
-export declare const runAssertion: (el: Element, name: AnyAssertion, ...args: any[]) => string;

package/dist/commands/mockBridge.d.ts

@@ -1,73 +0,0 @@
-export type Rule = {
-    method: string;
-    url: string | RegExp;
-    response: unknown;
-    alias: string;
-    executed?: boolean;
-    request?: any;
-    status?: number;
-    responseHeaders?: Record<string, string>;
-    urlRegex?: boolean;
-};
-export interface Options {
-    method: string;
-    url: string | RegExp;
-    response: unknown;
-    status?: number;
-    responseHeaders?: Record<string, string>;
-    urlRegex?: boolean;
-}
-/**
- * Initialize the mocking service worker.
- * Call this once before using `mockRequest` or `waitFor`.
- */
-export declare const initRequestMocking: () => Promise<void>;
-/**
- * Mock a network request.
- *
- * @param alias Identifier for the mock rule. Useful for `waitFor()`.
- * @param options Options to configure the mock:
- *  - `method`: HTTP method ("GET", "POST", …)
- *  - `url`: URL string or RegExp to match
- *  - `response`: Body of the mocked response
- *  - `status`: (optional) HTTP status code (default: 200)
- *  - `responseHeaders`: (optional) Response headers
- *  - `urlRegex`: (optional) Whether the URL is a regex (default: false)
- *
- * @example
- * ```ts
- * mockRequest("getUser", {
- *   method: "GET",
- *   url: /\/api\/user\/\d+/,
- *   response: { id: 1, name: "Kevin" },
- *   status: 200,
- *   headers: { "x-mock": "true" }
- * });
- * ```
- */
-export declare const mockRequest: (alias: string, options: Options) => Promise<void>;
-/**
- * wait for a list of mocked requests to be made.
- * @param aliases The aliases of the mock rules to wait for
- * @returns The matched rules (with body if applicable)
- * @example
- * ```ts
- * await waitForRequests(["getUser", "postComment"]);
- * ```
- */
-export declare const waitForRequests: (aliases: string[]) => Promise<Rule[]>;
-/**
- * Wait for a mocked request to be made.
- * @param alias The alias of the mock rule to wait for
- * @returns The matched rule (with body if applicable)
- */
-export declare const waitForRequest: (alias: string) => Promise<Rule>;
-/**
- * Get the current list of request mock rules.
- * @returns The current list of request mock rules.
- */
-export declare const getRequestMockRules: () => Rule[];
-/**
- * Clear all request mock rules.
- */
-export declare const clearRequestMockRules: () => void;

package/dist/commands/url.d.ts

@@ -1,33 +0,0 @@
-/**
- * All supported assertion names for the `should` function in url command
- *
- * @example
- * twd.url().should("contain.url", "/new-page");
- * twd.url().should("eq", "http://localhost:3000/new-page");
- */
-export type URLAssertionName = "eq" | "contain.url";
-/**
- * Negatable assertion names (e.g., 'not.have.text').
- */
-export type Negatable<T extends string> = T | `not.${T}`;
-/**
- * All assertion names, including negated ones.
- */
-export type AnyURLAssertion = Negatable<URLAssertionName>;
-export type URLCommandAPI = {
-    location: Location;
-    should: (name: AnyURLAssertion, value: string) => URLCommandAPI | string;
-};
-/**
- * Argument types for each assertion.
- */
-export type URLAssertionArgs = {
-    (name: "contain.url", urlPart: string): URLCommandAPI;
-    (name: "not.contain.url", urlPart: string): URLCommandAPI;
-};
-/**
- * URL command for assertions on the current URL.
- * @returns URLCommandAPI
- */
-declare const urlCommand: () => URLCommandAPI;
-export default urlCommand;

package/dist/commands/visit.d.ts

@@ -1 +0,0 @@
-export declare const visit: (url: string, reload?: boolean) => Promise<void>;

package/dist/constants/version.d.ts

@@ -1 +0,0 @@
-export declare const TWD_VERSION = "1.1.2";

package/dist/global.d.ts

@@ -1,8 +0,0 @@
-// global.d.ts
-export {};
-
-declare global {
-  interface Window {
-    __testRunner?: TestRunner;
-  }
-}

package/dist/initializers/initSidebar.d.ts

@@ -1,22 +0,0 @@
-interface Options {
-    Component: React.ReactNode;
-    createRoot: (el: HTMLElement) => {
-        render: (el: React.ReactNode) => void;
-    };
-}
-/**
- * Initialize the TWD sidebar.
- * @param options - Options for initializing the sidebar.
- * @example
- * ```ts
- * import { initSidebar } from 'twd-js';
- *
- * // Initialize the sidebar (e.g., in your main app file)
- * initSidebar({
- *   Component: <TWDSidebar open={true} position="left" />,
- *   createRoot,
- * });
- * ```
- */
-export declare const initSidebar: (options: Options) => void;
-export {};

package/dist/initializers/initTests.d.ts

@@ -1,31 +0,0 @@
-/**
- * A record of test module paths to their loader functions.
- * Each function returns a promise that resolves when the module is loaded.
- * This is typically used with Vite's `import.meta.glob` to dynamically import test modules.
- * @example
- * ```ts
- * const testModules = {
- *   './test1.twd.test.ts': () => import('./test1.twd.test.ts'),
- *   './test2.twd.test.ts': () => import('./test2.twd.test.ts'),
- * };
- * ```
- */
-type TestModule = Record<string, () => Promise<unknown>>;
-/**
- * Initialize Vite test loading.
- * @param testModules - The test modules to load.
- * @param component - The React component to render the sidebar.
- * @param createRoot - Function to create a React root.
- * @example
- * ```ts
- * if (import.meta.env.DEV) {
- *   const testModules = import.meta.glob("./example.twd.test.ts");
- *   const { initTests, TWDSidebar } = await import('twd-js');
- *   await initTests(testModules, <TWDSidebar open={true} position="left" />, createRoot);
- * }
- * ```
- */
-export declare const initTests: (testModules: TestModule, Component: React.ReactNode, createRoot: (el: HTMLElement) => {
-    render: (el: React.ReactNode) => void;
-}) => Promise<void>;
-export {};

package/dist/plugin/removeMockServiceWorker.d.ts

@@ -1,18 +0,0 @@
-import { Plugin } from 'vite';
-/**
- * Vite plugin to remove the mock service worker file from the build output.
- * This is useful for production builds where you don't want the mock service worker to be included.
- *
- * @example
- * ```ts
- * import { removeMockServiceWorker } from 'twd-js';
- *
- * export default defineConfig({
- *   plugins: [
- *     // ... other plugins
- *     removeMockServiceWorker()
- *   ]
- * });
- * ```
- */
-export declare function removeMockServiceWorker(): Plugin;

package/dist/proxies/domMessage.d.ts

@@ -1 +0,0 @@
-export declare function domMessage(prefix: string, prop: PropertyKey, args: any[]): string;

package/dist/proxies/eventsMessage.d.ts

@@ -1 +0,0 @@
-export declare function eventsMessage(prefix: string, prop: PropertyKey, args: any[]): string;

package/dist/proxies/screenDom.d.ts

@@ -1,5 +0,0 @@
-import { screen, configure } from '@testing-library/dom';
-type ScreenDom = typeof screen;
-export declare const screenDom: ScreenDom;
-export declare const configureScreenDom: typeof configure;
-export {};

package/dist/proxies/userEvent.d.ts

@@ -1,4 +0,0 @@
-import { default as userEventLib } from '@testing-library/user-event';
-type UserEvent = typeof userEventLib;
-export declare const userEvent: UserEvent;
-export {};