@rachelallyson/hero-hook-form 1.2.0 → 2.1.0

package/dist/cypress/index.d.ts

@@ -0,0 +1,141 @@
+/**
+ * TypeScript types for Cypress form testing helpers
+ */
+interface FormFieldData {
+    [key: string]: string | number | boolean | string[] | FileList | null;
+}
+interface FormFlowStep {
+    /** Type of interaction */
+    type: 'fill' | 'select' | 'check' | 'uncheck' | 'submit' | 'wait';
+    /** Field identifier (label, type, placeholder, etc.) */
+    field?: string;
+    /** Value to set or option to select */
+    value?: string | number | boolean;
+    /** Expected result after step */
+    expect?: string | boolean;
+    /** Wait time in milliseconds */
+    waitTime?: number;
+}
+interface FieldInteractionOptions {
+    /** Whether to clear field before typing */
+    clear?: boolean;
+    /** Whether to use force click for dropdowns */
+    force?: boolean;
+    /** Whether to wait for field to be visible */
+    waitForVisible?: boolean;
+    /** Custom timeout for this interaction */
+    timeout?: number;
+}
+interface CypressFormHelpers {
+    fillInputByType: (type: string, value: string, index?: number) => Cypress.Chainable<Element>;
+    fillInputByPlaceholder: (placeholder: string, value: string) => Cypress.Chainable<Element>;
+    fillInputByLabel: (label: string, value: string) => Cypress.Chainable<Element>;
+    fillTextarea: (value: string, index?: number) => Cypress.Chainable<Element>;
+    selectDropdownOption: (optionValue: string, dropdownIndex?: number) => Cypress.Chainable<Element>;
+    selectDropdownByLabel: (label: string, optionValue: string) => Cypress.Chainable<Element>;
+    checkCheckbox: (index?: number) => Cypress.Chainable<Element>;
+    checkCheckboxByLabel: (label: string) => Cypress.Chainable<Element>;
+    checkSwitch: (index?: number) => Cypress.Chainable<Element>;
+    uncheckCheckbox: (index?: number) => Cypress.Chainable<Element>;
+    uncheckSwitch: (index?: number) => Cypress.Chainable<Element>;
+    moveSlider: (value: number, index?: number) => Cypress.Chainable<Element>;
+    expectValidationError: (message: string) => Cypress.Chainable<Element>;
+    expectNoValidationErrors: () => Cypress.Chainable<Element>;
+    expectFieldError: (fieldLabel: string, errorMessage: string) => Cypress.Chainable<Element>;
+    expectFieldValid: (fieldLabel: string) => Cypress.Chainable<Element>;
+    triggerValidation: (submitButton?: boolean) => Cypress.Chainable<Element>;
+    submitForm: () => Cypress.Chainable<Element>;
+    submitAndExpectSuccess: (successIndicator?: string) => Cypress.Chainable<Element>;
+    submitAndExpectErrors: () => Cypress.Chainable<Element>;
+    resetForm: () => Cypress.Chainable<Element>;
+    interceptFormSubmission: (method: string, url: string, alias: string) => Cypress.Chainable<Element>;
+    verifyFormExists: () => Cypress.Chainable<Element>;
+    verifyFieldExists: (selector: string) => Cypress.Chainable<Element>;
+    verifyFieldValue: (selector: string, value: string) => Cypress.Chainable<Element>;
+    verifyFieldCount: (selector: string, count: number) => Cypress.Chainable<Element>;
+    getFormData: () => Cypress.Chainable<FormFieldData>;
+    fillCompleteForm: (formData: FormFieldData) => Cypress.Chainable<Element>;
+    testFieldInteraction: (fieldType: string, value: string) => Cypress.Chainable<Element>;
+    testFormFlow: (steps: FormFlowStep[]) => Cypress.Chainable<Element>;
+}
+declare global {
+    namespace Cypress {
+        interface Chainable extends CypressFormHelpers {
+        }
+    }
+}
+
+/**
+ * TypeScript declarations for Cypress form testing helpers
+ */
+
+
+
+declare global {
+  namespace Cypress {
+    interface Chainable {
+      // Field Interaction Helpers
+      fillInputByType(type: string, value: string, index?: number, options?: FieldInteractionOptions): Chainable<Element>;
+      fillInputByPlaceholder(placeholder: string, value: string, options?: FieldInteractionOptions): Chainable<Element>;
+      fillInputByLabel(label: string, value: string, options?: FieldInteractionOptions): Chainable<Element>;
+      fillTextarea(value: string, index?: number, options?: FieldInteractionOptions): Chainable<Element>;
+      selectDropdownOption(optionValue: string, dropdownIndex?: number): Chainable<Element>;
+      selectDropdownByLabel(label: string, optionValue: string): Chainable<Element>;
+      checkCheckbox(index?: number): Chainable<Element>;
+      checkCheckboxByLabel(label: string): Chainable<Element>;
+      checkSwitch(index?: number): Chainable<Element>;
+      uncheckCheckbox(index?: number): Chainable<Element>;
+      uncheckSwitch(index?: number): Chainable<Element>;
+      moveSlider(value: number, index?: number): Chainable<Element>;
+      
+      // Validation & Error Testing Helpers
+      expectValidationError(message: string): Chainable<Element>;
+      expectNoValidationErrors(): Chainable<Element>;
+      expectFieldError(fieldLabel: string, errorMessage?: string): Chainable<Element>;
+      expectFieldValid(fieldLabel: string): Chainable<Element>;
+      triggerValidation(submitButton?: string): Chainable<Element>;
+      testRealTimeValidation(fieldLabel: string, invalidValue: string, expectedError?: string): Chainable<Element>;
+      testRequiredFieldValidation(fieldLabel: string, expectedError?: string): Chainable<Element>;
+      testEmailValidation(email: string, shouldBeValid: boolean): Chainable<Element>;
+      testPhoneValidation(phone: string, shouldBeValid: boolean): Chainable<Element>;
+      testPasswordValidation(password: string, shouldBeValid: boolean): Chainable<Element>;
+      testRequiredFieldsValidation(): Chainable<Element>;
+      
+      // Form Submission Helpers
+      submitForm(): Chainable<Element>;
+      submitAndExpectSuccess(successIndicator?: string): Chainable<Element>;
+      submitAndExpectErrors(): Chainable<Element>;
+      resetForm(): Chainable<Element>;
+      interceptFormSubmission(method: string, url: string, alias: string): Chainable<Element>;
+      
+      // Form State Helpers
+      verifyFormExists(): Chainable<Element>;
+      verifyFieldExists(selector: string): Chainable<Element>;
+      verifyFieldValue(selector: string, value: string): Chainable<Element>;
+      verifyFieldCount(selector: string, count: number): Chainable<Element>;
+      getFormData(): Chainable<FormFieldData>;
+      
+      // Complex Form Flow Helpers
+      fillCompleteForm(formData: FormFieldData): Chainable<Element>;
+      testFieldInteraction(fieldType: string, value: string): Chainable<Element>;
+      testFormFlow(steps: FormFlowStep[]): Chainable<Element>;
+      
+      // Legacy commands (backward compatibility)
+      fillField(label: string, value: string): Chainable<Element>;
+      selectOption(label: string, option: string): Chainable<Element>;
+      
+      // Convenience commands
+      fillEmail(value: string): Chainable<Element>;
+      fillPhone(value: string): Chainable<Element>;
+      fillPassword(value: string): Chainable<Element>;
+      fillText(value: string): Chainable<Element>;
+      
+      // Debug commands
+      logFormState(): Chainable<Element>;
+      waitForFormReady(): Chainable<Element>;
+      clearForm(): Chainable<Element>;
+      verifyFormValid(): Chainable<Element>;
+      screenshotForm(name?: string): Chainable<Element>;
+    }
+  }
+}