@xylentis/testgen 1.1.1 → 1.2.0

package/dist/text.js

@@ -0,0 +1,28 @@
+// Finding a value inside a longer text without cutting words in two: "Buy milk" in "Buy milk Delete",
+// but not "milk" in "milkshake" nor "12" in "Total: 120".
+const wordCharacter = /[\p{L}\p{N}_]/u;
+export function isWholeWords(text, start, end) {
+    return !(start > 0 && wordCharacter.test(text[start - 1]) && wordCharacter.test(text[start]))
+        && !(end < text.length && wordCharacter.test(text[end - 1]) && wordCharacter.test(text[end]));
+}
+// Start of each occurrence of `part` in `text` that cuts no word in two.
+export function wholeWordOccurrences(text, part) {
+    const result = [];
+    if (!part)
+        return result;
+    for (let start = text.indexOf(part); start !== -1; start = text.indexOf(part, start + part.length)) {
+        if (isWholeWords(text, start, start + part.length))
+            result.push(start);
+    }
+    return result;
+}
+export function replaceWholeWords(text, part, replacement) {
+    let result = '';
+    let last = 0;
+    for (const start of wholeWordOccurrences(text, part)) {
+        result += text.slice(last, start) + replacement;
+        last = start + part.length;
+    }
+    return result + text.slice(last);
+}
+//# sourceMappingURL=text.js.map

package/dist/ui/server.js

@@ -2,11 +2,15 @@ import fs from 'node:fs';
 import http from 'node:http';
 import os from 'node:os';
 import path from 'node:path';
+import { checkFiles, checkRecording } from '../checks.js';
+import { deleteStep, editStep, moveStep, stepFields } from '../editing.js';
 import { generateTargets, writeTargets } from '../generate.js';
 import { generators } from '../generators/index.js';
 import { describeSelector } from '../locator.js';
-import { PageAliases, parseRecording, recordedTestIdAttribute } from '../recording.js';
+import { PageAliases, parseRecording, recordedTestIdAttribute, serializeRecording } from '../recording.js';
 import { startCodegen } from '../record.js';
