twd-js 0.3.1 → 0.5.0

package/dist/commands/mockBridge.d.ts

@@ -45,6 +45,16 @@ export declare const initRequestMocking: () => Promise<void>;
  * ```
  */
 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

package/dist/commands/visit.d.ts

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

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export * from './twd';
-export { TWDSidebar } from './ui/TWDSidebar';
+export { initViteLoadTests } from './initializers/viteLoadTests';
 export { expect } from 'chai';
 export { userEvent } from './proxies/userEvent';

package/dist/initializers/initSidebar.d.ts

@@ -0,0 +1,17 @@
+interface Options {
+    open: boolean;
+    position?: 'left' | 'right';
+}
+/**
+ * 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({ open: false, position: 'left' });
+ * ```
+ */
+export declare const initSidebar: (options: Options) => Promise<void>;
+export {};

package/dist/initializers/viteLoadTests.d.ts

@@ -0,0 +1,32 @@
+interface Options {
+    open: boolean;
+    position?: 'left' | 'right';
+}
+/**
+ * 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 options - Options for initializing the test loader.
+ * @example
+ * ```ts
+ * if (import.meta.env.DEV) {
+ *   const testModules = import.meta.glob("./example.twd.test.ts");
+ *   const { initViteLoadTests } = await import('twd-js');
+ *   await initViteLoadTests(testModules, { open: false, position: 'left' });
+ * }
+ * ```
+ */
+export declare const initViteLoadTests: (testModules: TestModule, options: Options) => Promise<void>;
+export {};

package/dist/mock-sw.js

@@ -1 +1 @@
-function i(s,t,l){return l.find(e=>{const n=e.method.toLowerCase()===s.toLowerCase();if(e.urlRegex){const r=new RegExp(e.url);return n&&r.test(t)}const a=e.url===t||t.includes(e.url);return n&&a})}function c(s,t,l){s.forEach(e=>e.postMessage({type:"EXECUTED",alias:t.alias,request:l}))}let o=[];self.addEventListener("fetch",s=>{const{method:t}=s.request,l=s.request.url,e=i(t,l,o);e&&(console.log("Mock hit:",e.alias,t,l),s.respondWith((async()=>{let n=null;try{n=await s.request.clone().text()}catch{}return self.clients.matchAll().then(a=>{c(a,e,n)}),new Response(JSON.stringify(e.response),{status:e.status||200,headers:e.headers||{"Content-Type":"application/json"}})})()))});self.addEventListener("message",s=>{const{type:t,rule:l}=s.data||{};t==="ADD_RULE"&&(o=o.filter(e=>e.alias!==l.alias),o.push(l),console.log("Rule added:",l)),t==="CLEAR_RULES"&&(o=[],console.log("All rules cleared"))});
+function c(t,s,n){return n.find(e=>{const l=e.method.toLowerCase()===t.toLowerCase();if(e.urlRegex){const r=new RegExp(e.url);return l&&r.test(s)}const a=e.url===s||s.includes(e.url);return l&&a})}function i(t,s,n){t.forEach(e=>e.postMessage({type:"EXECUTED",alias:s.alias,request:n}))}let o=[];const u=async t=>{const{method:s}=t.request,n=t.request.url,e=c(s,n,o);e&&(console.log("Mock hit:",e.alias,s,n),t.respondWith((async()=>{let l=null;try{l=await t.request.clone().text()}catch{}return self.clients.matchAll().then(a=>{i(a,e,l)}),new Response(JSON.stringify(e.response),{status:e.status||200,headers:e.headers||{"Content-Type":"application/json"}})})()))},d=t=>{const{type:s,rule:n}=t.data||{};s==="ADD_RULE"&&(o=o.filter(e=>e.alias!==n.alias),o.push(n),console.log("Rule added:",n)),s==="CLEAR_RULES"&&(o=[],console.log("All rules cleared"))};self.addEventListener("fetch",u);self.addEventListener("message",d);

package/dist/proxies/eventsMessage.d.ts

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

package/dist/twd.d.ts

@@ -49,6 +49,20 @@ interface TWDAPI {
      *
      */
     get: (selector: string) => Promise<TWDElemAPI>;
+    /**
+     * 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
@@ -96,6 +110,16 @@ interface TWDAPI {
      * ```
      */
     waitForRequest: (alias: string) => 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.
      *