@taqwright/taqwright 0.0.24

package/dist/docs/docs.js

@@ -0,0 +1,173 @@
+  // ─── Syntax highlighting ──────────────────────────────────────────
+  (function () {
+    var KW = /\b(?:import|export|from|const|let|var|async|await|function|return|if|else|for|of|in|try|catch|throw|new|class|extends|interface|type|declare|module|true|false|null|undefined)\b/g;
+    function esc(s) {
+      return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    }
+    function highlight(src) {
+      var out = '';
+      var i = 0;
+      while (i < src.length) {
+        var ch = src[i];
+        var two = src.substr(i, 2);
+        if (two === '//') {
+          var end = src.indexOf('\n', i);
+          if (end === -1) end = src.length;
+          out += '<span class="tok-com">' + src.slice(i, end) + '</span>';
+          i = end;
+          continue;
+        }
+        if (two === '/*') {
+          var bend = src.indexOf('*/', i + 2);
+          if (bend === -1) bend = src.length;
+          else bend += 2;
+          out += '<span class="tok-com">' + src.slice(i, bend) + '</span>';
+          i = bend;
+          continue;
+        }
+        if (ch === '"' || ch === "'" || ch === '`') {
+          var quote = ch;
+          var j = i + 1;
+          while (j < src.length && src[j] !== quote) {
+            if (src[j] === '\\') j += 2;
+            else j++;
+          }
+          j++;
+          out += '<span class="tok-str">' + src.slice(i, j) + '</span>';
+          i = j;
+          continue;
+        }
+        if (/[A-Za-z_$]/.test(ch)) {
+          var k = i;
+          while (k < src.length && /[A-Za-z0-9_$]/.test(src[k])) k++;
+          var word = src.slice(i, k);
+          var rest = src.slice(k);
+          var isCall = /^\s*\(/.test(rest);
+          if (KW.test(word)) {
+            KW.lastIndex = 0;
+            out += '<span class="tok-kw">' + word + '</span>';
+          } else if (isCall) {
+            out += '<span class="tok-fn">' + word + '</span>';
+          } else {
+            out += word;
+          }
+          i = k;
+          continue;
+        }
+        if (/[0-9]/.test(ch)) {
+          var n = i;
+          while (n < src.length && /[0-9._]/.test(src[n])) n++;
+          out += '<span class="tok-num">' + src.slice(i, n) + '</span>';
+          i = n;
+          continue;
+        }
+        out += ch;
+        i++;
+      }
+      return out;
+    }
+    document.querySelectorAll('pre.code > code').forEach(function (el) {
+      var raw = el.textContent;
+      el.innerHTML = highlight(esc(raw));
+    });
+  })();
+
+  // ─── Copy-to-clipboard ───────────────────────────────────────────
+  document.querySelectorAll('pre.code .copy').forEach(function (btn) {
+    btn.addEventListener('click', function () {
+      var code = btn.parentElement.querySelector('code');
+      var text = code.textContent;
+      var done = function () {
+        btn.classList.add('copied');
+        btn.textContent = 'Copied';
+        setTimeout(function () {
+          btn.classList.remove('copied');
+          btn.textContent = 'Copy';
+        }, 1200);
+      };
+      if (navigator.clipboard && navigator.clipboard.writeText) {
+        navigator.clipboard.writeText(text).then(done, done);
+      } else {
+        var ta = document.createElement('textarea');
+        ta.value = text;
+        document.body.appendChild(ta);
+        ta.select();
+        try { document.execCommand('copy'); } catch (e) {}
+        document.body.removeChild(ta);
+        done();
+      }
+    });
+  });
+
+  // ─── Right TOC scrollspy ─────────────────────────────────────────
+  (function () {
+    var links = Array.prototype.slice.call(document.querySelectorAll('aside.onthispage a'));
+    var byHref = {};
+    links.forEach(function (a) {
+      var id = a.getAttribute('href').slice(1);
+      if (id) byHref[id] = a;
+    });
+    var headings = document.querySelectorAll('main h2[id], main h3[id]');
+    function onScroll() {
+      var top = window.scrollY + 90;
+      var current = null;
+      for (var i = 0; i < headings.length; i++) {
+        if (headings[i].offsetTop <= top) current = headings[i].id;
+      }
+      links.forEach(function (a) { a.classList.remove('active'); });
+      if (current && byHref[current]) byHref[current].classList.add('active');
+    }
+    window.addEventListener('scroll', onScroll, { passive: true });
+    onScroll();
+  })();
+
+  // ─── Theme toggle (light / dark) ─────────────────────────────────
+  (function () {
+    var btn = document.getElementById('theme-toggle');
+    if (!btn) return;
+    var root = document.documentElement;
+    function sync() {
+      var light = root.getAttribute('data-theme') === 'light';
+      var label = light ? 'Switch to dark theme' : 'Switch to light theme';
+      btn.setAttribute('aria-label', label);
+      btn.setAttribute('title', label);
+    }
+    sync();
+    btn.addEventListener('click', function () {
+      var light = root.getAttribute('data-theme') === 'light';
+      if (light) root.removeAttribute('data-theme');
+      else root.setAttribute('data-theme', 'light');
+      try { localStorage.setItem('tw-theme', light ? 'dark' : 'light'); } catch (e) {}
+      sync();
+    });
+  })();
+
+  // ─── Collapsible sidebar groups ──────────────────────────────────
+  (function () {
+    var KEY = 'tw-sidebar-collapsed';
+    var collapsed = {};
+    try { collapsed = JSON.parse(localStorage.getItem(KEY) || '{}') || {}; } catch (e) {}
+    document.querySelectorAll('aside.sidebar h3').forEach(function (h) {
+      var name = h.textContent.trim();
+      if (collapsed[name]) h.classList.add('collapsed');
+      h.addEventListener('click', function () {
+        h.classList.toggle('collapsed');
+        collapsed[name] = h.classList.contains('collapsed');
+        try { localStorage.setItem(KEY, JSON.stringify(collapsed)); } catch (e) {}
+      });
+    });
+  })();
+
+  // ─── Sidebar mobile drawer toggle ────────────────────────────────
+  var toggle = document.getElementById('menu-toggle');
+  var sidebar = document.getElementById('sidebar');
+  if (toggle && sidebar) {
+    toggle.addEventListener('click', function () {
+      sidebar.classList.toggle('open');
+    });
+    sidebar.querySelectorAll('a').forEach(function (a) {
+      a.addEventListener('click', function () {
+        sidebar.classList.remove('open');
+      });
+    });
+  }

package/dist/docs/generating-tests.html

@@ -0,0 +1,161 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Generating tests · taqwright</title>
+<meta name="description" content="Record a runnable taqwright spec with the browser-based inspector and codegen — live locator picking, device driving, and assertions.">
+<link rel="stylesheet" href="styles.css">
+<script>try{var t=localStorage.getItem('tw-theme');if(t==='light'||(!t&&typeof matchMedia==='function'&&matchMedia('(prefers-color-scheme: light)').matches))document.documentElement.setAttribute('data-theme','light');}catch(e){}</script>
+</head>
+<body>
+
+<header class="topbar">
+  <button class="menu-toggle" id="menu-toggle" aria-label="Toggle navigation">☰</button>
+  <a class="brand" href="installation.html"><span class="accent">taq</span>wright</a>
+  <nav class="primary">
+    <a href="installation.html" class="current">Docs</a>
+    <a href="generating-tests.html">Inspector</a>
+    <a href="writing-tests.html#actions">API</a>
+  </nav>
+  <span class="spacer"></span>
+  <div class="search" title="Search (placeholder)">
+    <span>Search docs…</span>
+    <span class="kbd">⌘K</span>
+  </div>
+  <button class="theme-toggle" id="theme-toggle" aria-label="Switch to light theme" title="Switch to light theme"></button>
+  <a class="gh-link" href="https://github.com/taqelah/taqwright" title="GitHub">
+    <svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 .5a11.5 11.5 0 0 0-3.64 22.42c.58.1.79-.25.79-.55v-2.02c-3.2.7-3.88-1.36-3.88-1.36-.52-1.33-1.28-1.68-1.28-1.68-1.05-.71.08-.7.08-.7 1.16.08 1.77 1.19 1.77 1.19 1.03 1.77 2.7 1.26 3.36.96.1-.75.4-1.26.73-1.55-2.55-.29-5.24-1.28-5.24-5.7 0-1.26.45-2.29 1.19-3.1-.12-.29-.52-1.47.11-3.06 0 0 .97-.31 3.18 1.18a11 11 0 0 1 5.79 0c2.21-1.49 3.18-1.18 3.18-1.18.63 1.59.23 2.77.11 3.06.74.81 1.18 1.84 1.18 3.1 0 4.43-2.7 5.4-5.27 5.69.41.36.78 1.06.78 2.14v3.17c0 .31.21.66.8.55A11.5 11.5 0 0 0 12 .5Z"/></svg>
+  </a>
+</header>
+
+<div class="shell">
+
+<aside class="sidebar" id="sidebar">
+  <h3>Getting started</h3>
+  <ul>
+    <li><a href="installation.html">Installation</a></li>
+    <li><a href="writing-tests.html">Writing tests</a></li>
+    <li><a href="generating-tests.html" class="current">Generating tests</a></li>
+    <li class="sub"><a href="generating-tests.html#inspector">Inspector &amp; codegen</a></li>
+    <li class="sub"><a href="generating-tests.html#codegen">Codegen</a></li>
+    <li class="sub"><a href="generating-tests.html#pause">Debug a live test</a></li>
+    <li><a href="running-tests.html">Running &amp; debugging</a></li>
+    <li><a href="custom-reporters.html">Custom reporters</a></li>
+    <li><a href="parallel.html">Parallel runs</a></li>
+    <li><a href="docker.html">Run in Docker</a></li>
+  </ul>
+
+  <h3>Taqwright Test</h3>
+  <ul>
+    <li><a href="configuration.html">Configuration</a></li>
+  </ul>
+
+  <h3>Reference</h3>
+  <ul>
+    <li><a href="https://playwright.dev/docs/intro">Playwright runner ↗</a></li>
+    <li><a href="https://appium.io/docs/en/latest/">Appium 3 ↗</a></li>
+  </ul>
+</aside>
+
+<main>
+
+<div class="breadcrumb">
+  <a href="installation.html">Docs</a> / Getting started / Generating tests
+</div>
+
+<h1>Generating tests</h1>
+<p class="lede">
+  Don't hand-write locators — pick them. The taqwright <strong>inspector</strong> is a browser-based device viewer that ranks candidate selectors against the live screen, and <strong>codegen</strong> is the same inspector with recording on, emitting a runnable spec as you drive the app.
+</p>
+
+<h2 id="inspector">Inspector &amp; codegen</h2>
+<p>The inspector is a browser-based device viewer + locator picker. Run:</p>
+
+<div class="codeblock"><pre class="code"><button class="copy">Copy</button><code>npx taqwright codegen</code></pre></div>
+
+<p>It boots a local server (default port <code>5274</code>) and opens your browser. From the inspector you can:</p>
+<ul>
+  <li><strong>Connect to a device</strong> — local Appium (the inspector will spawn Appium if nothing is listening) or a cloud provider (BrowserStack, LambdaTest).</li>
+  <li><strong>Pick a locator</strong> — tap any element on the live screen. The inspector verifies multiple candidate locators against the device and ranks them by uniqueness and stability. Non-unique candidates get auto-suffixed with <code>.nth(i)</code> so you always get a unique selector.</li>
+  <li><strong>Drive the device</strong> — click, double-tap, long press, fill, swipe, scroll, pinch, drag, hardware buttons, check/uncheck, focus/blur, press, selectOption.</li>
+  <li><strong>Assert</strong> — visible / hidden / enabled / checked / text / value / count / attribute / editable / focused / empty / inViewport / attached. Each assertion verifies on the live device first; if it would fail, you get a "Record anyway?" prompt.</li>
+</ul>
+
+<h2 id="codegen">Codegen</h2>
+<p>Codegen is the same inspector with recording on by default:</p>
+
+<div class="codeblock"><pre class="code"><button class="copy">Copy</button><code>npx taqwright codegen</code></pre></div>
+
+<p>Every action you perform appends a line of taqwright source to the generated spec, which you can copy out as a runnable test. The emitted file is a full <code>import { test, expect } from 'taqwright'; test('recorded test', …)</code> spec — drop it under <code>tests/</code> and <code>npx taqwright test</code> runs it as-is.</p>
+
+<h2 id="pause">Debug a live test</h2>
+<div class="callout">
+  <strong>Use the inspector to debug a live test.</strong>
+  Drop <code>await mobile.pause()</code> mid-test. When the test hits that line, the inspector attaches to the running WebDriver session (no new Appium boot), opens in your browser, and the test resumes when you click <strong>Resume</strong> in the UI. Set <code>PWDEBUG=0</code> to make <code>pause()</code> a no-op in CI without removing it.
+</div>
+<p>
+  This is the interactive counterpart to post-mortem <a href="running-tests.html#tracing">tracing</a> — pause when you want to poke at a stuck step by hand, trace when you want the whole timeline after the fact.
+</p>
+
+<div class="pager">
+  <a href="writing-tests.html">
+    <div class="label">← Previous</div>
+    <div class="title">Writing tests</div>
+  </a>
+  <a class="next" href="running-tests.html">
+    <div class="label">Next →</div>
+    <div class="title">Running &amp; debugging tests</div>
+  </a>
+</div>
+
+</main>
+
+<aside class="onthispage">
+  <h4>On this page</h4>
+  <ol>
+    <li><a href="#inspector">Inspector &amp; codegen</a></li>
+    <li><a href="#codegen">Codegen</a></li>
+    <li><a href="#pause">Debug a live test</a></li>
+  </ol>
+</aside>
+
+</div>
+
+<footer class="bot">
+  <div class="cols">
+    <div>
+      <h5>Getting started</h5>
+      <ul>
+        <li><a href="installation.html">Installation</a></li>
+        <li><a href="writing-tests.html">Writing tests</a></li>
+        <li><a href="generating-tests.html">Generating tests</a></li>
+        <li><a href="running-tests.html">Running &amp; debugging</a></li>
+      </ul>
+    </div>
+    <div>
+      <h5>Guides</h5>
+      <ul>
+        <li><a href="custom-reporters.html">Custom reporters</a></li>
+        <li><a href="parallel.html">Parallel runs</a></li>
+        <li><a href="docker.html">Run in Docker</a></li>
+        <li><a href="writing-tests.html#actions">API surface</a></li>
+      </ul>
+    </div>
+    <div>
+      <h5>Built on</h5>
+      <ul>
+        <li><a href="https://playwright.dev/">Playwright</a></li>
+        <li><a href="https://appium.io/">Appium 3</a></li>
+      </ul>
+    </div>
+  </div>
+  <div class="copy">
+    Apache-2.0 licensed · Built on Playwright + Appium
+  </div>
+</footer>
+
+<script src="docs.js"></script>
+
+</body>
+</html>

package/dist/docs/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta http-equiv="refresh" content="0; url=installation.html">
+<link rel="canonical" href="installation.html">
+<title>taqwright docs</title>
+</head>
+<body>
+<p>Redirecting to <a href="installation.html">Installation</a>…</p>
+<script>location.replace('installation.html');</script>
+</body>
+</html>