@xylentis/testgen 0.0.0-stage → 1.1.0

package/dist/vendor/playwright/locatorGenerators.js

@@ -0,0 +1,727 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { parseAttributeSelector, parseSelector, stringifySelector } from './selectorParser.js';
+import { escapeWithQuotes, normalizeEscapedRegexQuotes, toSnakeCase, toTitleCase } from './stringUtils.js';
+export function asLocatorDescription(lang, selector) {
+    try {
+        const parsed = parseSelector(selector);
+        const customDescription = parseCustomDescription(parsed);
+        if (customDescription)
+            return customDescription;
+        return innerAsLocators(new generators[lang](), parsed, false, 1)[0];
+    }
+    catch (e) {
+        // Tolerate invalid input.
+        return selector;
+    }
+}
+export function locatorCustomDescription(selector) {
+    try {
+        const parsed = parseSelector(selector);
+        return parseCustomDescription(parsed);
+    }
+    catch (e) {
+        return undefined;
+    }
+}
+function parseCustomDescription(parsed) {
+    const lastPart = parsed.parts[parsed.parts.length - 1];
+    if (lastPart?.name === 'internal:describe') {
+        const description = JSON.parse(lastPart.body);
+        if (typeof description === 'string')
+            return description;
+    }
+    return undefined;
+}
+export function asLocator(lang, selector, isFrameLocator = false) {
+    return asLocators(lang, selector, isFrameLocator, 1)[0];
+}
+export function asLocators(lang, selector, isFrameLocator = false, maxOutputSize = 20, preferredQuote) {
+    try {
+        return innerAsLocators(new generators[lang](preferredQuote), parseSelector(selector), isFrameLocator, maxOutputSize);
+    }
+    catch (e) {
+        // Tolerate invalid input.
+        return [selector];
+    }
+}
+function innerAsLocators(factory, parsed, isFrameLocator = false, maxOutputSize = 20) {
+    const parts = [...parsed.parts];
+    const tokens = [];
+    let nextBase = isFrameLocator ? 'frame-locator' : 'page';
+    for (let index = 0; index < parts.length; index++) {
+        const part = parts[index];
+        const base = nextBase;
+        nextBase = 'locator';
+        if (part.name === 'internal:describe')
+            continue;
+        if (part.name === 'nth') {
+            if (part.body === '0')
+                tokens.push([factory.generateLocator(base, 'first', ''), factory.generateLocator(base, 'nth', '0')]);
+            else if (part.body === '-1')
+                tokens.push([factory.generateLocator(base, 'last', ''), factory.generateLocator(base, 'nth', '-1')]);
+            else
+                tokens.push([factory.generateLocator(base, 'nth', part.body)]);
+            continue;
+        }
+        if (part.name === 'visible') {
+            const tokenList = [];
+            if (part.body === 'true')
+                tokenList.push(factory.generateLocator(base, 'visible', ''));
+            tokenList.push(factory.generateLocator(base, 'filter-visible', part.body), factory.generateLocator(base, 'default', `visible=${part.body}`));
+            tokens.push(tokenList);
+            continue;
+        }
+        if (part.name === 'internal:text') {
+            const { exact, text } = detectExact(part.body);
+            tokens.push([factory.generateLocator(base, 'text', text, { exact })]);
+            continue;
+        }
+        if (part.name === 'internal:has-text') {
+            const { exact, text } = detectExact(part.body);
+            // There is no locator equivalent for strict has-text, leave it as is.
+            if (!exact) {
+                tokens.push([factory.generateLocator(base, 'has-text', text, { exact })]);
+                continue;
+            }
+        }
+        if (part.name === 'internal:has-not-text') {
+            const { exact, text } = detectExact(part.body);
+            // There is no locator equivalent for strict has-not-text, leave it as is.
+            if (!exact) {
+                tokens.push([factory.generateLocator(base, 'has-not-text', text, { exact })]);
+                continue;
+            }
+        }
+        if (part.name === 'internal:has') {
+            const inners = innerAsLocators(factory, part.body.parsed, false, maxOutputSize);
+            tokens.push(inners.map(inner => factory.generateLocator(base, 'has', inner)));
+            continue;
+        }
+        if (part.name === 'internal:has-not') {
+            const inners = innerAsLocators(factory, part.body.parsed, false, maxOutputSize);
+            tokens.push(inners.map(inner => factory.generateLocator(base, 'hasNot', inner)));
+            continue;
+        }
+        if (part.name === 'internal:and') {
+            const inners = innerAsLocators(factory, part.body.parsed, false, maxOutputSize);
+            tokens.push(inners.map(inner => factory.generateLocator(base, 'and', inner)));
+            continue;
+        }
+        if (part.name === 'internal:or') {
+            const inners = innerAsLocators(factory, part.body.parsed, false, maxOutputSize);
+            tokens.push(inners.map(inner => factory.generateLocator(base, 'or', inner)));
+            continue;
+        }
+        if (part.name === 'internal:chain') {
+            const inners = innerAsLocators(factory, part.body.parsed, false, maxOutputSize);
+            tokens.push(inners.map(inner => factory.generateLocator(base, 'chain', inner)));
+            continue;
+        }
+        if (part.name === 'internal:label') {
+            const { exact, text } = detectExact(part.body);
+            tokens.push([factory.generateLocator(base, 'label', text, { exact })]);
+            continue;
+        }
+        if (part.name === 'internal:role') {
+            const attrSelector = parseAttributeSelector(part.body, true);
+            const options = { attrs: [] };
+            for (const attr of attrSelector.attributes) {
+                if (attr.name === 'name') {
+                    if (options.exact !== undefined && options.exact !== attr.caseSensitive)
+                        throw new Error(`Conflicting exactness in internal:role selector: ${stringifySelector({ parts: [part] })}`);
+                    options.exact = attr.caseSensitive;
+                    options.name = attr.value;
+                }
+                else if (attr.name === 'description') {
+                    if (options.exact !== undefined && options.exact !== attr.caseSensitive)
+                        throw new Error(`Conflicting exactness in internal:role selector: ${stringifySelector({ parts: [part] })}`);
+                    options.exact = attr.caseSensitive;
+                    options.description = attr.value;
+                }
+                else {
+                    if (attr.name === 'level' && typeof attr.value === 'string')
+                        attr.value = +attr.value;
+                    options.attrs.push({ name: attr.name === 'include-hidden' ? 'includeHidden' : attr.name, value: attr.value });
+                }
+            }
+            tokens.push([factory.generateLocator(base, 'role', attrSelector.name, options)]);
+            continue;
+        }
+        if (part.name === 'internal:testid') {
+            const attrSelector = parseAttributeSelector(part.body, true);
+            const { value } = attrSelector.attributes[0];
+            tokens.push([factory.generateLocator(base, 'test-id', value)]);
+            continue;
+        }
+        if (part.name === 'internal:attr') {
+            const attrSelector = parseAttributeSelector(part.body, true);
+            const { name, value, caseSensitive } = attrSelector.attributes[0];
+            const text = value;
+            const exact = !!caseSensitive;
+            if (name === 'placeholder') {
+                tokens.push([factory.generateLocator(base, 'placeholder', text, { exact })]);
+                continue;
+            }
+            if (name === 'alt') {
+                tokens.push([factory.generateLocator(base, 'alt', text, { exact })]);
+                continue;
+            }
+            if (name === 'title') {
+                tokens.push([factory.generateLocator(base, 'title', text, { exact })]);
+                continue;
+            }
+        }
+        if (part.name === 'internal:control' && part.body === 'any-frame') {
+            tokens.push([factory.generateLocator(base, 'any-frame', '')]);
+            nextBase = 'frame-locator';
+            continue;
+        }
+        if (part.name === 'internal:control' && part.body === 'enter-frame') {
+            // transform last tokens from `${selector}` into `${selector}.contentFrame()` and `frameLocator(${selector})`
+            const lastTokens = tokens[tokens.length - 1];
+            const lastPart = parts[index - 1];
+            const transformed = lastTokens.map(token => factory.chainLocators([token, factory.generateLocator(base, 'frame', '')]));
+            if (['xpath', 'css'].includes(lastPart.name)) {
+                transformed.push(factory.generateLocator(base, 'frame-locator', stringifySelector({ parts: [lastPart] })), factory.generateLocator(base, 'frame-locator', stringifySelector({ parts: [lastPart] }, true)));
+            }
+            lastTokens.splice(0, lastTokens.length, ...transformed);
+            nextBase = 'frame-locator';
+            continue;
+        }
+        const nextPart = parts[index + 1];
+        const selectorPart = stringifySelector({ parts: [part] });
+        const locatorPart = factory.generateLocator(base, 'default', selectorPart);
+        if (nextPart && ['internal:has-text', 'internal:has-not-text'].includes(nextPart.name)) {
+            const { exact, text } = detectExact(nextPart.body);
+            // There is no locator equivalent for strict has-text and has-not-text, leave it as is.
+            if (!exact) {
+                const nextLocatorPart = factory.generateLocator('locator', nextPart.name === 'internal:has-text' ? 'has-text' : 'has-not-text', text, { exact });
+                const options = {};
+                if (nextPart.name === 'internal:has-text')
+                    options.hasText = text;
+                else
+                    options.hasNotText = text;
+                const combinedPart = factory.generateLocator(base, 'default', selectorPart, options);
+                // Two options:
+                // - locator('div').filter({ hasText: 'foo' })
+                // - locator('div', { hasText: 'foo' })
+                tokens.push([factory.chainLocators([locatorPart, nextLocatorPart]), combinedPart]);
+                index++;
+                continue;
+            }
+        }
+        // Selectors can be prefixed with engine name, e.g. xpath=//foo
+        let locatorPartWithEngine;
+        if (['xpath', 'css'].includes(part.name)) {
+            const selectorPart = stringifySelector({ parts: [part] }, /* forceEngineName */ true);
+            locatorPartWithEngine = factory.generateLocator(base, 'default', selectorPart);
+        }
+        tokens.push([locatorPart, locatorPartWithEngine].filter(Boolean));
+    }
+    return combineTokens(factory, tokens, maxOutputSize);
+}
+function combineTokens(factory, tokens, maxOutputSize) {
+    const currentTokens = tokens.map(() => '');
+    const result = [];
+    const visit = (index) => {
+        if (index === tokens.length) {
+            result.push(factory.chainLocators(currentTokens));
+            return result.length < maxOutputSize;
+        }
+        for (const taken of tokens[index]) {
+            currentTokens[index] = taken;
+            if (!visit(index + 1))
+                return false;
+        }
+        return true;
+    };
+    visit(0);
+    return result;
+}
+function detectExact(text) {
+    let exact = false;
+    const match = text.match(/^\/(.*)\/([igm]*)$/);
+    if (match)
+        return { text: new RegExp(match[1], match[2]) };
+    if (text.endsWith('"')) {
+        text = JSON.parse(text);
+        exact = true;
+    }
+    else if (text.endsWith('"s')) {
+        text = JSON.parse(text.substring(0, text.length - 1));
+        exact = true;
+    }
+    else if (text.endsWith('"i')) {
+        text = JSON.parse(text.substring(0, text.length - 1));
+        exact = false;
+    }
+    return { exact, text };
+}
+export class JavaScriptLocatorFactory {
+    preferredQuote;
+    constructor(preferredQuote) {
+        this.preferredQuote = preferredQuote;
+    }
+    generateLocator(base, kind, body, options = {}) {
+        switch (kind) {
+            case 'default':
+                if (options.hasText !== undefined)
+                    return `locator(${this.quote(body)}, { hasText: ${this.toHasText(options.hasText)} })`;
+                if (options.hasNotText !== undefined)
+                    return `locator(${this.quote(body)}, { hasNotText: ${this.toHasText(options.hasNotText)} })`;
+                return `locator(${this.quote(body)})`;
+            case 'frame-locator':
+                return `frameLocator(${this.quote(body)})`;
+            case 'frame':
+                return `contentFrame()`;
+            case 'any-frame':
+                return `frameLocator()`;
+            case 'nth':
+                return `nth(${body})`;
+            case 'first':
+                return `first()`;
+            case 'last':
+                return `last()`;
+            case 'visible':
+                return `visible()`;
+            case 'filter-visible':
+                return `filter({ visible: ${body === 'true' ? 'true' : 'false'} })`;
+            case 'role':
+                const attrs = [];
+                if (isRegExp(options.name))
+                    attrs.push(`name: ${this.regexToSourceString(options.name)}`);
+                else if (typeof options.name === 'string')
+                    attrs.push(`name: ${this.quote(options.name)}`);
+                if (isRegExp(options.description))
+                    attrs.push(`description: ${this.regexToSourceString(options.description)}`);
+                else if (typeof options.description === 'string')
+                    attrs.push(`description: ${this.quote(options.description)}`);
+                if (options.exact && (typeof options.name === 'string' || typeof options.description === 'string'))
+                    attrs.push(`exact: true`);
+                for (const { name, value } of options.attrs)
+                    attrs.push(`${name}: ${typeof value === 'string' ? this.quote(value) : value}`);
+                const attrString = attrs.length ? `, { ${attrs.join(', ')} }` : '';
+                return `getByRole(${this.quote(body)}${attrString})`;
+            case 'has-text':
+                return `filter({ hasText: ${this.toHasText(body)} })`;
+            case 'has-not-text':
+                return `filter({ hasNotText: ${this.toHasText(body)} })`;
+            case 'has':
+                return `filter({ has: ${body} })`;
+            case 'hasNot':
+                return `filter({ hasNot: ${body} })`;
+            case 'and':
+                return `and(${body})`;
+            case 'or':
+                return `or(${body})`;
+            case 'chain':
+                return `locator(${body})`;
+            case 'test-id':
+                return `getByTestId(${this.toTestIdValue(body)})`;
+            case 'text':
+                return this.toCallWithExact('getByText', body, !!options.exact);
+            case 'alt':
+                return this.toCallWithExact('getByAltText', body, !!options.exact);
+            case 'placeholder':
+                return this.toCallWithExact('getByPlaceholder', body, !!options.exact);
+            case 'label':
+                return this.toCallWithExact('getByLabel', body, !!options.exact);
+            case 'title':
+                return this.toCallWithExact('getByTitle', body, !!options.exact);
+            default:
+                throw new Error('Unknown selector kind ' + kind);
+        }
+    }
+    chainLocators(locators) {
+        return locators.join('.');
+    }
+    regexToSourceString(re) {
+        return normalizeEscapedRegexQuotes(String(re));
+    }
+    toCallWithExact(method, body, exact) {
+        if (isRegExp(body))
+            return `${method}(${this.regexToSourceString(body)})`;
+        return exact ? `${method}(${this.quote(body)}, { exact: true })` : `${method}(${this.quote(body)})`;
+    }
+    toHasText(body) {
+        if (isRegExp(body))
+            return this.regexToSourceString(body);
+        return this.quote(body);
+    }
+    toTestIdValue(value) {
+        if (isRegExp(value))
+            return this.regexToSourceString(value);
+        return this.quote(value);
+    }
+    quote(text) {
+        return escapeWithQuotes(text, this.preferredQuote ?? '\'');
+    }
+}
+export class PythonLocatorFactory {
+    generateLocator(base, kind, body, options = {}) {
+        switch (kind) {
+            case 'default':
+                if (options.hasText !== undefined)
+                    return `locator(${this.quote(body)}, has_text=${this.toHasText(options.hasText)})`;
+                if (options.hasNotText !== undefined)
+                    return `locator(${this.quote(body)}, has_not_text=${this.toHasText(options.hasNotText)})`;
+                return `locator(${this.quote(body)})`;
+            case 'frame-locator':
+                return `frame_locator(${this.quote(body)})`;
+            case 'frame':
+                return `content_frame`;
+            case 'any-frame':
+                return `frame_locator()`;
+            case 'nth':
+                return `nth(${body})`;
+            case 'first':
+                return `first`;
+            case 'last':
+                return `last`;
+            case 'visible':
+                return `visible`;
+            case 'filter-visible':
+                return `filter(visible=${body === 'true' ? 'True' : 'False'})`;
+            case 'role':
+                const attrs = [];
+                if (isRegExp(options.name))
+                    attrs.push(`name=${this.regexToString(options.name)}`);
+                else if (typeof options.name === 'string')
+                    attrs.push(`name=${this.quote(options.name)}`);
+                if (isRegExp(options.description))
+                    attrs.push(`description=${this.regexToString(options.description)}`);
+                else if (typeof options.description === 'string')
+                    attrs.push(`description=${this.quote(options.description)}`);
+                if (options.exact && (typeof options.name === 'string' || typeof options.description === 'string'))
+                    attrs.push(`exact=True`);
+                for (const { name, value } of options.attrs) {
+                    let valueString = typeof value === 'string' ? this.quote(value) : value;
+                    if (typeof value === 'boolean')
+                        valueString = value ? 'True' : 'False';
+                    attrs.push(`${toSnakeCase(name)}=${valueString}`);
+                }
+                const attrString = attrs.length ? `, ${attrs.join(', ')}` : '';
+                return `get_by_role(${this.quote(body)}${attrString})`;
+            case 'has-text':
+                return `filter(has_text=${this.toHasText(body)})`;
+            case 'has-not-text':
+                return `filter(has_not_text=${this.toHasText(body)})`;
+            case 'has':
+                return `filter(has=${body})`;
+            case 'hasNot':
+                return `filter(has_not=${body})`;
+            case 'and':
+                return `and_(${body})`;
+            case 'or':
+                return `or_(${body})`;
+            case 'chain':
+                return `locator(${body})`;
+            case 'test-id':
+                return `get_by_test_id(${this.toTestIdValue(body)})`;
+            case 'text':
+                return this.toCallWithExact('get_by_text', body, !!options.exact);
+            case 'alt':
+                return this.toCallWithExact('get_by_alt_text', body, !!options.exact);
+            case 'placeholder':
+                return this.toCallWithExact('get_by_placeholder', body, !!options.exact);
+            case 'label':
+                return this.toCallWithExact('get_by_label', body, !!options.exact);
+            case 'title':
+                return this.toCallWithExact('get_by_title', body, !!options.exact);
+            default:
+                throw new Error('Unknown selector kind ' + kind);
+        }
+    }
+    chainLocators(locators) {
+        return locators.join('.');
+    }
+    regexToString(body) {
+        const suffix = body.flags.includes('i') ? ', re.IGNORECASE' : '';
+        return `re.compile(r"${normalizeEscapedRegexQuotes(body.source).replace(/\\\//, '/').replace(/"/g, '\\"')}"${suffix})`;
+    }
+    toCallWithExact(method, body, exact) {
+        if (isRegExp(body))
+            return `${method}(${this.regexToString(body)})`;
+        if (exact)
+            return `${method}(${this.quote(body)}, exact=True)`;
+        return `${method}(${this.quote(body)})`;
+    }
+    toHasText(body) {
+        if (isRegExp(body))
+            return this.regexToString(body);
+        return `${this.quote(body)}`;
+    }
+    toTestIdValue(value) {
+        if (isRegExp(value))
+            return this.regexToString(value);
+        return this.quote(value);
+    }
+    quote(text) {
+        return escapeWithQuotes(text, '\"');
+    }
+}
+export class JavaLocatorFactory {
+    generateLocator(base, kind, body, options = {}) {
+        let clazz;
+        switch (base) {
+            case 'page':
+                clazz = 'Page';
+                break;
+            case 'frame-locator':
+                clazz = 'FrameLocator';
+                break;
+            case 'locator':
+                clazz = 'Locator';
+                break;
+        }
+        switch (kind) {
+            case 'default':
+                if (options.hasText !== undefined)
+                    return `locator(${this.quote(body)}, new ${clazz}.LocatorOptions().setHasText(${this.toHasText(options.hasText)}))`;
+                if (options.hasNotText !== undefined)
+                    return `locator(${this.quote(body)}, new ${clazz}.LocatorOptions().setHasNotText(${this.toHasText(options.hasNotText)}))`;
+                return `locator(${this.quote(body)})`;
+            case 'frame-locator':
+                return `frameLocator(${this.quote(body)})`;
+            case 'frame':
+                return `contentFrame()`;
+            case 'any-frame':
+                return `frameLocator()`;
+            case 'nth':
+                return `nth(${body})`;
+            case 'first':
+                return `first()`;
+            case 'last':
+                return `last()`;
+            case 'visible':
+                return `visible()`;
+            case 'filter-visible':
+                return `filter(new ${clazz}.FilterOptions().setVisible(${body === 'true' ? 'true' : 'false'}))`;
+            case 'role':
+                const attrs = [];
+                if (isRegExp(options.name))
+                    attrs.push(`.setName(${this.regexToString(options.name)})`);
+                else if (typeof options.name === 'string')
+                    attrs.push(`.setName(${this.quote(options.name)})`);
+                if (isRegExp(options.description))
+                    attrs.push(`.setDescription(${this.regexToString(options.description)})`);
+                else if (typeof options.description === 'string')
+                    attrs.push(`.setDescription(${this.quote(options.description)})`);
+                if (options.exact && (typeof options.name === 'string' || typeof options.description === 'string'))
+                    attrs.push(`.setExact(true)`);
+                for (const { name, value } of options.attrs)
+                    attrs.push(`.set${toTitleCase(name)}(${typeof value === 'string' ? this.quote(value) : value})`);
+                const attrString = attrs.length ? `, new ${clazz}.GetByRoleOptions()${attrs.join('')}` : '';
+                return `getByRole(AriaRole.${toSnakeCase(body).toUpperCase()}${attrString})`;
+            case 'has-text':
+                return `filter(new ${clazz}.FilterOptions().setHasText(${this.toHasText(body)}))`;
+            case 'has-not-text':
+                return `filter(new ${clazz}.FilterOptions().setHasNotText(${this.toHasText(body)}))`;
+            case 'has':
+                return `filter(new ${clazz}.FilterOptions().setHas(${body}))`;
+            case 'hasNot':
+                return `filter(new ${clazz}.FilterOptions().setHasNot(${body}))`;
+            case 'and':
+                return `and(${body})`;
+            case 'or':
+                return `or(${body})`;
+            case 'chain':
+                return `locator(${body})`;
+            case 'test-id':
+                return `getByTestId(${this.toTestIdValue(body)})`;
+            case 'text':
+                return this.toCallWithExact(clazz, 'getByText', body, !!options.exact);
+            case 'alt':
+                return this.toCallWithExact(clazz, 'getByAltText', body, !!options.exact);
+            case 'placeholder':
+                return this.toCallWithExact(clazz, 'getByPlaceholder', body, !!options.exact);
+            case 'label':
+                return this.toCallWithExact(clazz, 'getByLabel', body, !!options.exact);
+            case 'title':
+                return this.toCallWithExact(clazz, 'getByTitle', body, !!options.exact);
+            default:
+                throw new Error('Unknown selector kind ' + kind);
+        }
+    }
+    chainLocators(locators) {
+        return locators.join('.');
+    }
+    regexToString(body) {
+        const suffix = body.flags.includes('i') ? ', Pattern.CASE_INSENSITIVE' : '';
+        return `Pattern.compile(${this.quote(normalizeEscapedRegexQuotes(body.source))}${suffix})`;
+    }
+    toCallWithExact(clazz, method, body, exact) {
+        if (isRegExp(body))
+            return `${method}(${this.regexToString(body)})`;
+        if (exact)
+            return `${method}(${this.quote(body)}, new ${clazz}.${toTitleCase(method)}Options().setExact(true))`;
+        return `${method}(${this.quote(body)})`;
+    }
+    toHasText(body) {
+        if (isRegExp(body))
+            return this.regexToString(body);
+        return this.quote(body);
+    }
+    toTestIdValue(value) {
+        if (isRegExp(value))
+            return this.regexToString(value);
+        return this.quote(value);
+    }
+    quote(text) {
+        return escapeWithQuotes(text, '\"');
+    }
+}
+export class CSharpLocatorFactory {
+    generateLocator(base, kind, body, options = {}) {
+        switch (kind) {
+            case 'default':
+                if (options.hasText !== undefined)
+                    return `Locator(${this.quote(body)}, new() { ${this.toHasText(options.hasText)} })`;
+                if (options.hasNotText !== undefined)
+                    return `Locator(${this.quote(body)}, new() { ${this.toHasNotText(options.hasNotText)} })`;
+                return `Locator(${this.quote(body)})`;
+            case 'frame-locator':
+                return `FrameLocator(${this.quote(body)})`;
+            case 'frame':
+                return `ContentFrame`;
+            case 'any-frame':
+                return `FrameLocator()`;
+            case 'nth':
+                return `Nth(${body})`;
+            case 'first':
+                return `First`;
+            case 'last':
+                return `Last`;
+            case 'visible':
+                return `Visible`;
+            case 'filter-visible':
+                return `Filter(new() { Visible = ${body === 'true' ? 'true' : 'false'} })`;
+            case 'role':
+                const attrs = [];
+                if (isRegExp(options.name))
+                    attrs.push(`NameRegex = ${this.regexToString(options.name)}`);
+                else if (typeof options.name === 'string')
+                    attrs.push(`Name = ${this.quote(options.name)}`);
+                if (isRegExp(options.description))
+                    attrs.push(`DescriptionRegex = ${this.regexToString(options.description)}`);
+                else if (typeof options.description === 'string')
+                    attrs.push(`Description = ${this.quote(options.description)}`);
+                if (options.exact && (typeof options.name === 'string' || typeof options.description === 'string'))
+                    attrs.push(`Exact = true`);
+                for (const { name, value } of options.attrs)
+                    attrs.push(`${toTitleCase(name)} = ${typeof value === 'string' ? this.quote(value) : value}`);
+                const attrString = attrs.length ? `, new() { ${attrs.join(', ')} }` : '';
+                return `GetByRole(AriaRole.${toTitleCase(body)}${attrString})`;
+            case 'has-text':
+                return `Filter(new() { ${this.toHasText(body)} })`;
+            case 'has-not-text':
+                return `Filter(new() { ${this.toHasNotText(body)} })`;
+            case 'has':
+                return `Filter(new() { Has = ${body} })`;
+            case 'hasNot':
+                return `Filter(new() { HasNot = ${body} })`;
+            case 'and':
+                return `And(${body})`;
+            case 'or':
+                return `Or(${body})`;
+            case 'chain':
+                return `Locator(${body})`;
+            case 'test-id':
+                return `GetByTestId(${this.toTestIdValue(body)})`;
+            case 'text':
+                return this.toCallWithExact('GetByText', body, !!options.exact);
+            case 'alt':
+                return this.toCallWithExact('GetByAltText', body, !!options.exact);
+            case 'placeholder':
+                return this.toCallWithExact('GetByPlaceholder', body, !!options.exact);
+            case 'label':
+                return this.toCallWithExact('GetByLabel', body, !!options.exact);
+            case 'title':
+                return this.toCallWithExact('GetByTitle', body, !!options.exact);
+            default:
+                throw new Error('Unknown selector kind ' + kind);
+        }
+    }
+    chainLocators(locators) {
+        return locators.join('.');
+    }
+    regexToString(body) {
+        const suffix = body.flags.includes('i') ? ', RegexOptions.IgnoreCase' : '';
+        return `new Regex(${this.quote(normalizeEscapedRegexQuotes(body.source))}${suffix})`;
+    }
+    toCallWithExact(method, body, exact) {
+        if (isRegExp(body))
+            return `${method}(${this.regexToString(body)})`;
+        if (exact)
+            return `${method}(${this.quote(body)}, new() { Exact = true })`;
+        return `${method}(${this.quote(body)})`;
+    }
+    toHasText(body) {
+        if (isRegExp(body))
+            return `HasTextRegex = ${this.regexToString(body)}`;
+        return `HasText = ${this.quote(body)}`;
+    }
+    toTestIdValue(value) {
+        if (isRegExp(value))
+            return this.regexToString(value);
+        return this.quote(value);
+    }
+    toHasNotText(body) {
+        if (isRegExp(body))
+            return `HasNotTextRegex = ${this.regexToString(body)}`;
+        return `HasNotText = ${this.quote(body)}`;
+    }
+    quote(text) {
+        return escapeWithQuotes(text, '\"');
+    }
+}
+export class JsonlLocatorFactory {
+    generateLocator(base, kind, body, options = {}) {
+        return JSON.stringify({
+            kind,
+            body,
+            options,
+        });
+    }
+    chainLocators(locators) {
+        const objects = locators.map(l => JSON.parse(l));
+        for (let i = 0; i < objects.length - 1; ++i) {
+            // A locator may already be a chain, e.g. `contentFrame()` produces one. Append to its tail.
+            let tail = objects[i];
+            while (tail.next)
+                tail = tail.next;
+            tail.next = objects[i + 1];
+        }
+        return JSON.stringify(objects[0]);
+    }
+}
+const generators = {
+    javascript: JavaScriptLocatorFactory,
+    python: PythonLocatorFactory,
+    java: JavaLocatorFactory,
+    csharp: CSharpLocatorFactory,
+    jsonl: JsonlLocatorFactory,
+};
+function isRegExp(obj) {
+    return obj instanceof RegExp;
+}
+// testgen: exposes the selector → locator decomposition to custom LocatorFactory
+// implementations (upstream only accepts its built-in languages).
+export function asLocatorWithFactory(factory, selector, isFrameLocator = false) {
+    return innerAsLocators(factory, parseSelector(selector), isFrameLocator, 1)[0];
+}
+//# sourceMappingURL=locatorGenerators.js.map