twd-js 1.6.3 → 1.6.4

package/dist/bundled.es.js

@@ -1134,7 +1134,7 @@ var Pt = (e) => {
   }
 };
 window.__testRunner = Ze;
-var me = "1.6.3", Ot = () => typeof window < "u" ? (window.__TWD_MOCK_STATE__ || (window.__TWD_MOCK_STATE__ = {
+var me = "1.6.4", Ot = () => typeof window < "u" ? (window.__TWD_MOCK_STATE__ || (window.__TWD_MOCK_STATE__ = {
   rules: [],
   counts: {}
 }), window.__TWD_MOCK_STATE__) : {

package/dist/index.cjs.js

@@ -1,4 +1,4 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var ql=Object.create,lr=Object.defineProperty,Rl=Object.getOwnPropertyDescriptor,Tl=Object.getOwnPropertyNames,Sl=Object.getPrototypeOf,xl=Object.prototype.hasOwnProperty,P=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),Ol=(e,t)=>{let r={};for(var n in e)lr(r,n,{get:e[n],enumerable:!0});return t||lr(r,Symbol.toStringTag,{value:"Module"}),r},Ml=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(var a=Tl(t),o=0,i=a.length,s;o<i;o++)s=a[o],!xl.call(e,s)&&s!==r&&lr(e,s,{get:(u=>t[u]).bind(null,s),enumerable:!(n=Rl(t,s))||n.enumerable});return e},In=(e,t,r)=>(r=e!=null?ql(Sl(e)):{},Ml(t||!e||!e.__esModule?lr(r,"default",{value:e,enumerable:!0}):r,e));const Mt=require("./runner-Dr_mUWED.cjs"),tn=require("./componentMocks-CwMyWCu5.cjs");let re=require("react"),j=require("react/jsx-runtime");var Al=(e,t,r=2e3,n=50)=>new Promise((a,o)=>{const i=Date.now(),s=()=>{const u=t();if(u)return a(u);if(Date.now()-i>r)return o(new Error(`Timeout waiting for element ${e}`));setTimeout(s,n)};s()}),Il=(e,t,r=2e3,n=50)=>new Promise((a,o)=>{const i=Date.now(),s=()=>{const u=t();if(u&&u.length>0)return a(Array.from(u));if(Date.now()-i>r)return o(new Error(`Timeout waiting for elements ${e}`));setTimeout(s,n)};s()}),ur=e=>new Promise(t=>setTimeout(t,e)),rn=(e,t,r,n)=>{if(!e&&!t)throw new Error(n);if(e&&t)throw new Error(n.replace("to be","to not be").replace("to have","to not have").replace("to contain","to not contain"));return r};function Nl(e){if(!e.isConnected)return!1;let t=e;for(;t;){const r=getComputedStyle(t);if(r.display==="none"||r.visibility==="hidden"||r.visibility==="collapse")return!1;t=t.parentElement}return!0}var kl={"have.text":{positive:{pass:e=>`Assertion passed: Text is exactly "${e[0]}"`,fail:(e,t)=>`Assertion failed: Expected text to be "${e[0]}", but got "${t}"`},negative:{pass:e=>`Assertion passed: Text is not exactly "${e[0]}"`,fail:(e,t)=>`Assertion failed: Expected text to not be "${e[0]}", but got "${t}"`}},"contain.text":{positive:{pass:e=>`Assertion passed: Text contains "${e[0]}"`,fail:(e,t)=>`Assertion failed: Expected text to contain "${e[0]}", but got "${t}"`},negative:{pass:e=>`Assertion passed: Text does not contain "${e[0]}"`,fail:(e,t)=>`Assertion failed: Expected text to not contain "${e[0]}", but got "${t}"`}},"be.empty":{positive:{pass:()=>"Assertion passed: Text is empty",fail:(e,t)=>`Assertion failed: Expected text to be empty, but got "${t}"`},negative:{pass:()=>"Assertion passed: Text is not empty",fail:(e,t)=>`Assertion failed: Expected text to not be empty, but got "${t}"`}},"have.attr":{positive:{pass:e=>`Assertion passed: Attribute "${e[0]}" is "${e[1]}"`,fail:(e,t)=>`Assertion failed: Expected attribute "${e[0]}" to be "${e[1]}", but got "${t}"`},negative:{pass:e=>`Assertion passed: Attribute "${e[0]}" is not "${e[1]}"`,fail:(e,t)=>`Assertion failed: Expected attribute "${e[0]}" to not be "${e[1]}", but got "${t}"`}},"have.value":{positive:{pass:e=>`Assertion passed: Value is "${e[0]}"`,fail:(e,t)=>`Assertion failed: Expected value to be "${e[0]}", but got "${t}"`},negative:{pass:e=>`Assertion passed: Value is not "${e[0]}"`,fail:(e,t)=>`Assertion failed: Expected value to not be "${e[0]}", but got "${t}"`}},"be.disabled":{positive:{pass:()=>"Assertion passed: Element is disabled",fail:()=>"Assertion failed: Expected element to be disabled"},negative:{pass:()=>"Assertion passed: Element is not disabled",fail:()=>"Assertion failed: Expected element to not be disabled"}},"be.enabled":{positive:{pass:()=>"Assertion passed: Element is enabled",fail:()=>"Assertion failed: Expected element to be enabled"},negative:{pass:()=>"Assertion passed: Element is not enabled",fail:()=>"Assertion failed: Expected element to not be enabled"}},"be.checked":{positive:{pass:()=>"Assertion passed: Element is checked",fail:()=>"Assertion failed: Expected element to be checked"},negative:{pass:()=>"Assertion passed: Element is not checked",fail:()=>"Assertion failed: Expected element to not be checked"}},"be.selected":{positive:{pass:()=>"Assertion passed: Element is selected",fail:()=>"Assertion failed: Expected element to be selected"},negative:{pass:()=>"Assertion passed: Element is not selected",fail:()=>"Assertion failed: Expected element to not be selected"}},"be.focused":{positive:{pass:()=>"Assertion passed: Element is focused",fail:()=>"Assertion failed: Expected element to be focused"},negative:{pass:()=>"Assertion passed: Element is not focused",fail:()=>"Assertion failed: Expected element to not be focused"}},"be.visible":{positive:{pass:()=>"Assertion passed: Element is visible",fail:()=>"Assertion failed: Expected element to be visible"},negative:{pass:()=>"Assertion passed: Element is not visible",fail:()=>"Assertion failed: Expected element to not be visible"}},"have.class":{positive:{pass:e=>`Assertion passed: Element has class "${e[0]}"`,fail:e=>`Assertion failed: Expected element to have class "${e[0]}"`},negative:{pass:e=>`Assertion passed: Element does not have class "${e[0]}"`,fail:e=>`Assertion failed: Expected element to not have class "${e[0]}"`}}},zr=(e,t,...r)=>{const n=t.startsWith("not."),a=n?t.slice(4):t,o=(e.textContent||"").trim(),i=kl[a];if(!i)throw new Error(`Unknown assertion: ${a}`);const s=n?"negative":"positive";let u,l;switch(a){case"have.text":u=o===r[0],l=o;break;case"contain.text":u=o.includes(r[0]),l=o;break;case"be.empty":u=o.length===0,l=o;break;case"have.attr":l=e.getAttribute(r[0]),u=l===r[1];break;case"have.value":l=e.value,u=l===r[0];break;case"be.disabled":u=e.disabled===!0;break;case"be.enabled":u=e.disabled===!1;break;case"be.checked":u=e.checked===!0;break;case"be.selected":u=e.selected===!0;break;case"be.focused":u=document.activeElement===e;break;case"be.visible":u=Nl(e);break;case"have.class":u=e.classList.contains(r[0]);break;default:throw new Error(`Unknown assertion: ${a}`)}return rn(u,n,i[s].pass(r),i[s].fail(r,l))},ce=e=>{const t=Mt.handlers.size?Array.from(Mt.handlers.values()).find(r=>r.status==="running"):null;t&&t.logs?.push(e)},Rr="1.6.3",jl=()=>typeof window<"u"?(window.__TWD_MOCK_STATE__||(window.__TWD_MOCK_STATE__={rules:[],counts:{}}),window.__TWD_MOCK_STATE__):{rules:[],counts:{}},et=jl(),Ce=et.rules,Dl=100,ka=!1,Ll=async e=>{if(ka){console.warn("[TWD] Request mocking already initialized");return}if("serviceWorker"in navigator){ka=!0;const t=e??"/mock-sw.js";await navigator.serviceWorker.register(`${t}?v=${Rr}`),navigator.serviceWorker.controller||await new Promise(r=>{navigator.serviceWorker.addEventListener("controllerchange",r,{once:!0})}),navigator.serviceWorker.addEventListener("message",r=>{if(r.data?.type==="EXECUTED"){const{alias:n,request:a,hitCount:o}=r.data,i=Ce.find(s=>s.alias===n);i&&(i.executed=!0,i.request=a,i.hitCount=o),et.counts[n]=o??(et.counts[n]??0)+1}})}},Bl=async(e,t)=>{const r={alias:e,...t,executed:!1},n=Ce.findIndex(a=>a.alias===e);n!==-1?Ce[n]=r:Ce.push(r),typeof window.__twdCollectMock=="function"&&window.__twdCollectMock({alias:e,url:String(t.url),method:t.method,status:t.status||200,response:t.response,urlRegex:t.urlRegex||!1}),navigator.serviceWorker.controller?.postMessage({type:"ADD_RULE",rule:r,version:Rr}),await ur(Dl),await Promise.resolve()},$l=async e=>await Promise.all(e.map(t=>To(t))),To=async(e,t=10,r=100)=>{const n=Ce.find(u=>u.alias===e);if(!n)throw new Error(`Rule ${e} not found`);for(let u=0;u<t;u++){const l=Ce.find(c=>c.alias===e&&c.executed);if(l)return Promise.resolve(l);u<t-1&&await new Promise(c=>setTimeout(c,r))}const a=t*r,o=Ce.filter(u=>u.executed).map(u=>`${u.alias} (${u.method} ${u.url})`).join(", "),i=Ce.filter(u=>!u.executed).map(u=>`${u.alias} (${u.method} ${u.url})`).join(", "),s=[`Rule "${e}" was not executed within ${a}ms.`,`  Expected: ${n.method} ${n.url}`,`  Executed rules: ${o||"none"}`,`  Not executed rules: ${i||"none"}`].join(`
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var ql=Object.create,lr=Object.defineProperty,Rl=Object.getOwnPropertyDescriptor,Tl=Object.getOwnPropertyNames,Sl=Object.getPrototypeOf,xl=Object.prototype.hasOwnProperty,P=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),Ol=(e,t)=>{let r={};for(var n in e)lr(r,n,{get:e[n],enumerable:!0});return t||lr(r,Symbol.toStringTag,{value:"Module"}),r},Ml=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(var a=Tl(t),o=0,i=a.length,s;o<i;o++)s=a[o],!xl.call(e,s)&&s!==r&&lr(e,s,{get:(u=>t[u]).bind(null,s),enumerable:!(n=Rl(t,s))||n.enumerable});return e},In=(e,t,r)=>(r=e!=null?ql(Sl(e)):{},Ml(t||!e||!e.__esModule?lr(r,"default",{value:e,enumerable:!0}):r,e));const Mt=require("./runner-Dr_mUWED.cjs"),tn=require("./componentMocks-CwMyWCu5.cjs");let re=require("react"),j=require("react/jsx-runtime");var Al=(e,t,r=2e3,n=50)=>new Promise((a,o)=>{const i=Date.now(),s=()=>{const u=t();if(u)return a(u);if(Date.now()-i>r)return o(new Error(`Timeout waiting for element ${e}`));setTimeout(s,n)};s()}),Il=(e,t,r=2e3,n=50)=>new Promise((a,o)=>{const i=Date.now(),s=()=>{const u=t();if(u&&u.length>0)return a(Array.from(u));if(Date.now()-i>r)return o(new Error(`Timeout waiting for elements ${e}`));setTimeout(s,n)};s()}),ur=e=>new Promise(t=>setTimeout(t,e)),rn=(e,t,r,n)=>{if(!e&&!t)throw new Error(n);if(e&&t)throw new Error(n.replace("to be","to not be").replace("to have","to not have").replace("to contain","to not contain"));return r};function Nl(e){if(!e.isConnected)return!1;let t=e;for(;t;){const r=getComputedStyle(t);if(r.display==="none"||r.visibility==="hidden"||r.visibility==="collapse")return!1;t=t.parentElement}return!0}var kl={"have.text":{positive:{pass:e=>`Assertion passed: Text is exactly "${e[0]}"`,fail:(e,t)=>`Assertion failed: Expected text to be "${e[0]}", but got "${t}"`},negative:{pass:e=>`Assertion passed: Text is not exactly "${e[0]}"`,fail:(e,t)=>`Assertion failed: Expected text to not be "${e[0]}", but got "${t}"`}},"contain.text":{positive:{pass:e=>`Assertion passed: Text contains "${e[0]}"`,fail:(e,t)=>`Assertion failed: Expected text to contain "${e[0]}", but got "${t}"`},negative:{pass:e=>`Assertion passed: Text does not contain "${e[0]}"`,fail:(e,t)=>`Assertion failed: Expected text to not contain "${e[0]}", but got "${t}"`}},"be.empty":{positive:{pass:()=>"Assertion passed: Text is empty",fail:(e,t)=>`Assertion failed: Expected text to be empty, but got "${t}"`},negative:{pass:()=>"Assertion passed: Text is not empty",fail:(e,t)=>`Assertion failed: Expected text to not be empty, but got "${t}"`}},"have.attr":{positive:{pass:e=>`Assertion passed: Attribute "${e[0]}" is "${e[1]}"`,fail:(e,t)=>`Assertion failed: Expected attribute "${e[0]}" to be "${e[1]}", but got "${t}"`},negative:{pass:e=>`Assertion passed: Attribute "${e[0]}" is not "${e[1]}"`,fail:(e,t)=>`Assertion failed: Expected attribute "${e[0]}" to not be "${e[1]}", but got "${t}"`}},"have.value":{positive:{pass:e=>`Assertion passed: Value is "${e[0]}"`,fail:(e,t)=>`Assertion failed: Expected value to be "${e[0]}", but got "${t}"`},negative:{pass:e=>`Assertion passed: Value is not "${e[0]}"`,fail:(e,t)=>`Assertion failed: Expected value to not be "${e[0]}", but got "${t}"`}},"be.disabled":{positive:{pass:()=>"Assertion passed: Element is disabled",fail:()=>"Assertion failed: Expected element to be disabled"},negative:{pass:()=>"Assertion passed: Element is not disabled",fail:()=>"Assertion failed: Expected element to not be disabled"}},"be.enabled":{positive:{pass:()=>"Assertion passed: Element is enabled",fail:()=>"Assertion failed: Expected element to be enabled"},negative:{pass:()=>"Assertion passed: Element is not enabled",fail:()=>"Assertion failed: Expected element to not be enabled"}},"be.checked":{positive:{pass:()=>"Assertion passed: Element is checked",fail:()=>"Assertion failed: Expected element to be checked"},negative:{pass:()=>"Assertion passed: Element is not checked",fail:()=>"Assertion failed: Expected element to not be checked"}},"be.selected":{positive:{pass:()=>"Assertion passed: Element is selected",fail:()=>"Assertion failed: Expected element to be selected"},negative:{pass:()=>"Assertion passed: Element is not selected",fail:()=>"Assertion failed: Expected element to not be selected"}},"be.focused":{positive:{pass:()=>"Assertion passed: Element is focused",fail:()=>"Assertion failed: Expected element to be focused"},negative:{pass:()=>"Assertion passed: Element is not focused",fail:()=>"Assertion failed: Expected element to not be focused"}},"be.visible":{positive:{pass:()=>"Assertion passed: Element is visible",fail:()=>"Assertion failed: Expected element to be visible"},negative:{pass:()=>"Assertion passed: Element is not visible",fail:()=>"Assertion failed: Expected element to not be visible"}},"have.class":{positive:{pass:e=>`Assertion passed: Element has class "${e[0]}"`,fail:e=>`Assertion failed: Expected element to have class "${e[0]}"`},negative:{pass:e=>`Assertion passed: Element does not have class "${e[0]}"`,fail:e=>`Assertion failed: Expected element to not have class "${e[0]}"`}}},zr=(e,t,...r)=>{const n=t.startsWith("not."),a=n?t.slice(4):t,o=(e.textContent||"").trim(),i=kl[a];if(!i)throw new Error(`Unknown assertion: ${a}`);const s=n?"negative":"positive";let u,l;switch(a){case"have.text":u=o===r[0],l=o;break;case"contain.text":u=o.includes(r[0]),l=o;break;case"be.empty":u=o.length===0,l=o;break;case"have.attr":l=e.getAttribute(r[0]),u=l===r[1];break;case"have.value":l=e.value,u=l===r[0];break;case"be.disabled":u=e.disabled===!0;break;case"be.enabled":u=e.disabled===!1;break;case"be.checked":u=e.checked===!0;break;case"be.selected":u=e.selected===!0;break;case"be.focused":u=document.activeElement===e;break;case"be.visible":u=Nl(e);break;case"have.class":u=e.classList.contains(r[0]);break;default:throw new Error(`Unknown assertion: ${a}`)}return rn(u,n,i[s].pass(r),i[s].fail(r,l))},ce=e=>{const t=Mt.handlers.size?Array.from(Mt.handlers.values()).find(r=>r.status==="running"):null;t&&t.logs?.push(e)},Rr="1.6.4",jl=()=>typeof window<"u"?(window.__TWD_MOCK_STATE__||(window.__TWD_MOCK_STATE__={rules:[],counts:{}}),window.__TWD_MOCK_STATE__):{rules:[],counts:{}},et=jl(),Ce=et.rules,Dl=100,ka=!1,Ll=async e=>{if(ka){console.warn("[TWD] Request mocking already initialized");return}if("serviceWorker"in navigator){ka=!0;const t=e??"/mock-sw.js";await navigator.serviceWorker.register(`${t}?v=${Rr}`),navigator.serviceWorker.controller||await new Promise(r=>{navigator.serviceWorker.addEventListener("controllerchange",r,{once:!0})}),navigator.serviceWorker.addEventListener("message",r=>{if(r.data?.type==="EXECUTED"){const{alias:n,request:a,hitCount:o}=r.data,i=Ce.find(s=>s.alias===n);i&&(i.executed=!0,i.request=a,i.hitCount=o),et.counts[n]=o??(et.counts[n]??0)+1}})}},Bl=async(e,t)=>{const r={alias:e,...t,executed:!1},n=Ce.findIndex(a=>a.alias===e);n!==-1?Ce[n]=r:Ce.push(r),typeof window.__twdCollectMock=="function"&&window.__twdCollectMock({alias:e,url:String(t.url),method:t.method,status:t.status||200,response:t.response,urlRegex:t.urlRegex||!1}),navigator.serviceWorker.controller?.postMessage({type:"ADD_RULE",rule:r,version:Rr}),await ur(Dl),await Promise.resolve()},$l=async e=>await Promise.all(e.map(t=>To(t))),To=async(e,t=10,r=100)=>{const n=Ce.find(u=>u.alias===e);if(!n)throw new Error(`Rule ${e} not found`);for(let u=0;u<t;u++){const l=Ce.find(c=>c.alias===e&&c.executed);if(l)return Promise.resolve(l);u<t-1&&await new Promise(c=>setTimeout(c,r))}const a=t*r,o=Ce.filter(u=>u.executed).map(u=>`${u.alias} (${u.method} ${u.url})`).join(", "),i=Ce.filter(u=>!u.executed).map(u=>`${u.alias} (${u.method} ${u.url})`).join(", "),s=[`Rule "${e}" was not executed within ${a}ms.`,`  Expected: ${n.method} ${n.url}`,`  Executed rules: ${o||"none"}`,`  Not executed rules: ${i||"none"}`].join(`
 `);throw console.log(s),new Error(s)},So=()=>Ce,xo=()=>{navigator.serviceWorker.controller?.postMessage({type:"CLEAR_RULES",version:Rr}),Ce.length=0;for(const e in et.counts)delete et.counts[e]},Fl=e=>et.counts[e]??0,Ul=()=>({...et.counts}),zl=(e,t)=>{const r=e.startsWith("not.");switch(r?e.slice(4):e){case"eq":return rn(window.location.href===t,r,`Assertion passed: URL is ${t}`,`Assertion failed: Expected URL to be ${t}, but got ${window.location.href}`);case"contain.url":return rn(window.location.href.includes(t),r,`Assertion passed: URL contains ${t}`,`Assertion failed: Expected URL to contain ${t}, but got ${window.location.href}`);default:throw new Error(`Unknown assertion: ${e}`)}},Vl=()=>({location:window.location,should:async(e,t,r=5)=>{let n="",a;for(let o=0;o<r;o++)try{n=zl(e,t),ce(n);break}catch(i){await new Promise(s=>setTimeout(s,100)),a=i}if(a)throw a;return n}}),Hl=100,Wl=async(e,t)=>{if(ce(`visit("${e}")`),window.location.pathname===e||t){const r=`/__dummy_${Math.random().toString(36).slice(2)}`;window.history.pushState({},"",r),window.dispatchEvent(new PopStateEvent("popstate")),await ur(10)}window.history.pushState({},"",e),window.dispatchEvent(new PopStateEvent("popstate")),await ur(Hl)},nn="twd-viewport-styles",an="twd-viewport-iframe",fe=null,lt=null,Kl=()=>{if(fe)return;const{style:e}=document.body;fe={maxWidth:e.maxWidth,maxHeight:e.maxHeight,minHeight:e.minHeight,overflow:e.overflow,margin:e.margin,boxSizing:e.boxSizing,boxShadow:e.boxShadow}},Gl=(e,t)=>{let r=document.getElementById(nn);r||(r=document.createElement("style"),r.id=nn,document.head.appendChild(r));const n=t?`${e} × ${t}`:`${e}`;r.textContent=`
 #twd-viewport-badge {
   position: fixed;

package/dist/index.d.ts

@@ -1 +1,625 @@
+import { configure } from '@testing-library/dom';
+import { default as default_2 } from '@testing-library/user-event';
+import { expect } from 'chai';
+import { JSX } from 'react/jsx-runtime';
+import { screen as screen_2 } from '@testing-library/dom';
+
+/**
+ * All assertion names, including negated ones.
+ */
+declare type AnyAssertion = Negatable_2<AssertionName>;
+
+/**
+ * All assertion names, including negated ones.
+ */
+declare type AnyURLAssertion = Negatable<URLAssertionName>;
+
+/**
+ * Maps assertion name to its argument tuple.
+ */
+declare type ArgsFor<A extends AnyAssertion> = A extends `not.${infer Base extends AssertionName}` ? AssertionArgs[Base] : A extends AssertionName ? AssertionArgs[A] : never;
+
+/**
+ * Argument types for each assertion.
+ */
+declare type AssertionArgs = {
+    "have.text": [expected: string];
+    "contain.text": [expected: string];
+    "be.empty": [];
+    "have.attr": [attr: string, value: string];
+    "have.value": [value: string];
+    "be.disabled": [];
+    "be.enabled": [];
+    "be.checked": [];
+    "be.selected": [];
+    "be.focused": [];
+    "be.visible": [];
+    "have.class": [className: string];
+};
+
+/**
+ * Types and interfaces for the TWD testing library.
+ *
+ * @module twd-types
+ */
+/**
+ * All supported assertion names for the `should` function.
+ *
+ * @example
+ * api.should("have.text", "Hello");
+ * api.should("be.empty");
+ */
+declare type AssertionName = "have.text" | "contain.text" | "be.empty" | "have.attr" | "have.value" | "be.disabled" | "be.enabled" | "be.checked" | "be.selected" | "be.focused" | "be.visible" | "have.class";
+
+export declare const configureScreenDom: typeof configure;
+
+export declare const defaultTheme: TWDTheme;
+
+export { expect }
+
+/**
+ * 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.
+ * @param theme - Optional theme customization
+ * @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, {
+ *     primary: '#ff0000',
+ *     background: '#ffffff'
+ *   });
+ * }
+ * ```
+ */
+export declare const initTests: (testModules: TestModule, Component: React.ReactNode, createRoot: (el: HTMLElement) => {
+    render: (el: React.ReactNode) => void;
+}, theme?: Partial<TWDTheme>) => Promise<void>;
+
+/**
+ * Injects theme CSS variables into the document
+ * This should be called once when the sidebar is initialized
+ */
+export declare function injectTheme(theme?: Partial<TWDTheme>): void;
+
+/**
+ * Negatable assertion names (e.g., 'not.have.text').
+ */
+declare type Negatable<T extends string> = T | `not.${T}`;
+
+/**
+ * Negatable assertion names (e.g., 'not.have.text').
+ */
+declare type Negatable_2<T extends string> = T | `not.${T}`;
+
+declare interface Options {
+    /** HTTP method to match (e.g. `"GET"`, `"POST"`). */
+    method: string;
+    /** URL string or RegExp to match against the request URL. */
+    url: string | RegExp;
+    /** The mocked response body returned to the client. */
+    response: unknown;
+    /** HTTP status code for the mocked response (default: `200`). */
+    status?: number;
+    /** Headers to include in the mocked response. */
+    responseHeaders?: Record<string, string>;
+    /** Whether the `url` field should be treated as a regex pattern. */
+    urlRegex?: boolean;
+    /** Delay in milliseconds before returning the mocked response. */
+    delay?: number;
+}
+
+declare type Rule = {
+    /** HTTP method to match (e.g. `"GET"`, `"POST"`). */
+    method: string;
+    /** URL string or RegExp to match against the request URL. */
+    url: string | RegExp;
+    /** The mocked response body returned to the client. */
+    response: unknown;
+    /** Unique identifier for this mock rule, used with `waitForRequest`. */
+    alias: string;
+    /** Whether this rule has been matched by an actual request. Set automatically by the service worker. */
+    executed?: boolean;
+    /**
+     * The parsed request body sent by the client.
+     * For JSON requests this is the parsed object, for form data an object of key/value pairs, for text a string.
+     * Access fields directly: `rule.request.email`, **not** `rule.request.body.email`.
+     */
+    request?: any;
+    /** HTTP status code for the mocked response (default: `200`). */
+    status?: number;
+    /** Headers to include in the mocked response. */
+    responseHeaders?: Record<string, string>;
+    /** Whether the `url` field should be treated as a regex pattern. */
+    urlRegex?: boolean;
+    /** Delay in milliseconds before returning the mocked response. */
+    delay?: number;
+    /** Number of times this rule has been matched. Updated automatically by the service worker. */
+    hitCount?: number;
+};
+
+declare type ScreenDom = typeof screen_2;
+
+/**
+ * screenDom - Scoped queries that exclude the TWD sidebar
+ *
+ * Searches only within the main app container (typically #root).
+ * Use this for most queries to avoid matching elements in the sidebar.
+ *
+ * Note: This will NOT find portal-rendered elements (modals, dialogs) that are
+ * rendered outside the root container. For portals, use `screenDomGlobal` instead.
+ */
+export declare const screenDom: ScreenDom;
+
+/**
+ * screenDomGlobal - Global queries that search the entire document.body
+ *
+ * Searches all elements in document.body, including portal-rendered elements
+ * (modals, dialogs, tooltips, etc.).
+ *
+ * ⚠️ WARNING: This may also match elements inside the TWD sidebar if your selectors
+ * are not specific enough. Use more specific queries (e.g., getByRole with name)
+ * to avoid matching sidebar elements.
+ *
+ * Use this when:
+ * - Querying portal-rendered elements (modals, dialogs)
+ * - You need to search outside the root container
+ *
+ * Example:
+ * ```ts
+ * // For a modal rendered via portal
+ * const modal = screenDomGlobal.getByRole('dialog', { name: 'Confirm' });
+ * ```
+ */
+export declare const screenDomGlobal: ScreenDom;
+
+/**
+ * Overloads for the `should` function, for best IntelliSense.
+ *
+ * @example
+ * twd.should("have.text", "Hello");
+ * twd.should("be.empty");
+ * twd.should("have.class", "active");
+ */
+declare type ShouldFn = {
+    (name: "have.text", expected: string): TWDElemAPI;
+    (name: "not.have.text", expected: string): TWDElemAPI;
+    (name: "contain.text", expected: string): TWDElemAPI;
+    (name: "not.contain.text", expected: string): TWDElemAPI;
+    (name: "be.empty"): TWDElemAPI;
+    (name: "not.be.empty"): TWDElemAPI;
+    (name: "have.attr", attr: string, value: string): TWDElemAPI;
+    (name: "not.have.attr", attr: string, value: string): TWDElemAPI;
+    (name: "have.value", value: string): TWDElemAPI;
+    (name: "not.have.value", value: string): TWDElemAPI;
+    (name: "be.disabled"): TWDElemAPI;
+    (name: "not.be.disabled"): TWDElemAPI;
+    (name: "be.enabled"): TWDElemAPI;
+    (name: "not.be.enabled"): TWDElemAPI;
+    (name: "be.checked"): TWDElemAPI;
+    (name: "not.be.checked"): TWDElemAPI;
+    (name: "be.selected"): TWDElemAPI;
+    (name: "not.be.selected"): TWDElemAPI;
+    (name: "be.focused"): TWDElemAPI;
+    (name: "not.be.focused"): TWDElemAPI;
+    (name: "be.visible"): TWDElemAPI;
+    (name: "not.be.visible"): TWDElemAPI;
+    (name: "have.class", className: string): TWDElemAPI;
+    (name: "not.have.class", className: string): TWDElemAPI;
+};
+
+/**
+ * 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'),
+ * };
+ * ```
+ */
+declare type TestModule = Record<string, () => Promise<unknown>>;
+
+/**
+ * Mini Cypress-style helpers for DOM testing.
+ * @namespace twd
+ */
+export declare const twd: TWDAPI;
+
+declare interface TWDAPI {
+    /**
+     * Finds an element by selector and returns the TWD API for it.
+     * @param selector CSS selector
+     * @returns {Promise<TWDElemAPI>} The TWD API for the element
+     *
+     * @example
+     * ```ts
+     * const btn = await twd.get("button");
+     *
+     * ```
+     *
+     */
+    get: (selector: string) => Promise<TWDElemAPI>;
+    /**
+     * Sets the value of an input element and dispatches an input event. We recommend using this only for range, color, time inputs.
+     * @param el The input element
+     * @param value The value to set
+     *
+     * @example
+     * ```ts
+     * const input = await twd.get("input[type='time']");
+     * twd.setInputValue(input.el, "13:30");
+     *
+     * ```
+     */
+    setInputValue: (el: Element, value: string) => void;
+    /**
+     * Finds multiple elements by selector and returns an array of TWD APIs for them.
+     * @param selector CSS selector
+     * @returns {Promise<TWDElemAPI[]>} Array of TWD APIs for the elements
+     *
+     * @example
+     * ```ts
+     * const items = await twd.getAll(".item");
+     * items.at(0).should("be.visible");
+     * items.at(1).should("contain.text", "Hello");
+     * expect(items).to.have.length(3);
+     * ```
+     */
+    getAll: (selector: string) => Promise<TWDElemAPI[]>;
+    /**
+     * Simulates visiting a URL (SPA navigation).
+     * @param url The URL to visit
+     * @param [reload] Whether to force a reload even if already on the URL (optional)
+     *
+     * @example
+     * ```ts
+     * twd.visit("/contact");
+     * // visit with reload
+     * twd.visit("/contact", true);
+     * ```
+     */
+    visit: (url: string, reload?: boolean) => 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
+     *  - `delay`: (optional) Delay in ms before returning the response
+     *
+     * @example
+     * ```ts
+     * mockRequest("getUser", {
+     *   method: "GET",
+     *   url: /\/api\/user\/\d+/,
+     *   response: { id: 1, name: "Kevin" },
+     *   status: 200,
+     *   responseHeaders: { "x-mock": "true" }
+     * });
+     * ```
+     */
+    mockRequest: (alias: string, options: Options) => Promise<void>;
+    /**
+     * Wait for a mocked request to be made.
+     * @param alias The alias of the mock rule to wait for
+     * @param retries The number of retries to make
+     * @param retryDelay The delay between retries
+     * @return The matched rule (with body if applicable)
+     *
+     * @example
+     * ```ts
+     * const rule = await twd.waitFor("aliasId");
+     * console.log(rule.body);
+     * const rule = await twd.waitFor("aliasId", 5, 100);
+     * console.log(rule.body);
+     *
+     * ```
+     */
+    waitForRequest: (alias: string, retries?: number, retryDelay?: number) => Promise<Rule>;
+    /**
+     * 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
+     * const rules = await waitForRequests(["getUser", "postComment"]);
+     * ```
+     */
+    waitForRequests: (aliases: string[]) => Promise<Rule[]>;
+    /**
+     * URL-related assertions.
+     *
+     * @example
+     * ```ts
+     * twd.url().should("eq", "http://localhost:3000/contact");
+     * twd.url().should("contain.url", "/contact");
+     *
+     * ```
+     */
+    url: () => URLCommandAPI;
+    /**
+     * Initializes request mocking (registers the service worker).
+     * @param [path] service worker absolute path (optional)
+     *
+     * @example
+     * ```ts
+     * await twd.initRequestMocking();
+     * // init with custom service worker path
+     * await twd.initRequestMocking('/test-path/mock-sw.js');
+     * ```
+     */
+    initRequestMocking: (path?: string) => Promise<void>;
+    /**
+     * Clears all request mock rules.
+     *
+     * @example
+     * ```ts
+     * twd.clearRequestMockRules();
+     *
+     * ```
+     */
+    clearRequestMockRules: () => void;
+    /**
+     * Gets all current request mock rules.
+     *
+     * @example
+     * ```ts
+     * const rules = twd.getRequestMockRules();
+     * console.log(rules);
+     * ```
+     */
+    getRequestMockRules: () => Rule[];
+    /**
+     * Gets the number of times a specific mock rule was hit.
+     * @param alias The alias of the mock rule
+     * @returns The number of times the rule was matched
+     *
+     * @example
+     * ```ts
+     * const count = twd.getRequestCount("getUser");
+     * expect(count).to.equal(2);
+     * ```
+     */
+    getRequestCount: (alias: string) => number;
+    /**
+     * Gets a snapshot of all mock rule hit counts.
+     * @returns An object mapping rule aliases to their hit counts
+     *
+     * @example
+     * ```ts
+     * const counts = twd.getRequestCounts();
+     * expect(counts).to.deep.equal({ getUser: 2, listPosts: 1 });
+     * ```
+     */
+    getRequestCounts: () => Record<string, number>;
+    /**
+     * Waits for a specified time.
+     * @param time Time in milliseconds to wait
+     * @returns A promise that resolves after the specified time
+     * @example
+     * ```ts
+     * await twd.wait(500); // wait for 500ms
+     * ```
+     */
+    wait: (time: number) => Promise<void>;
+    /**
+     * Asserts something about the element.
+     * @param el The element to assert on
+     * @param name The name of the assertion.
+     * @param args Arguments for the assertion.
+     * @returns The same API for chaining.
+     * @example
+     * ```ts
+     * const button = await twd.get("button");
+     * const text = screenDom.getByText("Hello");
+     * twd.should(button.el, "have.text", "Hello");
+     * twd.should(text, "be.empty");
+     * twd.should(button.el, "have.class", "active");
+     * ```
+     */
+    should: (el: Element, name: AnyAssertion, ...args: ArgsFor<AnyAssertion>) => void;
+    /**
+     * Mock a component.
+     * @param name The name of the component to mock
+     * @param component The component to mock
+     * @returns The mocked component
+     * @example
+     * ```ts
+     * twd.mockComponent("Button", Button);
+     * ```
+     */
+    mockComponent: (name: string, component: React.ComponentType<any>) => void;
+    /**
+     * Clears all component mocks.
+     *
+     * @example
+     * ```ts
+     * twd.clearComponentMocks();
+     * ```
+     */
+    clearComponentMocks: () => void;
+    /**
+     * Asserts that an element does not exist in the DOM.
+     * @param selector CSS selector of the element to check
+     * @returns A promise that resolves if the element does not exist, or rejects if it does
+     *
+     * @example
+     * ```ts
+     * await twd.notExists(".non-existent");
+     * ```
+     */
+    notExists: (selector: string) => Promise<void>;
+    /**
+     * Simulates a viewport size by constraining body dimensions, overriding
+     * `window.innerWidth`/`window.innerHeight` and `window.matchMedia()`, and
+     * rewriting CSS `@media` rules to match the simulated dimensions.
+     * Call with no arguments to reset to the original viewport.
+     *
+     * @param width Viewport width in pixels
+     * @param height Viewport height in pixels (optional — omit to leave height unconstrained)
+     *
+     * @example
+     * ```ts
+     * twd.viewport(375, 667); // mobile
+     * twd.viewport(768);      // tablet width, height unconstrained
+     * twd.viewport();          // reset
+     * ```
+     */
+    viewport: (width?: number, height?: number) => void;
+    /**
+     * Resets the viewport to its original size (undoes a previous `twd.viewport()` call).
+     *
+     * @example
+     * ```ts
+     * twd.resetViewport();
+     * ```
+     */
+    resetViewport: () => void;
+}
+
+/**
+ * The main API returned by `twd.get()`.
+ *
+ * @example
+ * ```ts
+ * const btn = await twd.get("button");
+ * btn.should("have.text", "Clicked").click();
+ *
+ * ```
+ *
+ */
+declare interface TWDElemAPI {
+    /** The underlying DOM element. */
+    el: Element;
+    /**
+     * Asserts something about the element.
+     * @param name The name of the assertion.
+     * @param args Arguments for the assertion.
+     * @returns The same API for chaining.
+     *
+     * @example
+     * ```ts
+     * const btn = await twd.get("button");
+     * btn.should("have.text", "Click me").should("not.be.disabled");
+     *
+     * ```
+     *
+     */
+    should: ShouldFn;
+}
+
+export declare const TWDSidebar: ({ open, position, search }: TWDSidebarProps) => JSX.Element;
+
+declare interface TWDSidebarProps {
+    /**
+     * Whether the sidebar is open by default
+     */
+    open: boolean;
+    /**
+     * Sidebar position
+     * - left: Sidebar on the left side (default)
+     * - right: Sidebar on the right side
+     *
+     * @default "left"
+     */
+    position?: "left" | "right";
+    /**
+     * Whether to show the search/filter input
+     */
+    search?: boolean;
+}
+
+/**
+ * TWD Theme Configuration
+ *
+ * This file defines CSS variables that can be customized by users
+ * to personalize their TWD UI experience.
+ *
+ * Users can override these variables by setting them in their CSS:
+ *
+ * ```css
+ * :root {
+ *   --twd-primary: #2563eb;
+ *   --twd-background: #1e293b;
+ *    ... other variables
+ * }
+ *
+ */
+export declare interface TWDTheme {
+    primary: string;
+    background: string;
+    backgroundSecondary: string;
+    border: string;
+    borderLight: string;
+    text: string;
+    textSecondary: string;
+    textMuted: string;
+    describeBg: string;
+    describeText: string;
+    describeBorder: string;
+    success: string;
+    successBg: string;
+    error: string;
+    errorBg: string;
+    warning: string;
+    warningBg: string;
+    skip: string;
+    skipBg: string;
+    buttonPrimary: string;
+    buttonPrimaryText: string;
+    buttonSecondary: string;
+    buttonSecondaryText: string;
+    buttonBorder: string;
+    spacingXs: string;
+    spacingSm: string;
+    spacingMd: string;
+    spacingLg: string;
+    spacingXl: string;
+    fontSizeXs: string;
+    fontSizeSm: string;
+    fontSizeMd: string;
+    fontSizeLg: string;
+    fontWeightNormal: string;
+    fontWeightMedium: string;
+    fontWeightBold: string;
+    sidebarWidth: string;
+    borderRadius: string;
+    borderRadiusLg: string;
+    shadow: string;
+    shadowSm: string;
+    zIndexSidebar: string;
+    zIndexSticky: string;
+    animationDuration: string;
+    iconColor: string;
+    iconColorSecondary: string;
+}
+
+/**
+ * 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");
+ */
+declare type URLAssertionName = "eq" | "contain.url";
+
+declare type URLCommandAPI = {
+    location: Location;
+    should: (name: AnyURLAssertion, value: string, retries?: number) => Promise<string>;
+};
+
+declare type UserEvent = typeof default_2;
+
+export declare const userEvent: UserEvent;
+
 export { }

package/dist/index.es.js

@@ -222,7 +222,7 @@ var $l = {
 }, ce = (e) => {
   const t = ur.size ? Array.from(ur.values()).find((r) => r.status === "running") : null;
   t && t.logs?.push(e);
-}, Mr = "1.6.3", Fl = () => typeof window < "u" ? (window.__TWD_MOCK_STATE__ || (window.__TWD_MOCK_STATE__ = {
+}, Mr = "1.6.4", Fl = () => typeof window < "u" ? (window.__TWD_MOCK_STATE__ || (window.__TWD_MOCK_STATE__ = {
   rules: [],
   counts: {}
 }), window.__TWD_MOCK_STATE__) : {

package/dist/mock-sw.js

@@ -1,4 +1,4 @@
-(function(){var d=t=>{try{return new RegExp(t),!0}catch{return!1}},f=new Set(["js","mjs","cjs","ts","tsx","jsx","mts","cts","css","scss","sass","less","styl","html","htm","xml","xhtml","vue","svelte","json","yaml","yml","toml","csv","txt","md","mdx","pdf","doc","docx","png","jpg","jpeg","gif","svg","webp","ico","bmp","avif","woff","woff2","ttf","eot","otf","mp3","mp4","webm","ogg","wav","zip","tar","gz","rar","map"]),c=t=>{const s=t.split("?")[0].match(/\.([a-zA-Z0-9]+)$/);return s?f.has(s[1].toLowerCase()):!1},h=(t,s)=>{const i=t.indexOf(s);if(i===-1)return!1;const e=i+s.length,a=t[e];if(a===void 0)return!0;const n=t.indexOf("?");return n!==-1&&e>n?!0:"?#&".includes(a)};function m(t,s,i){return i.find(e=>{const a=e.method.toLowerCase()===t.toLowerCase();if(e.urlRegex&&d(e.url)){const l=new RegExp(e.url);return a&&l.test(s)}if(c(e.url))return a&&s.includes(e.url);const n=e.url===s||h(s,e.url);return a&&n&&!c(s)})}function p(t,s,i,e){t.forEach(a=>a.postMessage({type:"EXECUTED",alias:s.alias,request:i,hitCount:e}))}var y=(t,s,i)=>{const e=![204,205,304].includes(s),a=e?JSON.stringify(t):null;return new Response(a,{status:s,headers:e?i||{"Content-Type":"application/json"}:i||{}})},u="1.6.3",r=[],o={},g=async t=>{const{method:s}=t.request,i=t.request.url,e=m(s,i,r);e&&(console.log("[TWD] Mock hit:",e.alias,s,i),t.respondWith((async()=>{let a=null;const n=t.request.headers.get("content-type")||"application/json";if(n.includes("application/json"))try{a=await t.request.clone().json()}catch{}else if(n.includes("form"))try{const l=await t.request.clone().formData();a={},l.forEach((x,E)=>{a[E]=x})}catch{}else if(n.includes("text"))try{a=await t.request.clone().text()}catch{}else if(n.includes("octet-stream"))try{a=await t.request.clone().arrayBuffer()}catch{}else if(n.includes("image"))try{a=await t.request.clone().blob()}catch{}else try{a=await t.request.clone().text()}catch{}return o[e.alias]||(o[e.alias]=0),o[e.alias]++,p(await self.clients.matchAll(),e,a,o[e.alias]),e.delay&&e.delay>0&&await new Promise(l=>setTimeout(l,e.delay)),y(e.response,e.status??200,e.responseHeaders)})()))},w=t=>{t!=="1.6.3"&&console.warn(`[TWD] ⚠️ Version mismatch detected:
+(function(){var d=t=>{try{return new RegExp(t),!0}catch{return!1}},f=new Set(["js","mjs","cjs","ts","tsx","jsx","mts","cts","css","scss","sass","less","styl","html","htm","xml","xhtml","vue","svelte","json","yaml","yml","toml","csv","txt","md","mdx","pdf","doc","docx","png","jpg","jpeg","gif","svg","webp","ico","bmp","avif","woff","woff2","ttf","eot","otf","mp3","mp4","webm","ogg","wav","zip","tar","gz","rar","map"]),c=t=>{const s=t.split("?")[0].match(/\.([a-zA-Z0-9]+)$/);return s?f.has(s[1].toLowerCase()):!1},h=(t,s)=>{const i=t.indexOf(s);if(i===-1)return!1;const e=i+s.length,a=t[e];if(a===void 0)return!0;const n=t.indexOf("?");return n!==-1&&e>n?!0:"?#&".includes(a)};function m(t,s,i){return i.find(e=>{const a=e.method.toLowerCase()===t.toLowerCase();if(e.urlRegex&&d(e.url)){const l=new RegExp(e.url);return a&&l.test(s)}if(c(e.url))return a&&s.includes(e.url);const n=e.url===s||h(s,e.url);return a&&n&&!c(s)})}function p(t,s,i,e){t.forEach(a=>a.postMessage({type:"EXECUTED",alias:s.alias,request:i,hitCount:e}))}var y=(t,s,i)=>{const e=![204,205,304].includes(s),a=e?JSON.stringify(t):null;return new Response(a,{status:s,headers:e?i||{"Content-Type":"application/json"}:i||{}})},u="1.6.4",r=[],o={},g=async t=>{const{method:s}=t.request,i=t.request.url,e=m(s,i,r);e&&(console.log("[TWD] Mock hit:",e.alias,s,i),t.respondWith((async()=>{let a=null;const n=t.request.headers.get("content-type")||"application/json";if(n.includes("application/json"))try{a=await t.request.clone().json()}catch{}else if(n.includes("form"))try{const l=await t.request.clone().formData();a={},l.forEach((x,E)=>{a[E]=x})}catch{}else if(n.includes("text"))try{a=await t.request.clone().text()}catch{}else if(n.includes("octet-stream"))try{a=await t.request.clone().arrayBuffer()}catch{}else if(n.includes("image"))try{a=await t.request.clone().blob()}catch{}else try{a=await t.request.clone().text()}catch{}return o[e.alias]||(o[e.alias]=0),o[e.alias]++,p(await self.clients.matchAll(),e,a,o[e.alias]),e.delay&&e.delay>0&&await new Promise(l=>setTimeout(l,e.delay)),y(e.response,e.status??200,e.responseHeaders)})()))},w=t=>{t!=="1.6.4"&&console.warn(`[TWD] ⚠️ Version mismatch detected:
 Client version: ${t}
 Service Worker version: ${u}
 

package/dist/runner-ci.d.ts

@@ -1 +1,28 @@
+export declare const executeTests: () => Promise<{
+    handlers: Handler[];
+    testStatus: TestResult[];
+}>;
+
+declare interface Handler {
+    id: string;
+    name: string;
+    parent?: string;
+    handler: () => void | Promise<void>;
+    children?: string[];
+    type: 'suite' | 'test';
+    status?: 'idle' | 'pass' | 'fail' | 'skip' | 'running';
+    logs: string[];
+    depth: number;
+    only?: boolean;
+    skip?: boolean;
+}
+
+export declare const reportResults: (handlers: Handler[], testResults: TestResult[]) => void;
+
+declare interface TestResult {
+    id: string;
+    status: 'pass' | 'fail' | 'skip';
+    error?: string;
+}
+
 export { }

package/dist/runner.d.ts

@@ -1 +1,63 @@
+export declare const afterEach: (fn: HookFn) => void;
+
+export declare const beforeEach: (fn: HookFn) => void;
+
+export declare const clearTests: () => void;
+
+export declare const describe: {
+    (name: string, handler: () => void): void;
+    only(name: string, handler: () => void): void;
+    skip(name: string, handler: () => void): void;
+};
+
+export declare interface Handler {
+    id: string;
+    name: string;
+    parent?: string;
+    handler: () => void | Promise<void>;
+    children?: string[];
+    type: 'suite' | 'test';
+    status?: 'idle' | 'pass' | 'fail' | 'skip' | 'running';
+    logs: string[];
+    depth: number;
+    only?: boolean;
+    skip?: boolean;
+}
+
+export declare const handlers: Map<string, Handler>;
+
+declare type HookFn = () => void | Promise<void>;
+
+export declare const it: {
+    (name: string, handler: () => void | Promise<void>): void;
+    only(name: string, handler: () => void | Promise<void>): void;
+    skip(name: string, handler?: () => void | Promise<void>): void;
+};
+
+export declare interface RunnerEvents {
+    onStart: (test: Handler) => void;
+    onPass: (test: Handler, retryAttempt?: number) => void;
+    onFail: (test: Handler, error: Error) => void;
+    onSkip: (test: Handler) => void;
+    onSuiteStart?: (suite: Handler) => void;
+    onSuiteEnd?: (suite: Handler) => void;
+}
+
+export declare class TestRunner {
+    private events;
+    private retryCount;
+    constructor(events: RunnerEvents, options?: TestRunnerOptions);
+    runAll(): Promise<Map<string, Handler>>;
+    runSingle(id: string): Promise<void>;
+    runByIds(ids: string[]): Promise<Map<string, Handler>>;
+    private runSuiteByIds;
+    private hasDescendantInSet;
+    private runSuite;
+    private runTest;
+}
+
+export declare interface TestRunnerOptions {
+    retryCount?: number;
+}
+
 export { }

package/dist/ui.d.ts

@@ -1 +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/vite-plugin.d.ts

@@ -1 +1,67 @@
+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;
+
+/**
+ * Vite plugin to handle HMR for TWD test files.
+ * When a TWD test file is updated, it forces a full page reload to prevent
+ * duplicate test entries that occur when HMR reloads test modules.
+ *
+ * This plugin only runs in development mode (serve) and does not affect Vitest test runs.
+ *
+ * @param options - Configuration options for the plugin
+ * @example
+ * ```ts
+ * import { twdHmr } from 'twd-js/vite-plugin';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     // ... other plugins
+ *     twdHmr() // Uses default pattern: .twd.test.ts
+ *   ]
+ * });
+ * ```
+ * @example
+ * ```ts
+ * // Custom pattern
+ * twdHmr({ testFilePattern: '.twd.test.tsx' })
+ * ```
+ * @example
+ * ```ts
+ * // Custom function
+ * twdHmr({
+ *   testFilePattern: (file) => file.includes('.twd.test.')
+ * })
+ * ```
+ */
+export declare function twdHmr(options?: TwdHmrOptions): Plugin_2;
+
+/**
+ * Options for the TWD HMR plugin.
+ */
+export declare interface TwdHmrOptions {
+    /**
+     * Pattern to match test files. Defaults to `.twd.test.ts`.
+     * Can be a string (checked with `endsWith`) or a function that returns a boolean.
+     * @default ".twd.test.ts"
+     */
+    testFilePattern?: string | ((file: string) => boolean);
+}
+
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twd-js",
-  "version": "1.6.3",
+  "version": "1.6.4",
   "description": "Test While Developing (TWD) - in-browser testing",
   "type": "module",
   "license": "MIT",
@@ -88,7 +88,7 @@
     "@vitest/coverage-v8": "^4.1.2",
     "conventional-changelog": "^7.2.0",
     "jsdom": "^29.0.1",
-    "typescript": "^6.0.2",
+    "typescript": "~5.9.3",
     "vite": "^8.0.3",
     "vite-plugin-dts": "^4.5.4",
     "vitepress": "^2.0.0-alpha.12",