+import { missingSecrets, replayRecording } from '../replay.js';
+import { collectSecrets, markSecrets, redactRecording } from '../secrets.js';
 const uiRoot = new URL('../../ui/', import.meta.url);
 const staticFiles = {
     '/': 'index.html',
@@ -26,12 +30,25 @@ export async function startUiServer(options) {
         status: 'idle',
         log: '',
         recording: '',
-        settings: { name: 'recorded', packageName: '', testIdAttribute: 'data-testid' },
+        settings: { name: 'recorded', packageName: '', testIdAttribute: 'data-testid', logSteps: false, dataDriven: false },
+        undo: [],
     };
     let child;
     let watcher;
     let recordingFile = '';
-    const snapshot = () => JSON.stringify({ ...state, ...render(state) });
+    // Values of secrets entered for replays; they stay in this process.
+    const secretValues = {};
+    let replayAbort;
+    let screenshot;
+    const snapshot = () => JSON.stringify({
+        status: state.status,
+        error: state.error,
+        settings: state.settings,
+        hasRecording: !!state.recording.trim(),
+        canUndo: state.undo.length > 0,
+        replay: state.replay,
+        ...render(state, secretValues),
+    });
     const broadcast = () => {
         const data = `data: ${snapshot()}\n\n`;
         for (const client of clients)
@@ -57,10 +74,15 @@ export async function startUiServer(options) {
             clearInterval(watcher);
         }
     };
-    const record = (body) => {
+    // A new recording replaces the steps, their undo history and the last replay.
+    const replaceRecording = (recording, status) => {
         stopRecorder({ detach: true });
+        replayAbort?.abort();
+        Object.assign(state, { status, error: undefined, log: '', recording, undo: [], replay: undefined });
+    };
+    const record = (body) => {
+        replaceRecording('', 'recording');
         recordingFile = path.join(workDir, `recording-${Date.now()}.jsonl`);
-        Object.assign(state, { status: 'recording', error: undefined, log: '', recording: '' });
         if (body.testIdAttribute)
             state.settings.testIdAttribute = body.testIdAttribute;
         const codegen = {
@@ -92,6 +114,81 @@ export async function startUiServer(options) {
         watcher = setInterval(readRecording, 250);
         broadcast();
     };
+    const changeSteps = (change) => {
+        if (state.status === 'recording')
+            throw new Error('Stop the recording before changing its steps.');
+        if (state.replay?.status === 'running')
+            throw new Error('Wait for the replay to finish, or stop it, before changing the steps.');
+        // Steps found to be secrets stay secrets, whatever the change does to their locator.
+        const changed = serializeRecording(change(markSecrets(parseRecording(state.recording))));
+        state.undo = [...state.undo.slice(-49), state.recording];
+        state.recording = changed;
+        state.replay = undefined;
+        broadcast();
+    };
+    const undo = () => {
+        const previous = state.undo.pop();
+        if (previous === undefined)
+            throw new Error('Nothing to undo.');
+        if (state.replay?.status === 'running') {
+            state.undo.push(previous);
+            throw new Error('Wait for the replay to finish, or stop it, before changing the steps.');
+        }
+        state.recording = previous;
+        state.replay = undefined;
+        broadcast();
+    };
+    const replay = (body) => {
+        if (state.status === 'recording')
+            throw new Error('Stop the recording before replaying it.');
+        if (state.replay?.status === 'running')
+            throw new Error('A replay is already running.');
+        const recording = parseRecording(state.recording);
+        if (!recording.actions.length)
+            throw new Error('There are no steps to replay.');
+        for (const [name, value] of Object.entries(body.secrets ?? {})) {
+            if (typeof value === 'string')
+                secretValues[name] = value;
+        }
+        const missing = missingSecrets(recording, secretValues);
+        if (missing.length)
+            throw new Error(`Enter ${missing.join(', ')} to replay: the recording does not keep the values typed into password fields.`);
+        const abort = new AbortController();
+        const current = { status: 'running', steps: [] };
+        const started = Date.now();
+        replayAbort = abort;
+        screenshot = undefined;
+        state.replay = current;
+        broadcast();
+        void replayRecording(recording, { headless: options.headlessReplay, secrets: { ...secretValues }, cwd: options.cwd, signal: abort.signal }, event => {
+            // An edit or a new recording dropped this replay.
+            if (state.replay !== current)
+                return;
+            if (event.type === 'step') {
+                const result = { status: event.status };
+                if (event.status !== 'running') {
+                    result.duration = event.duration;
+                    if (event.status === 'failed') {
+                        result.error = event.error;
+                        if (event.screenshot) {
+                            screenshot = event.screenshot;
+                            current.screenshot = (current.screenshot ?? 0) + 1;
+                        }
+                    }
+                    else if (event.note) {
+                        result.note = event.note;
+                    }
+                }
+                current.steps[event.index] = result;
+            }
+            else {
+                Object.assign(current, { status: event.status, error: event.error, duration: Date.now() - started });
+                if (replayAbort === abort)
+                    replayAbort = undefined;
+            }
+            broadcast();
+        });
+    };
     const server = http.createServer(async (request, response) => {
         try {
             // Only answer requests addressed to this local server (protects against DNS rebinding).
@@ -100,6 +197,12 @@ export async function startUiServer(options) {
                 response.writeHead(403).end('Forbidden');
                 return;
             }
+            // Only this page may change anything. Browsers send the Origin of the page making a request,
+            // and a page of another site cannot send JSON without a preflight request, which gets a 404.
+            if (request.method === 'POST' && !fromThisPage(request)) {
+                response.writeHead(403).end('Forbidden');
+                return;
+            }
             const url = new URL(request.url ?? '/', 'http://localhost');
             if (request.method === 'GET' && staticFiles[url.pathname]) {
                 const file = staticFiles[url.pathname];
@@ -115,12 +218,29 @@ export async function startUiServer(options) {
                 return;
             }
             if (request.method === 'GET' && url.pathname === '/api/targets') {
-                json(response, generators.map(g => ({ id: g.id, framework: g.framework, language: g.language, highlight: g.highlight })));
+                json(response, generators.map(g => ({ id: g.id, framework: g.framework, language: g.language, highlight: g.highlight, features: g.features ?? [] })));
                 return;
             }
             if (request.method === 'GET' && url.pathname === '/api/recording') {
+                // Without the values typed into password fields; a text testgen cannot read goes as it is.
+                let text = state.recording;
+                try {
+                    text = serializeRecording(redactRecording(parseRecording(state.recording)));
+                }
+                catch {
+                    // Not a recording testgen can read: download it as it is.
+                }
                 response.writeHead(200, { 'content-type': 'application/x-ndjson', 'content-disposition': 'attachment; filename="recording.jsonl"' });
-                response.end(state.recording);
+                response.end(text);
+                return;
+            }
+            if (request.method === 'GET' && url.pathname === '/api/replay/screenshot') {
+                if (!screenshot) {
+                    response.writeHead(404).end('No screenshot');
+                    return;
+                }
+                response.writeHead(200, { 'content-type': 'image/png', 'cache-control': 'no-store' });
+                response.end(screenshot);
                 return;
             }
             if (request.method !== 'POST') {
@@ -138,16 +258,45 @@ export async function startUiServer(options) {
                     json(response, { ok: true });
                     return;
                 case '/api/load':
-                    stopRecorder({ detach: true });
-                    Object.assign(state, { status: 'stopped', error: undefined, log: '', recording: String(body.recording ?? '') });
+                    replaceRecording(String(body.recording ?? ''), 'stopped');
                     broadcast();
                     json(response, { ok: true });
                     return;
+                case '/api/steps': {
+                    const index = Number(body.index);
+                    changeSteps(recording => {
+                        switch (body.action) {
+                            case 'delete':
+                                return deleteStep(recording, index);
+                            case 'move':
+                                return moveStep(recording, index, Number(body.to));
+                            case 'edit':
+                                return editStep(recording, index, stepChange(body.change), recordedTestIdAttribute(recording) ?? state.settings.testIdAttribute);
+                        }
+                        throw new Error(`Unknown step action "${body.action}".`);
+                    });
+                    json(response, { ok: true });
+                    return;
+                }
+                case '/api/undo':
+                    undo();
+                    json(response, { ok: true });
+                    return;
+                case '/api/replay':
+                    replay(body);
+                    json(response, { ok: true });
+                    return;
+                case '/api/replay/stop':
+                    replayAbort?.abort();
+                    json(response, { ok: true });
+                    return;
                 case '/api/settings':
                     state.settings = {
                         name: String(body.name ?? state.settings.name),
                         packageName: String(body.packageName ?? state.settings.packageName),
                         testIdAttribute: String(body.testIdAttribute || state.settings.testIdAttribute),
+                        logSteps: Boolean(body.logSteps ?? state.settings.logSteps),
+                        dataDriven: Boolean(body.dataDriven ?? state.settings.dataDriven),
                     };
                     broadcast();
                     json(response, { ok: true });
@@ -159,7 +308,9 @@ export async function startUiServer(options) {
                         outDir,
                         ...generationOptions(state.settings),
                     });
-                    json(response, { written: writeTargets(outputs).map(file => path.relative(options.cwd, file) || file) });
+                    const { written, kept } = writeTargets(outputs);
+                    const relative = (file) => path.relative(options.cwd, file) || file;
+                    json(response, { written: written.map(relative), kept: kept.map(relative) });
                     return;
                 }
             }
@@ -178,6 +329,7 @@ export async function startUiServer(options) {
         url: `http://${options.host === '0.0.0.0' ? 'localhost' : options.host}:${address.port}/`,
         close: async () => {
             stopRecorder({ detach: true });
+            replayAbort?.abort();
             clearInterval(watcher);
             for (const client of clients)
                 client.end();
@@ -191,35 +343,82 @@ function generationOptions(settings) {
         name: settings.name || 'recorded',
         packageName: settings.packageName || undefined,
         testIdAttribute: settings.testIdAttribute || 'data-testid',
+        logSteps: settings.logSteps,
+        dataDriven: settings.dataDriven,
     };
 }
-// Steps and generated code for every target, for the current recording.
-function render(state) {
+function fromThisPage(request) {
+    const { origin, host } = request.headers;
+    const site = request.headers['sec-fetch-site'];
+    if (origin !== undefined && origin !== `http://${host}`)
+        return false;
+    if (site !== undefined && site !== 'same-origin' && site !== 'none')
+        return false;
+    return /^application\/json\b/i.test(request.headers['content-type'] ?? '');
+}
+// The parts of a step change the page may send.
+function stepChange(value) {
+    const change = {};
+    if (typeof value?.locator === 'string')
+        change.locator = value.locator;
+    if (typeof value?.value === 'string')
+        change.value = value.value;
+    if (typeof value?.substring === 'boolean')
+        change.substring = value.substring;
+    if (typeof value?.checked === 'boolean')
+        change.checked = value.checked;
+    if (value?.secret === null || value?.secret === false || typeof value?.secret === 'string')
+        change.secret = value.secret;
+    return change;
+}
+// Steps, checks and generated code for every target, for the current recording. Secret values stay
+// on the server: steps show the environment variable instead.
+function render(state, secretValues) {
+    const empty = { steps: [], outputs: {}, checks: [], missingSecrets: [] };
     if (!state.recording.trim())
-        return { steps: [], outputs: {} };
+        return empty;
     let recording;
     try {
         recording = parseRecording(state.recording);
     }
     catch (error) {
-        return { steps: [], outputs: {}, parseError: error.message };
+        return { ...empty, parseError: error.message };
     }
     const outputs = {};
     for (const generator of generators) {
         try {
             const [output] = generateTargets(recording, { targets: [generator.id], ...generationOptions(state.settings) });
-            outputs[generator.id] = { files: output.files };
+            outputs[generator.id] = { files: output.files, checks: checkFiles(output.files) };
         }
         catch (error) {
             outputs[generator.id] = { error: error.message };
         }
     }
+    // Steps and checks show secrets by their environment variable, as a saved recording does.
+    const shown = redactRecording(recording);
+    const secrets = collectSecrets(shown);
     const aliases = new PageAliases();
-    const steps = recording.actions.map(({ action, pageGuid }) => ({ page: aliases.alias(pageGuid), text: describeAction(action) }));
-    return { steps, outputs, recordedTestIdAttribute: recordedTestIdAttribute(recording) };
+    const steps = shown.actions.map(({ action, pageGuid }, index) => {
+        const secret = secrets.of(index)?.name;
+        const fields = stepFields(shown, index, secrets);
+        if (secret) {
+            delete fields.value;
+            fields.secret = secret;
+        }
+        return { page: aliases.alias(pageGuid), text: describeAction(action, secret), fields };
+    });
+    return {
+        steps,
+        outputs,
+        checks: checkRecording(shown),
+        missingSecrets: missingSecrets(recording, secretValues),
+        recordedTestIdAttribute: recordedTestIdAttribute(recording),
+    };
 }
-function describeAction(action) {
+// `secret` names the environment variable a step types or expects, instead of its value.
+function describeAction(action, secret) {
     const target = 'selector' in action ? describeSelector(action.selector) : '';
+    const value = (text) => secret ? `secret ${secret}` : JSON.stringify(text);
     switch (action.name) {
         case 'openPage': return `open page${action.url && action.url !== 'about:blank' ? ' ' + action.url : ''}`;
         case 'closePage': return 'close page';
@@ -228,12 +427,12 @@ function describeAction(action) {
         case 'hover': return `hover ${target}`;
         case 'check': return `check ${target}`;
         case 'uncheck': return `uncheck ${target}`;
-        case 'fill': return `fill ${target} with ${JSON.stringify(action.text)}`;
+        case 'fill': return `fill ${target} with ${value(action.text)}`;
         case 'press': return `press ${action.key} in ${target}`;
         case 'select': return `select ${action.options.join(', ')} in ${target}`;
         case 'setInputFiles': return `upload ${action.files.join(', ')} to ${target}`;
-        case 'assertText': return `expect ${target} ${action.substring ? 'to contain' : 'to have'} text ${JSON.stringify(action.text)}`;
-        case 'assertValue': return `expect ${target} to have value ${JSON.stringify(action.value)}`;
+        case 'assertText': return `expect ${target} ${action.substring ? 'to contain' : 'to have'} text ${value(action.text)}`;
+        case 'assertValue': return `expect ${target} to have value ${value(action.value)}`;
         case 'assertChecked': return `expect ${target} to be ${action.checked ? 'checked' : 'unchecked'}`;
         case 'assertVisible': return `expect ${target} to be visible`;
         case 'assertSnapshot': return `expect ${target} to match aria snapshot`;

package/dist/vendor/playwright/locatorParser.js

@@ -0,0 +1,235 @@
+/**
+ * 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 { asLocators } from './locatorGenerators.js';
+import { encodeTestIdAttributeName } from './locatorUtils.js';
+import { parseSelector } from './selectorParser.js';
+import { escapeForAttributeSelector, escapeForTextSelector } from './stringUtils.js';
+function parseLocator(locator, testIdAttributeName) {
+    locator = locator
+        .replace(/AriaRole\s*\.\s*([\w]+)/g, (_, group) => group.toLowerCase())
+        .replace(/(get_by_role|getByRole)\s*\(\s*(?:["'`])([^'"`]+)['"`]/g, (_, group1, group2) => `${group1}(${group2.toLowerCase()}`);
+    const params = [];
+    let template = '';
+    for (let i = 0; i < locator.length; ++i) {
+        const quote = locator[i];
+        if (quote !== '"' && quote !== '\'' && quote !== '`' && quote !== '/') {
+            template += quote;
+            continue;
+        }
+        const isRegexEscaping = locator[i - 1] === 'r' || locator[i] === '/';
+        ++i;
+        let text = '';
+        while (i < locator.length) {
+            if (locator[i] === '\\') {
+                if (isRegexEscaping) {
+                    if (locator[i + 1] !== quote)
+                        text += locator[i];
+                    ++i;
+                    text += locator[i];
+                }
+                else {
+                    ++i;
+                    if (locator[i] === 'n')
+                        text += '\n';
+                    else if (locator[i] === 'r')
+                        text += '\r';
+                    else if (locator[i] === 't')
+                        text += '\t';
+                    else
+                        text += locator[i];
+                }
+                ++i;
+                continue;
+            }
+            if (locator[i] !== quote) {
+                text += locator[i++];
+                continue;
+            }
+            break;
+        }
+        params.push({ quote, text });
+        template += (quote === '/' ? 'r' : '') + '$' + params.length;
+    }
+    // Equalize languages.
+    template = template.toLowerCase()
+        .replace(/get_by_alt_text/g, 'getbyalttext')
+        .replace(/get_by_test_id/g, 'getbytestid')
+        .replace(/get_by_([\w]+)/g, 'getby$1')
+        .replace(/has_not_text/g, 'hasnottext')
+        .replace(/has_text/g, 'hastext')
+        .replace(/has_not/g, 'hasnot')
+        .replace(/frame_locator/g, 'framelocator')
+        .replace(/content_frame/g, 'contentframe')
+        .replace(/[{}\s]/g, '')
+        .replace(/new\(\)/g, '')
+        .replace(/new[\w]+\.[\w]+options\(\)/g, '')
+        .replace(/\.set/g, ',set')
+        .replace(/\.or_\(/g, 'or(') // Python has "or_" instead of "or".
+        .replace(/\.and_\(/g, 'and(') // Python has "and_" instead of "and".
+        .replace(/:/g, '=')
+        .replace(/,re\.ignorecase/g, 'i')
+        .replace(/,pattern.case_insensitive/g, 'i')
+        .replace(/,regexoptions.ignorecase/g, 'i')
+        .replace(/re.compile\(([^)]+)\)/g, '$1') // Python has regex strings as r"foo"
+        .replace(/pattern.compile\(([^)]+)\)/g, 'r$1')
+        .replace(/newregex\(([^)]+)\)/g, 'r$1')
+        .replace(/string=/g, '=')
+        .replace(/regex=/g, '=')
+        .replace(/,,/g, ',')
+        .replace(/,\)/g, ')');
+    const preferredQuote = params.map(p => p.quote).filter(quote => '\'"`'.includes(quote))[0];
+    return { selector: transform(template, params, testIdAttributeName), preferredQuote };
+}
+function countParams(template) {
+    return [...template.matchAll(/\$\d+/g)].length;
+}
+function shiftParams(template, sub) {
+    return template.replace(/\$(\d+)/g, (_, ordinal) => `$${ordinal - sub}`);
+}
+function transform(template, params, testIdAttributeName) {
+    // Recursively handle filter(has=, hasnot=, sethas(), sethasnot()).
+    // TODO: handle and(locator), or(locator), locator(locator), locator(has=, hasnot=, sethas(), sethasnot()).
+    while (true) {
+        const hasMatch = template.match(/filter\(,?(has=|hasnot=|sethas\(|sethasnot\()/);
+        if (!hasMatch)
+            break;
+        // Extract inner locator based on balanced parens.
+        const start = hasMatch.index + hasMatch[0].length;
+        let balance = 0;
+        let end = start;
+        for (; end < template.length; end++) {
+            if (template[end] === '(')
+                balance++;
+            else if (template[end] === ')')
+                balance--;
+            if (balance < 0)
+                break;
+        }
+        // Replace Java sethas(...) and sethasnot(...) with has=... and hasnot=...
+        let prefix = template.substring(0, start);
+        let extraSymbol = 0;
+        if (['sethas(', 'sethasnot('].includes(hasMatch[1])) {
+            // Eat extra ) symbol at the end of sethas(...)
+            extraSymbol = 1;
+            prefix = prefix.replace(/sethas\($/, 'has=').replace(/sethasnot\($/, 'hasnot=');
+        }
+        const paramsCountBeforeHas = countParams(template.substring(0, start));
+        const hasTemplate = shiftParams(template.substring(start, end), paramsCountBeforeHas);
+        const paramsCountInHas = countParams(hasTemplate);
+        const hasParams = params.slice(paramsCountBeforeHas, paramsCountBeforeHas + paramsCountInHas);
+        const hasSelector = JSON.stringify(transform(hasTemplate, hasParams, testIdAttributeName));
+        // Replace filter(has=...) with filter(has2=$5). Use has2 to avoid matching the same filter again.
+        // Replace filter(hasnot=...) with filter(hasnot2=$5). Use hasnot2 to avoid matching the same filter again.
+        template = prefix.replace(/=$/, '2=') + `$${paramsCountBeforeHas + 1}` + shiftParams(template.substring(end + extraSymbol), paramsCountInHas - 1);
+        // Replace inner params with $5 value.
+        const paramsBeforeHas = params.slice(0, paramsCountBeforeHas);
+        const paramsAfterHas = params.slice(paramsCountBeforeHas + paramsCountInHas);
+        params = paramsBeforeHas.concat([{ quote: '"', text: hasSelector }]).concat(paramsAfterHas);
+    }
+    // Transform to selector engines.
+    template = template
+        .replace(/\,set([\w]+)\(([^)]+)\)/g, (_, group1, group2) => ',' + group1.toLowerCase() + '=' + group2.toLowerCase())
+        .replace(/framelocator\(\)/g, 'internal:control=any-frame')
+        .replace(/framelocator\(([^)]+)\)/g, '$1.internal:control=enter-frame')
+        .replace(/contentframe(\(\))?/g, 'internal:control=enter-frame')
+        .replace(/locator\(([^)]+),hastext=([^),]+)\)/g, 'locator($1).internal:has-text=$2')
+        .replace(/locator\(([^)]+),hasnottext=([^),]+)\)/g, 'locator($1).internal:has-not-text=$2')
+        .replace(/locator\(([^)]+),hastext=([^),]+)\)/g, 'locator($1).internal:has-text=$2')
+        .replace(/locator\(([^)]+)\)/g, '$1')
+        .replace(/getbyrole\(([^)]+)\)/g, 'internal:role=$1')
+        .replace(/getbytext\(([^)]+)\)/g, 'internal:text=$1')
+        .replace(/getbylabel\(([^)]+)\)/g, 'internal:label=$1')
+        .replace(/getbytestid\(([^)]+)\)/g, `internal:testid=[${encodeTestIdAttributeName(testIdAttributeName)}=$1]`)
+        .replace(/getby(placeholder|alt|title)(?:text)?\(([^)]+)\)/g, 'internal:attr=[$1=$2]')
+        .replace(/first(\(\))?/g, 'nth=0')
+        .replace(/last(\(\))?/g, 'nth=-1')
+        .replace(/nth\(([^)]+)\)/g, 'nth=$1')
+        .replace(/filter\(,?visible=true\)/g, 'visible=true')
+        .replace(/filter\(,?visible=false\)/g, 'visible=false')
+        .replace(/\.visible(\(\))?(?!=)/g, '.visible=true')
+        .replace(/filter\(,?hastext=([^)]+)\)/g, 'internal:has-text=$1')
+        .replace(/filter\(,?hasnottext=([^)]+)\)/g, 'internal:has-not-text=$1')
+        .replace(/filter\(,?has2=([^)]+)\)/g, 'internal:has=$1')
+        .replace(/filter\(,?hasnot2=([^)]+)\)/g, 'internal:has-not=$1')
+        .replace(/,exact=false/g, '')
+        .replace(/(,name=\$\d+)(,description=\$\d+),exact=true/g, '$1s$2s') // exact=true is shared between name and description, so we need a special case for applying it to both.
+        .replace(/,exact=true/g, 's')
+        .replace(/,includehidden=/g, ',include-hidden=')
+        .replace(/\,/g, '][');
+    const parts = template.split('.');
+    // Turn "internal:control=enter-frame >> nth=0" into "nth=0 >> internal:control=enter-frame"
+    // because these are swapped in locators vs selectors.
+    for (let index = 0; index < parts.length - 1; index++) {
+        if (parts[index] === 'internal:control=enter-frame' && parts[index + 1].startsWith('nth=')) {
+            // Swap nth and enter-frame.
+            const [nth] = parts.splice(index, 1);
+            parts.splice(index + 1, 0, nth);
+        }
+    }
+    // Substitute params.
+    return parts.map(t => {
+        if (!t.startsWith('internal:') || t === 'internal:control')
+            return t.replace(/\$(\d+)/g, (_, ordinal) => { const param = params[+ordinal - 1]; return param.text; });
+        t = t.includes('[') ? t.replace(/\]/, '') + ']' : t;
+        t = t
+            .replace(/(?:r)\$(\d+)(i)?/g, (_, ordinal, suffix) => {
+            const param = params[+ordinal - 1];
+            if (t.startsWith('internal:attr') || t.startsWith('internal:testid') || t.startsWith('internal:role'))
+                return escapeForAttributeSelector(new RegExp(param.text), false) + (suffix || '');
+            return escapeForTextSelector(new RegExp(param.text, suffix), false);
+        })
+            .replace(/\$(\d+)(i|s)?/g, (_, ordinal, suffix) => {
+            const param = params[+ordinal - 1];
+            if (t.startsWith('internal:has=') || t.startsWith('internal:has-not='))
+                return param.text;
+            if (t.startsWith('internal:testid'))
+                return escapeForAttributeSelector(param.text, true);
+            if (t.startsWith('internal:attr') || t.startsWith('internal:role'))
+                return escapeForAttributeSelector(param.text, suffix === 's');
+            return escapeForTextSelector(param.text, suffix === 's');
+        });
+        return t;
+    }).join(' >> ');
+}
+export function locatorOrSelectorAsSelector(language, locator, testIdAttributeName = 'data-testid') {
+    try {
+        return unsafeLocatorOrSelectorAsSelector(language, locator, testIdAttributeName);
+    }
+    catch (e) {
+        return '';
+    }
+}
+export function unsafeLocatorOrSelectorAsSelector(language, locator, testIdAttributeName = 'data-testid') {
+    try {
+        parseSelector(locator);
+        return locator;
+    }
+    catch (e) {
+    }
+    const { selector, preferredQuote } = parseLocator(locator, testIdAttributeName);
+    const locators = asLocators(language, selector, undefined, undefined, preferredQuote);
+    const digest = digestForComparison(language, locator);
+    if (locators.some(candidate => digestForComparison(language, candidate) === digest))
+        return selector;
+    return '';
+}
+function digestForComparison(language, locator) {
+    locator = locator.replace(/\s/g, '');
+    if (language === 'javascript')
+        locator = locator.replace(/\\?["`]/g, '\'').replace(/,{}/g, '');
+    return locator;
+}
+//# sourceMappingURL=locatorParser.js.map