twd-js 0.1.1 → 0.1.2

package/dist/asserts/index.d.ts

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

package/dist/commands/url.d.ts

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

package/dist/twd-types.d.ts

@@ -50,16 +50,25 @@ export type ArgsFor<A extends AnyAssertion> = A extends `not.${infer Base extend
  */
 export 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;
@@ -122,7 +131,7 @@ export interface TWDElemAPI {
     text: () => string;
     /**
      * Asserts something about the element.
-     * @param anyAssertion The assertion to run.
+     * @param name The name of the assertion.
      * @param args Arguments for the assertion.
      * @returns The same API for chaining.
      *

package/dist/twd.d.ts

@@ -1,5 +1,6 @@
 import { Options, Rule } from './commands/mockResponses';
 import { TWDElemAPI } from './twd-types';
+import { URLCommandAPI } from './commands/url';
 /**
  * Stores the function to run before each test.
  */
@@ -95,6 +96,17 @@ interface TWDAPI {
      * ```
      */
     waitFor: (alias: string) => Promise<Rule>;
+    /**
+     * URL-related assertions.
+     *
+     * @example
+     * ```ts
+     * twd.url().should("eq", "http://localhost:3000/contact");
+     * twd.url().should("contain.url", "/contact");
+     *
+     * ```
+     */
+    url: () => URLCommandAPI;
 }
 /**
  * Mini Cypress-style helpers for DOM testing.