twd-js 1.8.0-beta.0 → 1.8.0-beta.1

package/README.md

@@ -36,25 +36,26 @@ pnpm add twd-js
 
 ## Quick Start
 
-### React / Vue / Angular / Other Frameworks (Bundled / recommended)
+### Vite-based projects (React, Vue, Solid, and more)
 
-TWD now supports any framework via its bundled version.
+Add the `twd()` plugin to your `vite.config.ts`. The plugin auto-loads the sidebar and discovers test files in dev — no entry-file changes required.
 
 ```ts
-// Only load the test sidebar and tests in development mode
-if (import.meta.env.DEV) {
-  const { initTWD } = await import('twd-js/bundled');
-  const tests = import.meta.glob("./**/*.twd.test.ts");
-  
-  // Initialize TWD with tests and optional configuration
-  // Request mocking is automatically initialized by default
-  initTWD(tests, { 
-    open: true, 
-    position: 'left',
-    serviceWorker: true,           // Enable request mocking (default: true)
-    serviceWorkerUrl: '/mock-sw.js' // Custom service worker path (default: '/mock-sw.js')
-  });
-}
+// vite.config.ts
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react'; // or vue, solid, etc.
+import { twd } from 'twd-js/vite-plugin';
+
+export default defineConfig({
+  plugins: [
+    react(),
+    twd({
+      testFilePattern: '/**/*.twd.test.{ts,tsx}',
+      open: true,
+      position: 'left',
+    }),
+  ],
+});
 ```
 
 ### Set Up Mock Service Worker
