@shopware-ag/acceptance-test-suite 12.14.0 → 12.15.0

package/dist/index.d.mts

@@ -1,21 +1,13 @@
+import { components } from '@shopware/api-client/admin-api-types';
+import * as playwright_core from 'playwright-core';
+import { APIRequestContext, APIResponse, BrowserContext, Page, Locator } from 'playwright-core';
+export { APIRequestContext, APIResponse, BrowserContext, Locator, Page, Request } from 'playwright-core';
 import * as axe_core from 'axe-core';
 import * as playwright_test from '@playwright/test';
 import { Page as Page$1, Locator as Locator$1, Browser } from '@playwright/test';
 export { expect, mergeTests } from '@playwright/test';
-import * as playwright_core from 'playwright-core';
-import { APIRequestContext, APIResponse, Page, Locator, BrowserContext } from 'playwright-core';
-export { APIRequestContext, APIResponse, BrowserContext, Locator, Page, Request } from 'playwright-core';
-import { components } from '@shopware/api-client/admin-api-types';
 import { Image } from 'image-js';
 
-declare global {
-    namespace PlaywrightTest {
-        interface Matchers<R> {
-            toHaveVisibleFocus(): Promise<R>;
-        }
-    }
-}
-
 interface RequestOptions$1<PAYLOAD> {
     [key: string]: unknown;
     data?: PAYLOAD;
@@ -54,6 +46,99 @@ declare class AdminApiContext {
     private handleRequest;
 }
 
+interface RequestOptions<PAYLOAD> {
+    [key: string]: unknown;
+    data?: PAYLOAD;
+}
+interface StoreUser {
+    email: string;
+    password: string;
+}
+interface StoreApiContextOptions {
+    app_url?: string;
+    "sw-access-key"?: string;
+    "sw-context-token"?: string;
+    ignoreHTTPSErrors?: boolean;
+}
+declare class StoreApiContext {
+    private context;
+    private readonly options;
+    private static readonly defaultOptions;
+    constructor(context: APIRequestContext, options: StoreApiContextOptions);
+    static create(options?: StoreApiContextOptions): Promise<StoreApiContext>;
+    private static createContext;
+    login(user: StoreUser): Promise<{
+        [key: string]: string;
+    }>;
+    get<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
+    post<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
+    patch<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
+    delete<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
+    fetch<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
+    head<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
+}
+
+interface Email {
+    fromName: string;
+    fromAddress: string;
+    toName: string;
+    toAddress: string;
+    subject: string;
+    emailId: string;
+}
+declare class MailpitApiContext {
+    context: APIRequestContext;
+    constructor(context: APIRequestContext);
+    /**
+     * Fetches email headers based on the recipient's email address.
+     * @param email - The email address of the recipient.
+     * @returns An Email object containing the email headers.
+     */
+    getEmailHeaders(email: string): Promise<Email>;
+    /**
+     * Retrieves the body content of the email as an HTML string.
+     * @param email - The email address of the recipient.
+     * @returns A promise that resolves to the HTML content of the email.
+     */
+    getEmailBody(email: string): Promise<string>;
+    /**
+     * Generates the full email content, combining headers and body.
+     * @param email - The email address to fetch headers for.
+     * @returns A promise that resolves to the full email content as a string.
+     */
+    generateEmailContent(email: string): Promise<string>;
+    /**
+     * Retrieves the plain text content of the email.
+     * @param email - The email address of the recipient.
+     * @returns A promise that resolves to the plain text content of the email.
+     */
+    getRenderMessageTxt(email: string): Promise<string>;
+    /**
+     * Extracts the first URL found in the plain text content of the latest email.
+     * @param email - The email address of the recipient.
+     * @returns A promise that resolves to the first URL found in the email content.
+     * @throws An error if no URL is found in the email content.
+     */
+    getLinkFromMail(email: string): Promise<string>;
+    /**
+     * Deletes a specific email by ID if provided, or deletes all emails if no ID is provided.
+     * @param emailId - The ID of the email to delete (optional).
+     */
+    deleteMail(emailId?: string): Promise<void>;
+    /**
+     * Creates a new MailpitApiContext instance with the appropriate configuration.
+     * @param baseURL - The base URL for the API.
+     * @returns A promise that resolves to a MailpitApiContext instance.
+     */
+    static create(baseURL: string): Promise<MailpitApiContext>;
+}
+
+interface ApiContextTypes {
+    AdminApiContext: AdminApiContext;
+    StoreApiContext: StoreApiContext;
+    MailpitApiContext: MailpitApiContext;
+}
+
 type SalesChannel = components["schemas"]["SalesChannel"] & {
     id: string;
 };
@@ -382,125 +467,38 @@ interface Flow {
     ];
 }
 
