twd-js 1.6.3 → 1.6.5

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.5",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.5"&&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.5",
   "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",