@@ -65,6 +66,25 @@ If you plan to use API mocking, set up the mock service worker:
 npx twd-js init public
 ```
 
+### Non-Vite projects (Angular, Webpack, etc.)
+
+If your project doesn't use Vite, initialize TWD manually in your dev entry point:
+
+```ts
+// Only load the test sidebar and tests in development mode
+if (import.meta.env.DEV) {
+  const { initTWD } = await import('twd-js/bundled');
+  const tests = import.meta.glob('./**/*.twd.test.ts');
+
+  initTWD(tests, {
+    open: true,
+    position: 'left',
+    serviceWorker: true,             // Enable request mocking (default: true)
+    serviceWorkerUrl: '/mock-sw.js', // Custom service worker path (default: '/mock-sw.js')
+  });
+}
+```
+
 Check the [Framework Integration Guide](https://brikev.github.io/twd/frameworks) for more details.
 
 ## Writing Tests

package/dist/bundled.es.js

@@ -1289,7 +1289,7 @@ var Jn = (e) => {
   }
 };
 window.__testRunner = Gr;
-var $t = "1.7.3", Zn = () => typeof window < "u" ? (window.__TWD_MOCK_STATE__ || (window.__TWD_MOCK_STATE__ = {
+var $t = "1.8.0-beta.1", Zn = () => typeof window < "u" ? (window.__TWD_MOCK_STATE__ || (window.__TWD_MOCK_STATE__ = {
   rules: [],
   counts: {}
 }), window.__TWD_MOCK_STATE__) : {

package/dist/constants/version.d.ts

@@ -1 +1 @@
-export declare const TWD_VERSION = "1.7.3";
+export declare const TWD_VERSION = "1.8.0-beta.1";

package/dist/index.cjs.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var Rl=Object.create,lr=Object.defineProperty,Tl=Object.getOwnPropertyDescriptor,Sl=Object.getOwnPropertyNames,xl=Object.getPrototypeOf,Ol=Object.prototype.hasOwnProperty,P=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),Ml=(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},Al=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(var a=Sl(t),o=0,i=a.length,s;o<i;o++)s=a[o],!Ol.call(e,s)&&s!==r&&lr(e,s,{get:(u=>t[u]).bind(null,s),enumerable:!(n=Tl(t,s))||n.enumerable});return e},In=(e,t,r)=>(r=e!=null?Rl(xl(e)):{},Al(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 oe=require("react"),j=require("react/jsx-runtime");var Il=(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()}),Nl=(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)),te=e=>{const t=Mt.handlers.size?Array.from(Mt.handlers.values()).find(r=>r.status==="running"):null;t&&t.logs?.push(e)},kl=(e,t)=>{const r=t?.timeout??2e3,n=t?.interval??50,a=t?.message;return new Promise((o,i)=>{const s=Date.now();let u=!1;const l=async()=>{try{const c=await e();if(u)return;u=!0,te(a?`waitFor: resolved (${a})`:"waitFor: resolved"),o(c)}catch(c){if(u)return;const d=c instanceof Error?c:new Error(String(c));if(Date.now()-s>=r){u=!0;const p=`waitFor timed out after ${r}ms`,f=a?` waiting for: ${a}`:"",g=`
-Last error: ${d.message}`;i(new Error(`${p}${f}.${g}`));return}setTimeout(l,n)}};l()})},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 ka(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 jl={"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"}},"be.hidden":{positive:{pass:()=>"Assertion passed: Element is hidden",fail:()=>"Assertion failed: Expected element to be hidden"},negative:{pass:()=>"Assertion passed: Element is not hidden",fail:()=>"Assertion failed: Expected element to not be hidden"}},"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]}"`}}},Vr=(e,t,...r)=>{const n=t.startsWith("not."),a=n?t.slice(4):t,o=(e.textContent||"").trim(),i=jl[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=ka(e);break;case"be.hidden":u=!ka(e);break;case"have.class":u=e.classList.contains(r[0]);break;default:throw new Error(`Unknown assertion: ${String(a)}`)}return rn(u,n,i[s].pass(r),i[s].fail(r,l))},Tr="1.7.3",Dl=()=>typeof window<"u"?(window.__TWD_MOCK_STATE__||(window.__TWD_MOCK_STATE__={rules:[],counts:{}}),window.__TWD_MOCK_STATE__):{rules:[],counts:{}},tt=Dl(),Ce=tt.rules,Ll=100,ja=!1,Bl=async e=>{if(ja){console.warn("[TWD] Request mocking already initialized");return}if("serviceWorker"in navigator){ja=!0;const t=e??"/mock-sw.js";await navigator.serviceWorker.register(`${t}?v=${Tr}`),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),tt.counts[n]=o??(tt.counts[n]??0)+1}})}},$l=async(e,t)=>{const r={alias:e,...t,executed:!1},n=Ce.findIndex(a=>a.alias===e);if(n!==-1?Ce[n]=r:Ce.push(r),typeof window.__twdCollectMock=="function"){const a=window.__TWD_STATE__?.handlers,o=a&&[...a.values()].find(i=>i.status==="running");o&&window.__twdCollectMock({alias:e,url:String(t.url),method:t.method,status:t.status||200,response:t.response,responseHeaders:t.responseHeaders,urlRegex:t.urlRegex||!1,testId:o.id})}navigator.serviceWorker.controller?.postMessage({type:"ADD_RULE",rule:r,version:Tr}),await ur(Ll),await Promise.resolve()},Fl=async e=>await Promise.all(e.map(t=>So(t))),So=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(`
+Last error: ${d.message}`;i(new Error(`${p}${f}.${g}`));return}setTimeout(l,n)}};l()})},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 ka(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 jl={"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"}},"be.hidden":{positive:{pass:()=>"Assertion passed: Element is hidden",fail:()=>"Assertion failed: Expected element to be hidden"},negative:{pass:()=>"Assertion passed: Element is not hidden",fail:()=>"Assertion failed: Expected element to not be hidden"}},"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]}"`}}},Vr=(e,t,...r)=>{const n=t.startsWith("not."),a=n?t.slice(4):t,o=(e.textContent||"").trim(),i=jl[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=ka(e);break;case"be.hidden":u=!ka(e);break;case"have.class":u=e.classList.contains(r[0]);break;default:throw new Error(`Unknown assertion: ${String(a)}`)}return rn(u,n,i[s].pass(r),i[s].fail(r,l))},Tr="1.8.0-beta.1",Dl=()=>typeof window<"u"?(window.__TWD_MOCK_STATE__||(window.__TWD_MOCK_STATE__={rules:[],counts:{}}),window.__TWD_MOCK_STATE__):{rules:[],counts:{}},tt=Dl(),Ce=tt.rules,Ll=100,ja=!1,Bl=async e=>{if(ja){console.warn("[TWD] Request mocking already initialized");return}if("serviceWorker"in navigator){ja=!0;const t=e??"/mock-sw.js";await navigator.serviceWorker.register(`${t}?v=${Tr}`),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),tt.counts[n]=o??(tt.counts[n]??0)+1}})}},$l=async(e,t)=>{const r={alias:e,...t,executed:!1},n=Ce.findIndex(a=>a.alias===e);if(n!==-1?Ce[n]=r:Ce.push(r),typeof window.__twdCollectMock=="function"){const a=window.__TWD_STATE__?.handlers,o=a&&[...a.values()].find(i=>i.status==="running");o&&window.__twdCollectMock({alias:e,url:String(t.url),method:t.method,status:t.status||200,response:t.response,responseHeaders:t.responseHeaders,urlRegex:t.urlRegex||!1,testId:o.id})}navigator.serviceWorker.controller?.postMessage({type:"ADD_RULE",rule:r,version:Tr}),await ur(Ll),await Promise.resolve()},Fl=async e=>await Promise.all(e.map(t=>So(t))),So=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)},xo=()=>Ce,Oo=()=>{navigator.serviceWorker.controller?.postMessage({type:"CLEAR_RULES",version:Tr}),Ce.length=0;for(const e in tt.counts)delete tt.counts[e]},Ul=e=>tt.counts[e]??0,zl=()=>({...tt.counts}),Vl=(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}`)}},Hl=()=>({location:window.location,should:async(e,t,r=5)=>{let n="",a;for(let o=0;o<r;o++)try{n=Vl(e,t),te(n);break}catch(i){await new Promise(s=>setTimeout(s,100)),a=i}if(a)throw a;return n}}),Wl=100,Kl=async(e,t)=>{if(te(`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(Wl)},nn="twd-viewport-styles",an="twd-viewport-iframe",fe=null,ut=null,Gl=()=>{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}},Yl=(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.es.js

@@ -260,7 +260,7 @@ var Fl = {
       throw new Error(`Unknown assertion: ${String(a)}`);
   }
   return on(u, n, i[s].pass(r), i[s].fail(r, l));
-}, Mr = "1.7.3", Ul = () => typeof window < "u" ? (window.__TWD_MOCK_STATE__ || (window.__TWD_MOCK_STATE__ = {
+}, Mr = "1.8.0-beta.1", Ul = () => 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.7.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.7.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.8.0-beta.1",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.8.0-beta.1"&&console.warn(`[TWD] ⚠️ Version mismatch detected:
 Client version: ${t}
 Service Worker version: ${u}
 

package/dist/plugin/twd.d.ts

@@ -71,5 +71,17 @@ export interface TwdPluginOptions {
  *   open: false,
  * })
  * ```
+ * @example
+ * ```ts
+ * // Disable the Mock Service Worker (e.g. when the project doesn't use request mocking)
+ * twd({
+ *   serviceWorker: false,
+ * })
+ *
+ * // Or point to a custom service worker path
+ * twd({
+ *   serviceWorkerUrl: '/custom/mock-sw.js',
+ * })
+ * ```
  */
 export declare function twd(options?: TwdPluginOptions): Plugin;

package/dist/vite-plugin.cjs.js

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const w=require("./index.cjs.js");let d=require("fs"),u=require("path");function a(){return{name:"remove-mock-sw",apply:"build",closeBundle(){try{(0,d.rmSync)((0,u.resolve)("dist/mock-sw.js")),console.log("🧹 Removed mock-sw.js from build")}catch{console.log("🧹 No mock-sw.js found in build")}}}}function m(n={}){const{testFilePattern:t=".twd.test.ts"}=n,o=typeof t=="function"?t:e=>e.endsWith(t);return{name:"twd-hmr",apply:"serve",handleHotUpdate({file:e,server:r}){if(o(e))return r.ws.send({type:"full-reload",path:"*"}),[]}}}var i="virtual:twd/init",s=`\0${i}`,p="/**/*.twd.test.ts",f={open:!0,position:"left",serviceWorker:!0,serviceWorkerUrl:"/mock-sw.js"};function v(n={}){const{testFilePattern:t=p,...o}=n,e={...f,...o};return{name:"twd",apply:"serve",resolveId(r){return r===i?s:null},load(r){if(r!==s)return null;const l=JSON.stringify(t),c=JSON.stringify(e);return["import { initTWD } from 'twd-js/bundled';",`const tests = import.meta.glob(${l});`,`initTWD(tests, ${c});`].join(`
-`)},transformIndexHtml(){return[{tag:"script",attrs:{type:"module",src:`/@id/${i}`},injectTo:"head"}]}}}exports.removeMockServiceWorker=a;exports.twd=v;exports.twdHmr=m;
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const T=require("./index.cjs.js");let m=require("fs"),v=require("path");function p(){return{name:"remove-mock-sw",apply:"build",closeBundle(){try{(0,m.rmSync)((0,v.resolve)("dist/mock-sw.js")),console.log("🧹 Removed mock-sw.js from build")}catch{console.log("🧹 No mock-sw.js found in build")}}}}function f(i={}){const{testFilePattern:e=".twd.test.ts"}=i,o=typeof e=="function"?e:t=>t.endsWith(e);return{name:"twd-hmr",apply:"serve",handleHotUpdate({file:t,server:n}){if(o(t))return n.ws.send({type:"full-reload",path:"*"}),[]}}}var c="virtual:twd/init",d=`\0${c}`,w="/**/*.twd.test.ts",u={open:!0,position:"left",serviceWorker:!0,serviceWorkerUrl:"/mock-sw.js"};function k(i={}){const{testFilePattern:e=w,...o}=i,t=o.serviceWorkerUrl!==void 0,n={...u,...o};let s="/";return{name:"twd",apply:"serve",configResolved(r){if(s=r.base,!t&&s!=="/"){const l=u.serviceWorkerUrl.replace(/^\//,"");n.serviceWorkerUrl=`${s}${l}`}},resolveId(r){return r===c?d:null},load(r){if(r!==d)return null;const l=JSON.stringify(e),a=JSON.stringify(n);return["import { initTWD } from 'twd-js/bundled';",`const tests = import.meta.glob(${l});`,`initTWD(tests, ${a});`].join(`
+`)},transformIndexHtml(){return[{tag:"script",attrs:{type:"module",src:`${s}@id/${c}`},injectTo:"head"}]}}}exports.removeMockServiceWorker=p;exports.twd=k;exports.twdHmr=f;

package/dist/vite-plugin.es.js

@@ -1,56 +1,63 @@
-import { rmSync as d } from "fs";
-import { resolve as a } from "path";
-function v() {
+import { rmSync as u } from "fs";
+import { resolve as p } from "path";
+function k() {
   return {
     name: "remove-mock-sw",
     apply: "build",
     closeBundle() {
       try {
-        d(a("dist/mock-sw.js")), console.log("🧹 Removed mock-sw.js from build");
+        u(p("dist/mock-sw.js")), console.log("🧹 Removed mock-sw.js from build");
       } catch {
         console.log("🧹 No mock-sw.js found in build");
       }
     }
   };
 }
-function w(n = {}) {
-  const { testFilePattern: t = ".twd.test.ts" } = n, o = typeof t == "function" ? t : (e) => e.endsWith(t);
+function T(i = {}) {
+  const { testFilePattern: e = ".twd.test.ts" } = i, o = typeof e == "function" ? e : (t) => t.endsWith(e);
   return {
     name: "twd-hmr",
     apply: "serve",
-    handleHotUpdate({ file: e, server: r }) {
-      if (o(e))
-        return r.ws.send({
+    handleHotUpdate({ file: t, server: s }) {
+      if (o(t))
+        return s.ws.send({
           type: "full-reload",
           path: "*"
         }), [];
     }
   };
 }
-var s = "virtual:twd/init", i = `\0${s}`, u = "/**/*.twd.test.ts", m = {
+var c = "virtual:twd/init", d = `\0${c}`, v = "/**/*.twd.test.ts", a = {
   open: !0,
   position: "left",
   serviceWorker: !0,
   serviceWorkerUrl: "/mock-sw.js"
 };
-function T(n = {}) {
-  const { testFilePattern: t = u, ...o } = n, e = {
-    ...m,
+function y(i = {}) {
+  const { testFilePattern: e = v, ...o } = i, t = o.serviceWorkerUrl !== void 0, s = {
+    ...a,
     ...o
   };
+  let n = "/";
   return {
     name: "twd",
     apply: "serve",
+    configResolved(r) {
+      if (n = r.base, !t && n !== "/") {
+        const l = a.serviceWorkerUrl.replace(/^\//, "");
+        s.serviceWorkerUrl = `${n}${l}`;
+      }
+    },
     resolveId(r) {
-      return r === s ? i : null;
+      return r === c ? d : null;
     },
     load(r) {
-      if (r !== i) return null;
-      const l = JSON.stringify(t), c = JSON.stringify(e);
+      if (r !== d) return null;
+      const l = JSON.stringify(e), m = JSON.stringify(s);
       return [
         "import { initTWD } from 'twd-js/bundled';",
         `const tests = import.meta.glob(${l});`,
-        `initTWD(tests, ${c});`
+        `initTWD(tests, ${m});`
       ].join(`
 `);
     },
@@ -59,7 +66,7 @@ function T(n = {}) {
         tag: "script",
         attrs: {
           type: "module",
-          src: `/@id/${s}`
+          src: `${n}@id/${c}`
         },
         injectTo: "head"
       }];
@@ -67,7 +74,7 @@ function T(n = {}) {
   };
 }
 export {
-  v as removeMockServiceWorker,
-  T as twd,
-  w as twdHmr
+  k as removeMockServiceWorker,
+  y as twd,
+  T as twdHmr
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twd-js",
-  "version": "1.8.0-beta.0",
+  "version": "1.8.0-beta.1",
   "description": "Test While Developing (TWD) - in-browser testing",
   "type": "module",
   "license": "MIT",