-declare const COUNTRY_ADDRESS_DATA: {
-    DE: {
-        street: string;
-        city: string;
-        country: string;
-        postalCode: string;
-        vatRegNo: string;
-    };
-    US: {
-        street: string;
-        city: string;
-        country: string;
-        postalCode: string;
-        vatRegNo: string;
-    };
-    GB: {
-        street: string;
-        city: string;
-        country: string;
-        postalCode: string;
-        vatRegNo: string;
-    };
-};
-declare const getCountryAddressData: (countryCode?: string) => {
-    street: string;
-    city: string;
-    country: string;
-    postalCode: string;
-    vatRegNo: string;
-};
-declare const getLocale: () => string;
-declare const getLanguageCode: (locale?: string) => string;
-declare const getCountryCodeFromLocale: (locale?: string) => string;
-declare const getCurrencyCodeFromLocale: (locale?: string) => string;
-declare const getCurrencySymbolFromLocale: (locale?: string) => string;
-declare const formatPrice: (price: number, locale?: string, currencyCode?: string) => string;
-type Language$1 = components["schemas"]["Language"] & {
-    id: string;
-    translationCode: components["schemas"]["Locale"] & {
-        id: string;
-    };
-};
-declare const getLanguageData: (adminApiContext: AdminApiContext, languageCode?: string) => Promise<Language$1>;
-declare const getSnippetSetId: (adminApiContext: AdminApiContext, languageCode?: string) => Promise<string>;
-type Currency$1 = components["schemas"]["Currency"] & {
-    id: string;
-};
-declare const getCurrency: (adminApiContext: AdminApiContext, isoCode?: string) => Promise<Currency$1>;
-declare const getTaxId: (adminApiContext: AdminApiContext) => Promise<string>;
-declare const getPaymentMethodId: (adminApiContext: AdminApiContext, handlerId?: string) => Promise<string>;
-/**
- * Gives the default shipping method back called Standard
- * @param adminApiContext - An AdminApiContext entity
- *
- * @deprecated - Use getShippingMethodId instead
- */
-declare const getDefaultShippingMethodId: (adminApiContext: AdminApiContext) => Promise<string>;
-declare const getShippingMethodId: (name: string, adminApiContext: AdminApiContext) => Promise<string>;
-declare const getCountryId: (iso2: string, adminApiContext: AdminApiContext) => Promise<string>;
-declare const getThemeId: (technicalName: string, adminApiContext: AdminApiContext) => Promise<string>;
-declare const getSalutationId: (salutationKey: string, adminApiContext: AdminApiContext) => Promise<string>;
-declare const getStateMachineId: (technicalName: string, adminApiContext: AdminApiContext) => Promise<string>;
-declare const getStateMachineStateId: (stateMachineId: string, adminApiContext: AdminApiContext) => Promise<string>;
-declare const getFlowId: (flowName: string, adminApiContext: AdminApiContext) => Promise<string>;
-declare const getOrderTransactionId: (orderId: string, adminApiContext: AdminApiContext) => Promise<{
-    id: string;
-}>;
-declare const getMediaId: (fileName: string, adminApiContext: AdminApiContext) => Promise<string>;
-declare const getFlowTemplate: (flowTemplateId: string, adminApiContext: AdminApiContext) => Promise<FlowTemplate>;
-declare const getFlow: (flowId: string, adminApiContext: AdminApiContext) => Promise<Flow>;
-declare const compareFlowTemplateWithFlow: (flowId: string, flowTemplateId: string, adminApiContext: AdminApiContext) => Promise<boolean>;
-declare function extractIdFromUrl(url: string): string | null;
-type OrderStatus = "cancel" | "complete" | "reopen" | "process";
-declare const setOrderStatus: (orderId: string, orderStatus: OrderStatus, adminApiContext: AdminApiContext) => Promise<APIResponse>;
-/**
- * Return a single promotion entity with a fetched single discount entity
- */
-declare const getPromotionWithDiscount: (promotionId: string, adminApiContext: AdminApiContext) => Promise<Promotion>;
-declare const updateAdminUser: (adminUserId: string, adminApiContext: AdminApiContext, data: Record<string, string | boolean>) => Promise<void>;
-
-interface RequestOptions<PAYLOAD> {
-    [key: string]: unknown;
-    data?: PAYLOAD;
-}
-interface StoreUser {
-    email: string;
-    password: string;
-}
-interface StoreApiContextOptions {
-    app_url?: string;
-    "sw-access-key"?: string;
-    "sw-context-token"?: string;
-    ignoreHTTPSErrors?: boolean;
+interface AdminSession {
+    context: BrowserContext;
+    user: User;
 }
-declare class StoreApiContext {
-    private context;
-    private readonly options;
-    private static readonly defaultOptions;
-    constructor(context: APIRequestContext, options: StoreApiContextOptions);
-    static create(options?: StoreApiContextOptions): Promise<StoreApiContext>;
-    private static createContext;
-    login(user: StoreUser): Promise<{
-        [key: string]: string;
-    }>;
-    get<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
-    post<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
-    patch<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
-    delete<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
-    fetch<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
-    head<PAYLOAD>(url: string, options?: RequestOptions<PAYLOAD>): Promise<APIResponse>;
+interface PageContextTypes {
+    AdminSession: AdminSession;
+    AdminPage: Page;
+    StorefrontPage: Page;
+    InstallPage: Page;
+    page: Page;
+    context: BrowserContext;
 }
 
-declare const isSaaSInstance: (adminApiContext: AdminApiContext) => Promise<boolean>;
-declare const isPaaSInstance: () => boolean;
-declare const isThemeCompiled: (context: StoreApiContext, storefrontUrl: string) => Promise<boolean>;
+declare class Actor {
+    page: Page;
+    readonly name: string;
+    baseURL: string | undefined;
+    constructor(name: string, page: Page, baseURL?: string);
+    expects: playwright_test.Expect<{}>;
+    a11y_checks(locator: Locator): Promise<void>;
+    fillsIn(locator: Locator, input: string): Promise<void>;
+    presses(locator: Locator, key?: string): Promise<void>;
+    selectsRadioButton(radioGroup: Locator, inputLabel: string): Promise<void>;
+    attemptsTo(task: () => Promise<void>): Promise<void>;
+    goesTo(url: string, forceReload?: boolean): Promise<void>;
+    private camelCaseToLowerCase;
+}
 
-declare function createRandomImage(width?: number, height?: number): Image;
-declare function createSolidColorImage(width?: number, height?: number, color?: [number, number, number]): Image;
-declare function encodeImage(image: Image): Buffer<ArrayBuffer>;
+interface ActorFixtureTypes {
+    ShopCustomer: Actor;
+    ShopAdmin: Actor;
+}
 
 interface IdPair {
     id: string;
@@ -615,6 +613,10 @@ declare class TestDataService {
      * Creates a digital product with a text file as its download.
      * The product will be added to the default sales channel category if configured.
      *
+     * Digital products default to `maxPurchase: 1`, mirroring the Administration
+     * which forces this limit when a product is created as a digital type.
+     * Pass `maxPurchase` in the overrides to change it.
+     *
      * @param content - The content of the text file for the product download.
      * @param overrides - Specific data overrides that will be applied to the product data struct.
      * @param taxId - The uuid of the tax rule to use for the product pricing.
@@ -1259,76 +1261,9 @@ declare class TestDataService {
     getBasicProductReviewStruct(productId: string, overrides?: Partial<ProductReview>): Partial<ProductReview>;
 }
 
-/**
- * Hides elements (via `visibility: hidden`).
- */
-declare function hideElements(page: Page, selectors: (string | Locator)[]): Promise<void>;
-/**
- * Replaces text content or input values of elements with a given replacement string (default: "***").
- * - Works for inputs, textareas, contenteditables and generic elements.
- * - Ensures frameworks see the change (dispatches input/change).
- * - Also masks placeholder so empty fields show replacement text in screenshots.
- */
-declare function replaceElements(page: Page, selectors: (string | Locator)[], replaceWith?: string): Promise<void>;
-interface ReplaceTarget {
-    selector: string | Locator;
-    replaceWith?: string;
-}
-/**
- * Replaces elements individually based on an array of targets.
- *
- *@param page - Playwright page
- *@param targets - Array of objects containing selectors and optional replacement strings.
- */
-declare function replaceElementsIndividually(page: Page, targets: ReplaceTarget[]): Promise<void>;
-/**
- * Calculates the ideal viewport dimensions for a Playwright test based on scrollable content,
- * header visibility, and optional configuration. Useful for dynamic screenshot sizing or
- * testing long-scrolling pages.
- *
- * This function:
- * - Optionally waits for a network request (`requestURL`) before continuing.
- * - Optionally waits for a specific locator (`waitForLocator`) to become visible.
- * - Measures scrollable content height (`scrollableElementVertical`) and header height.
- * - Measures scrollable content width (`scrollableElementHorizontal`).
- * - Falls back to defaults if elements are not found or inaccessible.
- *
- * @param {Page} page - The Playwright `Page` object representing the current browser tab.
- * @param {Options} [options] - Optional configuration to override default behavior.
- * @param {string} [options.requestURL] - A URL substring to wait for via `waitForResponse`.
- * @param {number} [options.width] - Base viewport width to use (default: 1440).
- * @param {string | Locator} [options.scrollableElementVertical] - Selector or Locator for vertical scroll container.
- * @param {string | Locator} [options.scrollableElementHorizontal] - Selector or Locator for horizontal scroll container.
- * @param {number} [options.additionalHeight] - Extra height to add (e.g., to avoid cut-off).
- * @param {string | Locator} [options.waitForSelector] - A selector or Locator to wait for visibility before measuring.
- * @param {number} [options.contentHeight] - Default vertical height fallback if measurement fails.
- * @param {number} [options.headerHeight] - Default header height fallback.
- * @param {string} [options.headerElement] - Selector for a header element whose height should be added if outside scrollable container.
- *
- * @returns {Promise<{ contentWidth: number; totalHeight: number }>} - A Promise resolving to the measured dimensions:
- *   - `contentWidth`: the horizontal scroll width or fallback.
- *   - `totalHeight`: sum of content height, header height, and any additional height.
- */
-interface Options {
-    requestURL?: string;
-    width?: number;
-    scrollableElementVertical?: string | Locator;
-    scrollableElementHorizontal?: string | Locator;
-    additionalHeight?: number;
-    waitForSelector?: string | Locator;
-    contentHeight?: number;
-    headerHeight?: number;
-    headerElement?: string;
+interface TestDataFixtureTypes {
+    TestDataService: TestDataService;
 }
-declare function setViewport(page: Page, options?: Options): Promise<void>;
-/**
- * Takes a screenshot of the desktop content of the page or the provided locator and compares it to existing ones.
- *
- * @param page - Playwright page object
- * @param filename - Filename of the screenshot
- * @param locator - Optional Playwright locator to take a screenshot of instead of the desktop content
- */
-declare function assertScreenshot(page: Page, filename: string, locator?: Locator): Promise<void>;
 
 declare const BUNDLED_RESOURCES: {
     readonly en: {
@@ -4413,184 +4348,55 @@ declare const baseNamespaces: {
             title: string;
             message: string;
             backToShop: string;
-        };
-        readonly payment: {
-            methods: {
-                cashOnDelivery: string;
-                paidInAdvance: string;
-                invoice: string;
-            };
-            actions: {
-                change: string;
-                completePayment: string;
-            };
-        };
-        readonly recover: {
-            passwordRecovery: string;
-            subtitle: string;
-            requestEmail: string;
-            back: string;
-            emailSent: string;
-            newPassword: string;
-            passwordConfirmation: string;
-            changePassword: string;
-            invalidLink: string;
-        };
-        readonly offCanvasCart: {
-            general: {
-                title: string;
-            };
-            buttons: {
-                goToCheckout: string;
-                goToCart: string;
-                continueShopping: string;
-            };
-        };
-        readonly wishlist: {
-            removeProduct: string;
-        };
-    };
-};
-
-/** Flatten nested JSON keys to "a.b.c" */
-type Paths<T> = T extends object ? {
-    [K in keyof T & string]: T[K] extends object ? `${K}` | `${K}.${Paths<T[K]>}` : K;
-}[keyof T & string] : never;
-type TranslationKey<TNamespaces = typeof baseNamespaces> = TNamespaces extends Record<string, unknown> ? {
-    [A in keyof TNamespaces]: {
-        [N in keyof TNamespaces[A]]: `${A & string}:${N & string}:${Paths<TNamespaces[A][N]>}`;
-    }[keyof TNamespaces[A]];
-}[keyof TNamespaces] : never;
-type TranslateFn<TKey extends string = TranslationKey> = (key: TKey, options?: Record<string, unknown>) => string;
-
-declare class LanguageHelper {
-    private readonly i18nInstance;
-    private currentLng;
-    private readonly fallbackLng;
-    private readonly resources;
-    private constructor();
-    getLanguage(): string;
-    setLanguage(rawLanguage: string): Promise<void>;
-    translate(key: TranslationKey, options?: Record<string, unknown>): string;
-    static createInstance(rawLanguage: string, customResources?: typeof BUNDLED_RESOURCES): Promise<LanguageHelper>;
-    static setForContext(context: Record<string, unknown>, instance: LanguageHelper): void;
-    static getFromContext(context: Record<string, unknown>): LanguageHelper | undefined;
-}
-declare function setCurrentContext(context: Record<string, unknown> | null): void;
-declare function getCurrentContext(): Record<string, unknown> | null;
-declare function translate(key: TranslationKey, options?: Record<string, unknown>): string;
-
-/**
- * Service to interact with feature flags
- */
-declare class FeatureService {
-    private readonly apiContext;
-    private features;
-    private resetFeatures;
-    constructor(apiContext: AdminApiContext);
-    enable(name: string | string[]): Promise<void>;
-    disable(name: string | string[]): Promise<void>;
-    isEnabled(name: string): Promise<boolean>;
-    private loadFeatures;
-    cleanup(): Promise<void>;
-}
-
-declare const clearDelayedCache: (adminApiContext: AdminApiContext) => Promise<void>;
-
-declare function mockApiCalls(page: Page): Promise<void>;
-
-declare class Actor {
-    page: Page;
-    readonly name: string;
-    baseURL: string | undefined;
-    constructor(name: string, page: Page, baseURL?: string);
-    expects: playwright_test.Expect<{}>;
-    a11y_checks(locator: Locator): Promise<void>;
-    fillsIn(locator: Locator, input: string): Promise<void>;
-    presses(locator: Locator, key?: string): Promise<void>;
-    selectsRadioButton(radioGroup: Locator, inputLabel: string): Promise<void>;
-    attemptsTo(task: () => Promise<void>): Promise<void>;
-    goesTo(url: string, forceReload?: boolean): Promise<void>;
-    private camelCaseToLowerCase;
-}
-
-interface Email {
-    fromName: string;
-    fromAddress: string;
-    toName: string;
-    toAddress: string;
-    subject: string;
-    emailId: string;
-}
-declare class MailpitApiContext {
-    context: APIRequestContext;
-    constructor(context: APIRequestContext);
-    /**
-     * Fetches email headers based on the recipient's email address.
-     * @param email - The email address of the recipient.
-     * @returns An Email object containing the email headers.
-     */
-    getEmailHeaders(email: string): Promise<Email>;
-    /**
-     * Retrieves the body content of the email as an HTML string.
-     * @param email - The email address of the recipient.
-     * @returns A promise that resolves to the HTML content of the email.
-     */
-    getEmailBody(email: string): Promise<string>;
-    /**
-     * Generates the full email content, combining headers and body.
-     * @param email - The email address to fetch headers for.
-     * @returns A promise that resolves to the full email content as a string.
-     */
-    generateEmailContent(email: string): Promise<string>;
-    /**
-     * Retrieves the plain text content of the email.
-     * @param email - The email address of the recipient.
-     * @returns A promise that resolves to the plain text content of the email.
-     */
-    getRenderMessageTxt(email: string): Promise<string>;
-    /**
-     * Extracts the first URL found in the plain text content of the latest email.
-     * @param email - The email address of the recipient.
-     * @returns A promise that resolves to the first URL found in the email content.
-     * @throws An error if no URL is found in the email content.
-     */
-    getLinkFromMail(email: string): Promise<string>;
-    /**
-     * Deletes a specific email by ID if provided, or deletes all emails if no ID is provided.
-     * @param emailId - The ID of the email to delete (optional).
-     */
-    deleteMail(emailId?: string): Promise<void>;
-    /**
-     * Creates a new MailpitApiContext instance with the appropriate configuration.
-     * @param baseURL - The base URL for the API.
-     * @returns A promise that resolves to a MailpitApiContext instance.
-     */
-    static create(baseURL: string): Promise<MailpitApiContext>;
-}
-
-interface ApiContextTypes {
-    AdminApiContext: AdminApiContext;
-    StoreApiContext: StoreApiContext;
-    MailpitApiContext: MailpitApiContext;
-}
-
-interface PageContextTypes {
-    AdminPage: Page;
-    StorefrontPage: Page;
-    InstallPage: Page;
-    page: Page;
-    context: BrowserContext;
-}
-
-interface ActorFixtureTypes {
-    ShopCustomer: Actor;
-    ShopAdmin: Actor;
-}
+        };
+        readonly payment: {
+            methods: {
+                cashOnDelivery: string;
+                paidInAdvance: string;
+                invoice: string;
+            };
+            actions: {
+                change: string;
+                completePayment: string;
+            };
+        };
+        readonly recover: {
+            passwordRecovery: string;
+            subtitle: string;
+            requestEmail: string;
+            back: string;
+            emailSent: string;
+            newPassword: string;
+            passwordConfirmation: string;
+            changePassword: string;
+            invalidLink: string;
+        };
+        readonly offCanvasCart: {
+            general: {
+                title: string;
+            };
+            buttons: {
+                goToCheckout: string;
+                goToCart: string;
+                continueShopping: string;
+            };
+        };
+        readonly wishlist: {
+            removeProduct: string;
+        };
+    };
+};
 
-interface TestDataFixtureTypes {
-    TestDataService: TestDataService;
-}
+/** Flatten nested JSON keys to "a.b.c" */
+type Paths<T> = T extends object ? {
+    [K in keyof T & string]: T[K] extends object ? `${K}` | `${K}.${Paths<T[K]>}` : K;
+}[keyof T & string] : never;
+type TranslationKey<TNamespaces = typeof baseNamespaces> = TNamespaces extends Record<string, unknown> ? {
+    [A in keyof TNamespaces]: {
+        [N in keyof TNamespaces[A]]: `${A & string}:${N & string}:${Paths<TNamespaces[A][N]>}`;
+    }[keyof TNamespaces[A]];
+}[keyof TNamespaces] : never;
+type TranslateFn<TKey extends string = TranslationKey> = (key: TKey, options?: Record<string, unknown>) => string;
 
 type FeaturesType = Record<string, boolean>;
 interface HelperFixtureTypes {
@@ -4609,10 +4415,10 @@ interface HelperFixtureTypes {
 interface Country {
     id: string;
 }
-interface Currency {
+interface Currency$1 {
     id: string;
 }
-interface Language {
+interface Language$1 {
     id: string;
     translationCode: {
         id: string;
@@ -4635,8 +4441,8 @@ interface Theme {
 }
 interface ShopwareDataFixtureTypes {
     Country: Country;
-    Currency: Currency;
-    Language: Language;
+    Currency: Currency$1;
+    Language: Language$1;
     PaymentMethod: PaymentMethod;
     ShippingMethod: ShippingMethod;
     SnippetSet: SnippetSet;
@@ -5509,7 +5315,7 @@ declare class CustomerGroupListing implements PageObject {
     readonly page: Page;
     constructor(page: Page);
     getCustomerGroupByName(customerGroup: string): Promise<Record<string, Locator>>;
-    url(): string;
+    url(searchTerms?: string[], page?: number): string;
 }
 
 declare class CustomerGroupCreate implements PageObject {
@@ -6654,6 +6460,21 @@ interface DataFixtureTypes {
     TagData: components["schemas"]["Tag"];
 }
 
+/**
+ * Service to interact with feature flags
+ */
+declare class FeatureService {
+    private readonly apiContext;
+    private features;
+    private resetFeatures;
+    constructor(apiContext: AdminApiContext);
+    enable(name: string | string[]): Promise<void>;
+    disable(name: string | string[]): Promise<void>;
+    isEnabled(name: string): Promise<boolean>;
+    private loadFeatures;
+    cleanup(): Promise<void>;
+}
+
 interface FeatureFixtureTypes {
     FeatureService: FeatureService;
 }
@@ -6691,6 +6512,194 @@ interface DefaultSalesChannelTypes {
     };
 }
 
+declare global {
+    namespace PlaywrightTest {
+        interface Matchers<R> {
+            toHaveVisibleFocus(): Promise<R>;
+        }
+    }
+}
+
+declare const COUNTRY_ADDRESS_DATA: {
+    DE: {
+        street: string;
+        city: string;
+        country: string;
+        postalCode: string;
+        vatRegNo: string;
+    };
+    US: {
+        street: string;
+        city: string;
+        country: string;
+        postalCode: string;
+        vatRegNo: string;
+    };
+    GB: {
+        street: string;
+        city: string;
+        country: string;
+        postalCode: string;
+        vatRegNo: string;
+    };
+};
+declare const getCountryAddressData: (countryCode?: string) => {
+    street: string;
+    city: string;
+    country: string;
+    postalCode: string;
+    vatRegNo: string;
+};
+declare const getLocale: () => string;
+declare const getLanguageCode: (locale?: string) => string;
+declare const getCountryCodeFromLocale: (locale?: string) => string;
+declare const getCurrencyCodeFromLocale: (locale?: string) => string;
+declare const getCurrencySymbolFromLocale: (locale?: string) => string;
+declare const formatPrice: (price: number, locale?: string, currencyCode?: string) => string;
+type Language = components["schemas"]["Language"] & {
+    id: string;
+    translationCode: components["schemas"]["Locale"] & {
+        id: string;
+    };
+};
+declare const getLanguageData: (adminApiContext: AdminApiContext, languageCode?: string) => Promise<Language>;
+declare const getSnippetSetId: (adminApiContext: AdminApiContext, languageCode?: string) => Promise<string>;
+type Currency = components["schemas"]["Currency"] & {
+    id: string;
+};
+declare const getCurrency: (adminApiContext: AdminApiContext, isoCode?: string) => Promise<Currency>;
+declare const getTaxId: (adminApiContext: AdminApiContext) => Promise<string>;
+declare const getPaymentMethodId: (adminApiContext: AdminApiContext, handlerId?: string) => Promise<string>;
+/**
+ * Gives the default shipping method back called Standard
+ * @param adminApiContext - An AdminApiContext entity
+ *
+ * @deprecated - Use getShippingMethodId instead
+ */
+declare const getDefaultShippingMethodId: (adminApiContext: AdminApiContext) => Promise<string>;
+declare const getShippingMethodId: (name: string, adminApiContext: AdminApiContext) => Promise<string>;
+declare const getCountryId: (iso2: string, adminApiContext: AdminApiContext) => Promise<string>;
+declare const getThemeId: (technicalName: string, adminApiContext: AdminApiContext) => Promise<string>;
+declare const getSalutationId: (salutationKey: string, adminApiContext: AdminApiContext) => Promise<string>;
+declare const getStateMachineId: (technicalName: string, adminApiContext: AdminApiContext) => Promise<string>;
+declare const getStateMachineStateId: (stateMachineId: string, adminApiContext: AdminApiContext) => Promise<string>;
+declare const getFlowId: (flowName: string, adminApiContext: AdminApiContext) => Promise<string>;
+declare const getOrderTransactionId: (orderId: string, adminApiContext: AdminApiContext) => Promise<{
+    id: string;
+}>;
+declare const getMediaId: (fileName: string, adminApiContext: AdminApiContext) => Promise<string>;
+declare const getFlowTemplate: (flowTemplateId: string, adminApiContext: AdminApiContext) => Promise<FlowTemplate>;
+declare const getFlow: (flowId: string, adminApiContext: AdminApiContext) => Promise<Flow>;
+declare const compareFlowTemplateWithFlow: (flowId: string, flowTemplateId: string, adminApiContext: AdminApiContext) => Promise<boolean>;
+declare function extractIdFromUrl(url: string): string | null;
+type OrderStatus = "cancel" | "complete" | "reopen" | "process";
+declare const setOrderStatus: (orderId: string, orderStatus: OrderStatus, adminApiContext: AdminApiContext) => Promise<APIResponse>;
+/**
+ * Return a single promotion entity with a fetched single discount entity
+ */
+declare const getPromotionWithDiscount: (promotionId: string, adminApiContext: AdminApiContext) => Promise<Promotion>;
+declare const updateAdminUser: (adminUserId: string, adminApiContext: AdminApiContext, data: Record<string, string | boolean>) => Promise<void>;
+
+declare const isSaaSInstance: (adminApiContext: AdminApiContext) => Promise<boolean>;
+declare const isPaaSInstance: () => boolean;
+declare const isThemeCompiled: (context: StoreApiContext, storefrontUrl: string) => Promise<boolean>;
+
+declare function createRandomImage(width?: number, height?: number): Image;
+declare function createSolidColorImage(width?: number, height?: number, color?: [number, number, number]): Image;
+declare function encodeImage(image: Image): Buffer<ArrayBuffer>;
+
+/**
+ * Hides elements (via `visibility: hidden`).
+ */
+declare function hideElements(page: Page, selectors: (string | Locator)[]): Promise<void>;
+/**
+ * Replaces text content or input values of elements with a given replacement string (default: "***").
+ * - Works for inputs, textareas, contenteditables and generic elements.
+ * - Ensures frameworks see the change (dispatches input/change).
+ * - Also masks placeholder so empty fields show replacement text in screenshots.
+ */
+declare function replaceElements(page: Page, selectors: (string | Locator)[], replaceWith?: string): Promise<void>;
+interface ReplaceTarget {
+    selector: string | Locator;
+    replaceWith?: string;
+}
+/**
+ * Replaces elements individually based on an array of targets.
+ *
+ *@param page - Playwright page
+ *@param targets - Array of objects containing selectors and optional replacement strings.
+ */
+declare function replaceElementsIndividually(page: Page, targets: ReplaceTarget[]): Promise<void>;
+/**
+ * Calculates the ideal viewport dimensions for a Playwright test based on scrollable content,
+ * header visibility, and optional configuration. Useful for dynamic screenshot sizing or
+ * testing long-scrolling pages.
+ *
+ * This function:
+ * - Optionally waits for a network request (`requestURL`) before continuing.
+ * - Optionally waits for a specific locator (`waitForLocator`) to become visible.
+ * - Measures scrollable content height (`scrollableElementVertical`) and header height.
+ * - Measures scrollable content width (`scrollableElementHorizontal`).
+ * - Falls back to defaults if elements are not found or inaccessible.
+ *
+ * @param {Page} page - The Playwright `Page` object representing the current browser tab.
+ * @param {Options} [options] - Optional configuration to override default behavior.
+ * @param {string} [options.requestURL] - A URL substring to wait for via `waitForResponse`.
+ * @param {number} [options.width] - Base viewport width to use (default: 1440).
+ * @param {string | Locator} [options.scrollableElementVertical] - Selector or Locator for vertical scroll container.
+ * @param {string | Locator} [options.scrollableElementHorizontal] - Selector or Locator for horizontal scroll container.
+ * @param {number} [options.additionalHeight] - Extra height to add (e.g., to avoid cut-off).
+ * @param {string | Locator} [options.waitForSelector] - A selector or Locator to wait for visibility before measuring.
+ * @param {number} [options.contentHeight] - Default vertical height fallback if measurement fails.
+ * @param {number} [options.headerHeight] - Default header height fallback.
+ * @param {string} [options.headerElement] - Selector for a header element whose height should be added if outside scrollable container.
+ *
+ * @returns {Promise<{ contentWidth: number; totalHeight: number }>} - A Promise resolving to the measured dimensions:
+ *   - `contentWidth`: the horizontal scroll width or fallback.
+ *   - `totalHeight`: sum of content height, header height, and any additional height.
+ */
+interface Options {
+    requestURL?: string;
+    width?: number;
+    scrollableElementVertical?: string | Locator;
+    scrollableElementHorizontal?: string | Locator;
+    additionalHeight?: number;
+    waitForSelector?: string | Locator;
+    contentHeight?: number;
+    headerHeight?: number;
+    headerElement?: string;
+}
+declare function setViewport(page: Page, options?: Options): Promise<void>;
+/**
+ * Takes a screenshot of the desktop content of the page or the provided locator and compares it to existing ones.
+ *
+ * @param page - Playwright page object
+ * @param filename - Filename of the screenshot
+ * @param locator - Optional Playwright locator to take a screenshot of instead of the desktop content
+ */
+declare function assertScreenshot(page: Page, filename: string, locator?: Locator): Promise<void>;
+
+declare class LanguageHelper {
+    private readonly i18nInstance;
+    private currentLng;
+    private readonly fallbackLng;
+    private readonly resources;
+    private constructor();
+    getLanguage(): string;
+    setLanguage(rawLanguage: string): Promise<void>;
+    translate(key: TranslationKey, options?: Record<string, unknown>): string;
+    static createInstance(rawLanguage: string, customResources?: typeof BUNDLED_RESOURCES): Promise<LanguageHelper>;
+    static setForContext(context: Record<string, unknown>, instance: LanguageHelper): void;
+    static getFromContext(context: Record<string, unknown>): LanguageHelper | undefined;
+}
+declare function setCurrentContext(context: Record<string, unknown> | null): void;
+declare function getCurrentContext(): Record<string, unknown> | null;
+declare function translate(key: TranslationKey, options?: Record<string, unknown>): string;
+
+declare const clearDelayedCache: (adminApiContext: AdminApiContext) => Promise<void>;
+
+declare function mockApiCalls(page: Page | BrowserContext): Promise<void>;
+
 /**
  * Creates a new admin page context (login page) without the actual login.
  * @param browser - The Playwright Browser instance.
@@ -6698,6 +6707,11 @@ interface DefaultSalesChannelTypes {
  * @returns The Playwright Page instance for the admin login page.
  */
 declare function createNewAdminPageContext(browser: Browser, SalesChannelBaseConfig: DefaultSalesChannelTypes["SalesChannelBaseConfig"]): Promise<Page$1>;
+/**
+ * Hides the Symfony debug toolbar after every reload of the given page.
+ * @param page - The Playwright Page instance to patch.
+ */
+declare function hideSymfonyToolbarOnReload(page: Page$1): void;
 /**
  * Performs admin login on the given page with the provided merchant user.
  * @param adminLoginPage - The Playwright Page instance for the admin login page.
@@ -6736,7 +6750,7 @@ declare function uploadRandomPngMedia(target: UploadMediaTarget, imageName: stri
  */
 type Task<TArgs extends unknown[] = any[]> = (...args: TArgs) => () => Promise<void>;
 
-declare const test: playwright_test.TestType<playwright_test.PlaywrightTestArgs & playwright_test.PlaywrightTestOptions & FixtureTypes & {
+declare const test: playwright_test.TestType<playwright_test.PlaywrightTestArgs & playwright_test.PlaywrightTestOptions & Omit<FixtureTypes, "AdminSession"> & FixtureTypes & {
     SaveProduct: Task;
 } & {
     ExpectNotification: Task;
@@ -6816,7 +6830,12 @@ declare const test: playwright_test.TestType<playwright_test.PlaywrightTestArgs
     SelectProductFilterOption: Task;
 } & {
     CheckVisibilityInHome: Task;
-}, playwright_test.PlaywrightWorkerArgs & playwright_test.PlaywrightWorkerOptions & FixtureTypes>;
+}, playwright_test.PlaywrightWorkerArgs & playwright_test.PlaywrightWorkerOptions & FixtureTypes & {
+    AdminApiContext: AdminApiContext;
+    AdminSession: AdminSession;
+    IdProvider: IdProvider;
+    SalesChannelBaseConfig: StoreBaseConfig;
+}>;
 
-export { Actor, AdminPageObjects, BUNDLED_RESOURCES, COUNTRY_ADDRESS_DATA, FeatureService, IdProvider, LanguageHelper, RuleType, StorefrontPageObjects, TestDataService, assertScreenshot, baseNamespaces, clearDelayedCache, compareFlowTemplateWithFlow, createNewAdminPageContext, createRandomImage, createSolidColorImage, encodeImage, extractIdFromUrl, formatPrice, getCountryAddressData, getCountryCodeFromLocale, getCountryId, getCurrency, getCurrencyCodeFromLocale, getCurrencySymbolFromLocale, getCurrentContext, getDefaultShippingMethodId, getFlow, getFlowId, getFlowTemplate, getLanguageCode, getLanguageData, getLocale, getMediaId, getOrderTransactionId, getPaymentMethodId, getPromotionWithDiscount, getSalutationId, getShippingMethodId, getSnippetSetId, getStateMachineId, getStateMachineStateId, getTaxId, getThemeId, hideElements, isPaaSInstance, isSaaSInstance, isThemeCompiled, loginToAdministration, mockApiCalls, replaceElements, replaceElementsIndividually, setCurrentContext, setOrderStatus, setViewport, test, translate, updateAdminUser, uploadRandomPngMedia };
+export { Actor, AdminPageObjects, BUNDLED_RESOURCES, COUNTRY_ADDRESS_DATA, FeatureService, IdProvider, LanguageHelper, RuleType, StorefrontPageObjects, TestDataService, assertScreenshot, baseNamespaces, clearDelayedCache, compareFlowTemplateWithFlow, createNewAdminPageContext, createRandomImage, createSolidColorImage, encodeImage, extractIdFromUrl, formatPrice, getCountryAddressData, getCountryCodeFromLocale, getCountryId, getCurrency, getCurrencyCodeFromLocale, getCurrencySymbolFromLocale, getCurrentContext, getDefaultShippingMethodId, getFlow, getFlowId, getFlowTemplate, getLanguageCode, getLanguageData, getLocale, getMediaId, getOrderTransactionId, getPaymentMethodId, getPromotionWithDiscount, getSalutationId, getShippingMethodId, getSnippetSetId, getStateMachineId, getStateMachineStateId, getTaxId, getThemeId, hideElements, hideSymfonyToolbarOnReload, isPaaSInstance, isSaaSInstance, isThemeCompiled, loginToAdministration, mockApiCalls, replaceElements, replaceElementsIndividually, setCurrentContext, setOrderStatus, setViewport, test, translate, updateAdminUser, uploadRandomPngMedia };
 export type { AccountData, AclRole, Address, CalculatedTaxes, Category$1 as Category, CategoryCustomizableLinkData, CategoryData, CmsPage, Country$1 as Country, CreatedRecord, Currency$2 as Currency, CustomField, CustomFieldData, CustomFieldSet, Customer, CustomerAddress, CustomerGroup, DataServiceOptions, DeliveryTime, FixtureTypes, Flow, FlowConfig, FlowTemplate, Language$2 as Language, Manufacturer, Media$1 as Media, Options, Order, OrderDelivery, OrderLineItem, OrderStatus, PageObject, PaymentMethod$1 as PaymentMethod, Price, Product, ProductCrossSelling, ProductPrice, ProductReview, Promotion, PromotionDiscount, PropertyGroup, PropertyGroupOption, RegistrationData, ReplaceTarget, Rule, RuleAssignmentEntity, SalesChannel, SalesChannelAnalytics, SalesChannelDomain, SalesChannelRecord, Salutation, ShippingMethod$1 as ShippingMethod, SimpleLineItem, StateMachine, StateMachineState, SyncApiOperation, SystemConfig, Tag, TagData, Task, Tax$1 as Tax, TaxRules, TranslateFn, TranslationKey, UploadMediaTarget, User, VariantListingConfig };