tabwright 1.0.0

package/dist/performance-profiling.md

@@ -0,0 +1,417 @@
+# Profile Website Performance with Tabwright
+
+Tabwright can profile a real website in your own Chrome using **CDP**, **Navigation Timing**,
+and **PerformanceObserver**.
+
+Use it to answer four practical questions quickly:
+
+1. **Did the page render fast enough?**
+2. **What requests cost the most bytes?**
+3. **What blocked first paint or LCP?**
+4. **What blocked interactivity?**
+
+## What to measure
+
+| Metric | Good | Needs work | Usually means |
+| --- | --- | --- | --- |
+| **TTFB** | under **800ms** | over **1.2s** | slow server or cache miss |
+| **FCP** | under **1.8s** | over **3s** | content appears late |
+| **LCP** | under **2.5s** | over **4s** | hero image, font, CSS, server, or JS delay |
+| **CLS** | under **0.1** | over **0.25** | unstable layout |
+| **Long task** | under **50ms** | over **100ms** | main thread blocked by JS |
+| **JS transfer** | under **250KB** | over **500KB** | too much hydration or client code |
+| **Font / media transfer** | context dependent | large above-the-fold assets | fonts, posters, videos, hero images |
+
+## What usually blocks what
+
+- **First paint / FCP** is usually gated by **TTFB**, critical HTML, critical CSS, and above-the-fold fonts/images.
+- **LCP** is usually gated by the **largest hero asset**. Common causes: hero image, poster image, custom font, render-blocking CSS, or slow server response.
+- **Interactivity** is usually gated by **long tasks**. Common causes: too much JS on startup, hydration, or a large framework chunk.
+- **Load event** often stays late because of **non-critical assets** like videos, analytics, background images, and delayed client bundles.
+
+## Quick commands
+
+Create a session and open a page:
+
+```bash
+tabwright session new
+tabwright -s 1 -e 'state.page = context.pages().find((p) => p.url() === "about:blank") ?? (await context.newPage()); await state.page.goto("https://example.com", { waitUntil: "domcontentloaded" })'
+```
+
+Collect a concise vitals report:
+
+```bash
+tabwright -s 1 -e "$(cat <<'EOF'
+await state.page.evaluate(() => {
+  const metrics = { paints: {}, lcp: 0, cls: 0 }
+  globalThis.__pwMetrics = metrics
+
+  new PerformanceObserver((list) => {
+    for (const entry of list.getEntries()) {
+      metrics.paints[entry.name] = entry.startTime
+    }
+  }).observe({ type: 'paint', buffered: true })
+
+  new PerformanceObserver((list) => {
+    const lastEntry = list.getEntries().at(-1)
+    if (lastEntry) {
+      metrics.lcp = lastEntry.startTime
+    }
+  }).observe({ type: 'largest-contentful-paint', buffered: true })
+
+  new PerformanceObserver((list) => {
+    for (const entry of list.getEntries()) {
+      if (!entry.hadRecentInput) {
+        metrics.cls += entry.value
+      }
+    }
+  }).observe({ type: 'layout-shift', buffered: true })
+})
+
+await state.page.reload({ waitUntil: 'domcontentloaded' })
+await waitForPageLoad({ page: state.page, timeout: 10000 })
+await state.page.waitForTimeout(3000)
+
+const report = await state.page.evaluate(() => {
+  const nav = performance.getEntriesByType('navigation')[0]
+  const metrics = globalThis.__pwMetrics
+  return {
+    ttfb: nav?.responseStart || 0,
+    domContentLoaded: nav?.domContentLoadedEventEnd || 0,
+    load: nav?.loadEventEnd || 0,
+    fcp: metrics?.paints['first-contentful-paint'] || 0,
+    lcp: metrics?.lcp || 0,
+    cls: metrics?.cls || 0,
+  }
+})
+
+console.log(JSON.stringify(report, null, 2))
+EOF
+)"
+```
+
+List the heaviest requests with CDP:
+
+```bash
+tabwright -s 1 -e "$(cat <<'EOF'
+const cdp = await getCDPSession({ page: state.page })
+await cdp.send('Network.enable')
+await cdp.send('Network.setCacheDisabled', { cacheDisabled: true })
+
+const responses = new Map()
+const finished = new Map()
+
+cdp.on('Network.responseReceived', (event) => {
+  responses.set(event.requestId, {
+    url: event.response.url,
+    mimeType: event.response.mimeType,
+  })
+})
+
+cdp.on('Network.loadingFinished', (event) => {
+  finished.set(event.requestId, event.encodedDataLength)
+})
+
+await state.page.reload({ waitUntil: 'domcontentloaded' })
+await waitForPageLoad({ page: state.page, timeout: 10000 })
+await state.page.waitForTimeout(3000)
+
+const largest = [...responses.entries()]
+  .map(([requestId, response]) => ({
+    url: response.url,
+    mimeType: response.mimeType,
+    bytes: finished.get(requestId) || 0,
+  }))
+  .sort((a, b) => b.bytes - a.bytes)
+  .slice(0, 10)
+
+console.log(JSON.stringify(largest, null, 2))
+EOF
+)"
+```
+
+Check interactivity blockers:
+
+```bash
+tabwright -s 1 -e "$(cat <<'EOF'
+await state.page.evaluate(() => {
+  globalThis.__pwLongTasks = []
+  globalThis.__pwEvents = []
+
+  new PerformanceObserver((list) => {
+    globalThis.__pwLongTasks.push(
+      ...list.getEntries().map((entry) => ({ startTime: entry.startTime, duration: entry.duration })),
+    )
+  }).observe({ type: 'longtask', buffered: true })
+
+  new PerformanceObserver((list) => {
+    globalThis.__pwEvents.push(
+      ...list.getEntries().map((entry) => ({
+        name: entry.name,
+        duration: entry.duration,
+        interactionId: entry.interactionId,
+      })),
+    )
+  }).observe({ type: 'event', buffered: true, durationThreshold: 16 })
+})
+
+await state.page.getByRole('button').first().click()
+await state.page.waitForTimeout(1000)
+
+const report = await state.page.evaluate(() => ({
+  longTasks: globalThis.__pwLongTasks.filter((entry) => entry.duration >= 50),
+  interactions: globalThis.__pwEvents.filter((entry) => entry.interactionId !== 0),
+}))
+
+console.log(JSON.stringify(report, null, 2))
+EOF
+)"
+```
+
+## How to read the results
+
+**Fast render, heavy payload**
+
+- If **FCP** and **LCP** are good but total bytes are huge, the page probably **looks fast on desktop** but wastes bandwidth on mobile.
+- This often happens with **hero videos**, large poster images, or custom fonts.
+
+**Slow first paint**
+
+- If **TTFB** is high, fix **server latency** or caching first.
+- If **TTFB** is fine but **FCP** is slow, inspect critical CSS, fonts, and above-the-fold images.
+
+**Slow interactivity**
+
+- If you see **long tasks over 50ms**, startup JS is the first suspect.
+- Look for large client bundles, hydration-heavy UI, and event handlers doing too much work.
+
+**Need deeper CPU answers**
+
+- If vitals and request sizes are not enough, record a **`.cpuprofile`** with Tabwright's raw **`Profiler.*`** CDP commands and inspect it with **[profano](https://github.com/remorses/profano)**.
+- A good place to keep your reusable profiling snippets is your dots repo, for example **`~/.config/opencode/`**.
+
+**Good load event is not enough**
+
+- A page can have a decent `load` time and still feel slow if **LCP** or **long tasks** are bad.
+- Prefer **TTFB + FCP + LCP + CLS + long tasks** over the load event alone.
+
+## Performance checklist
+
+**If TTFB is bad**
+
+- cache HTML closer to users
+- reduce origin work before response
+- avoid expensive server-side data fetching on the critical route
+
+**If FCP or LCP is bad**
+
+- trim or defer render-blocking CSS
+- avoid large above-the-fold fonts and images
+- preload only truly critical assets
+- compress hero media harder
+
+**If interactivity is bad**
+
+- reduce startup JS
+- split large client bundles
+- avoid hydrating UI that is not immediately interactive
+- move optional widgets behind user action or idle time
+- if the culprit is still unclear, switch from vitals to a CPU profile and inspect hot functions with **profano**
+
+**If bytes are bad but vitals look good**
+
+- optimize for slower devices anyway
+- background videos are the first thing to cut
+- subset fonts and trim non-critical client features
+
+## Examples
+
+```ts
+// Example snippets for profiling website performance with Tabwright and CDP.
+
+import { console, getCDPSession, page } from './debugger-examples-types.js'
+
+type PerfMetrics = {
+  paints: Record<string, number>
+  lcp: number
+  cls: number
+}
+
+type ObservedPerfEntry = {
+  name: string
+  startTime: number
+  duration: number
+  hadRecentInput?: boolean
+  value?: number
+  interactionId?: number
+}
+
+type NavigationTimingEntry = {
+  responseStart: number
+  domContentLoadedEventEnd: number
+  loadEventEnd: number
+}
+
+type LongTaskEntry = {
+  startTime: number
+  duration: number
+}
+
+type EventTimingEntry = {
+  name: string
+  duration: number
+  interactionId: number
+}
+
+// Example: Collect navigation timing and basic web vitals from the current page
+async function collectWebVitals() {
+  await page.evaluate(() => {
+    const metrics: PerfMetrics = {
+      paints: {},
+      lcp: 0,
+      cls: 0,
+    }
+
+    const perfGlobal = globalThis as typeof globalThis & {
+      __pwPerfMetrics?: PerfMetrics
+    }
+
+    perfGlobal.__pwPerfMetrics = metrics
+
+    new PerformanceObserver((list) => {
+      for (const entry of list.getEntries() as ObservedPerfEntry[]) {
+        metrics.paints[entry.name] = entry.startTime
+      }
+    }).observe({ type: 'paint', buffered: true } as never)
+
+    new PerformanceObserver((list) => {
+      const entries = list.getEntries() as ObservedPerfEntry[]
+      const lastEntry = entries[entries.length - 1]
+      if (!lastEntry) {
+        return
+      }
+      metrics.lcp = lastEntry.startTime
+    }).observe({ type: 'largest-contentful-paint', buffered: true } as never)
+
+    new PerformanceObserver((list) => {
+      for (const entry of list.getEntries() as ObservedPerfEntry[]) {
+        if (entry.hadRecentInput) {
+          continue
+        }
+        metrics.cls += entry.value || 0
+      }
+    }).observe({ type: 'layout-shift', buffered: true } as never)
+  })
+
+  await page.reload({ waitUntil: 'domcontentloaded' })
+
+  const report = await page.evaluate(() => {
+    const perfGlobal = globalThis as typeof globalThis & {
+      __pwPerfMetrics?: PerfMetrics
+    }
+    const nav = performance.getEntriesByType('navigation' as never)[0] as unknown as
+      | NavigationTimingEntry
+      | undefined
+    const metrics = perfGlobal.__pwPerfMetrics
+
+    return {
+      ttfb: nav?.responseStart || 0,
+      domContentLoaded: nav?.domContentLoadedEventEnd || 0,
+      load: nav?.loadEventEnd || 0,
+      fcp: metrics?.paints['first-contentful-paint'] || 0,
+      lcp: metrics?.lcp || 0,
+      cls: metrics?.cls || 0,
+    }
+  })
+
+  console.log(report)
+}
+
+// Example: Measure the biggest transferred requests with raw CDP network events
+async function collectHeaviestRequests() {
+  const cdp = await getCDPSession({ page })
+  await cdp.send('Network.enable')
+  await cdp.send('Network.setCacheDisabled', { cacheDisabled: true })
+
+  const responses = new Map<string, { url: string; mimeType: string }>()
+  const finished = new Map<string, number>()
+
+  cdp.on('Network.responseReceived', (event) => {
+    responses.set(event.requestId, {
+      url: event.response.url,
+      mimeType: event.response.mimeType,
+    })
+  })
+
+  cdp.on('Network.loadingFinished', (event) => {
+    finished.set(event.requestId, event.encodedDataLength)
+  })
+
+  await page.reload({ waitUntil: 'domcontentloaded' })
+
+  const largest = [...responses.entries()]
+    .map(([requestId, response]) => {
+      return {
+        url: response.url,
+        mimeType: response.mimeType,
+        bytes: finished.get(requestId) || 0,
+      }
+    })
+    .sort((a, b) => b.bytes - a.bytes)
+    .slice(0, 10)
+
+  console.log(largest)
+}
+
+// Example: Check whether interactivity is blocked by long tasks or slow events
+async function measureInteractivity() {
+  await page.evaluate(() => {
+    const perfGlobal = globalThis as typeof globalThis & {
+      __pwLongTasks?: LongTaskEntry[]
+      __pwEventTimings?: EventTimingEntry[]
+    }
+
+    perfGlobal.__pwLongTasks = []
+    perfGlobal.__pwEventTimings = []
+
+    new PerformanceObserver((list) => {
+      perfGlobal.__pwLongTasks?.push(
+        ...(list.getEntries() as ObservedPerfEntry[]).map((entry) => ({
+          startTime: entry.startTime,
+          duration: entry.duration,
+        })),
+      )
+    }).observe({ type: 'longtask', buffered: true } as never)
+
+    new PerformanceObserver((list) => {
+      perfGlobal.__pwEventTimings?.push(
+        ...(list.getEntries() as ObservedPerfEntry[]).map((entry) => ({
+          name: entry.name,
+          duration: entry.duration,
+          interactionId: entry.interactionId || 0,
+        })),
+      )
+    }).observe({ type: 'event', buffered: true, durationThreshold: 16 } as never)
+  })
+
+  const button = page.getByRole('button').first()
+  await button.click()
+
+  const report = await page.evaluate(() => {
+    const perfGlobal = globalThis as typeof globalThis & {
+      __pwLongTasks?: LongTaskEntry[]
+      __pwEventTimings?: EventTimingEntry[]
+    }
+
+    return {
+      longTasks: (perfGlobal.__pwLongTasks || []).filter((entry) => entry.duration >= 50),
+      events: (perfGlobal.__pwEventTimings || []).filter((entry) => entry.interactionId !== 0),
+    }
+  })
+
+  console.log(report)
+}
+
+export { collectWebVitals, collectHeaviestRequests, measureInteractivity }
+
+```

package/dist/playwright-import.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Conditional playwright-core import. When patchright mode is enabled via
+ * TABWRIGHT_PATCHRIGHT=1 env var, imports from @playwriter/patchright-core
+ * instead of @xmorse/playwright-core. Both packages expose identical APIs.
+ *
+ * Type imports continue to use @xmorse/playwright-core directly (types are
+ * the same in both packages) so TypeScript resolution works without the
+ * optional patchright dep being installed.
+ */
+export type { Page, Frame, Browser, BrowserContext, Locator, FrameLocator, ElementHandle, CDPSession, MouseActionEvent, } from '@xmorse/playwright-core';
+export type { BrowserType } from '@xmorse/playwright-core';
+type Chromium = typeof import('@xmorse/playwright-core').chromium;
+/**
+ * Returns the chromium BrowserType, loading from patchright-core if enabled.
+ * Caches after first call.
+ */
+export declare function getChromium(): Promise<Chromium>;
+export declare function isPatchrightEnabled(): boolean;
+//# sourceMappingURL=playwright-import.d.ts.map

package/dist/playwright-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-import.d.ts","sourceRoot":"","sources":["../src/playwright-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,IAAI,EACJ,KAAK,EACL,OAAO,EACP,cAAc,EACd,OAAO,EACP,YAAY,EACZ,aAAa,EACb,UAAU,EACV,gBAAgB,GACjB,MAAM,yBAAyB,CAAA;AAEhC,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,KAAK,QAAQ,GAAG,cAAc,yBAAyB,EAAE,QAAQ,CAAA;AAIjE;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,CAqBrD;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAG7C"}

package/dist/playwright-import.js

@@ -0,0 +1,40 @@
+/**
+ * Conditional playwright-core import. When patchright mode is enabled via
+ * TABWRIGHT_PATCHRIGHT=1 env var, imports from @playwriter/patchright-core
+ * instead of @xmorse/playwright-core. Both packages expose identical APIs.
+ *
+ * Type imports continue to use @xmorse/playwright-core directly (types are
+ * the same in both packages) so TypeScript resolution works without the
+ * optional patchright dep being installed.
+ */
+let _chromium;
+/**
+ * Returns the chromium BrowserType, loading from patchright-core if enabled.
+ * Caches after first call.
+ */
+export async function getChromium() {
+    if (_chromium) {
+        return _chromium;
+    }
+    if (isPatchrightEnabled()) {
+        try {
+            // Dynamic import — @playwriter/patchright-core is an optional dependency.
+            // Types come from @xmorse/playwright-core (identical API surface).
+            const mod = await import('@playwriter/patchright-core');
+            _chromium = mod.chromium;
+        }
+        catch (e) {
+            throw new Error('@playwriter/patchright-core is not installed. Install it with: pnpm add @playwriter/patchright-core', { cause: e });
+        }
+    }
+    else {
+        const mod = await import('@xmorse/playwright-core');
+        _chromium = mod.chromium;
+    }
+    return _chromium;
+}
+export function isPatchrightEnabled() {
+    const value = process.env.TABWRIGHT_PATCHRIGHT || process.env.PLAYWRITER_PATCHRIGHT;
+    return value === '1' || value === 'true';
+}
+//# sourceMappingURL=playwright-import.js.map

package/dist/playwright-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-import.js","sourceRoot":"","sources":["../src/playwright-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,IAAI,SAA+B,CAAA;AAEnC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,mBAAmB,EAAE,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,0EAA0E;YAC1E,mEAAmE;YACnE,MAAM,GAAG,GAA2B,MAAM,MAAM,CAAC,6BAAuC,CAAC,CAAA;YACzF,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAA;QAC1B,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,qGAAqG,EACrG,EAAE,KAAK,EAAE,CAAC,EAAE,CACb,CAAA;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAA;QACnD,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAA;IAC1B,CAAC;IACD,OAAO,SAAU,CAAA;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAA;IACnF,OAAO,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM,CAAA;AAC1C,CAAC"}

package/dist/popup-relocation.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for auto-relocation of popup windows to tabs.
+ * - Connected source tab → popup gets relocated + auto-attached.
+ * - No source tab connected → popup is left alone.
+ */
+import './test-declarations.js';
+//# sourceMappingURL=popup-relocation.test.d.ts.map

package/dist/popup-relocation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup-relocation.test.d.ts","sourceRoot":"","sources":["../src/popup-relocation.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,wBAAwB,CAAA"}

package/dist/popup-relocation.test.js

@@ -0,0 +1,139 @@
+/**
+ * Tests for auto-relocation of popup windows to tabs.
+ * - Connected source tab → popup gets relocated + auto-attached.
+ * - No source tab connected → popup is left alone.
+ */
+import { createMCPClient } from './mcp-client.js';
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { setupTestContext, cleanupTestContext, getExtensionServiceWorker, createSimpleServer, js, } from './test-utils.js';
+import './test-declarations.js';
+const TEST_PORT = 19995;
+describe('Popup window relocation', () => {
+    let client;
+    let cleanup = null;
+    let testCtx = null;
+    let htmlServer = null;
+    beforeAll(async () => {
+        testCtx = await setupTestContext({
+            port: TEST_PORT,
+            tempDirPrefix: 'pw-popup-test-',
+            toggleExtension: true,
+        });
+        const result = await createMCPClient({ port: TEST_PORT });
+        client = result.client;
+        cleanup = result.cleanup;
+        htmlServer = await createSimpleServer({
+            routes: {
+                '/opener': `<!doctype html>
+<html>
+  <body>
+    <button id="open-popup" onclick="window.open('/target', '', 'width=400,height=300,popup=1')">Open popup</button>
+  </body>
+</html>`,
+                '/target': `<!doctype html>
+<html>
+  <body>
+    <h1 id="target-heading">Popup target page</h1>
+  </body>
+</html>`,
+            },
+        });
+    }, 600000);
+    afterAll(async () => {
+        if (htmlServer) {
+            await htmlServer.close();
+        }
+        await cleanupTestContext(testCtx, cleanup);
+        cleanup = null;
+        testCtx = null;
+    });
+    it('relocates popup window into main browser context as a tab', async () => {
+        if (!htmlServer)
+            throw new Error('html server not initialized');
+        const browserContext = testCtx.browserContext;
+        const serviceWorker = await getExtensionServiceWorker(browserContext);
+        await client.callTool({
+            name: 'execute',
+            arguments: {
+                code: js `
+          state.popupTestPage = context.pages().find((p) => p.url() === 'about:blank') ?? (await context.newPage());
+          await state.popupTestPage.goto('${htmlServer.baseUrl}/opener', { waitUntil: 'domcontentloaded' });
+          return { url: state.popupTestPage.url(), pagesBefore: context.pages().length };
+        `,
+            },
+        });
+        const clickResult = await client.callTool({
+            name: 'execute',
+            arguments: {
+                code: js `
+          await state.popupTestPage.click('#open-popup');
+          await state.popupTestPage.waitForTimeout(1500);
+          return { pagesAfter: context.pages().length, allUrls: context.pages().map((p) => p.url()) };
+        `,
+            },
+        });
+        const clickOutput = clickResult.content[0].text;
+        expect(clickOutput).toContain('/target');
+        expect(clickResult.isError).not.toBe(true);
+        expect(clickOutput).toContain('[WARNING] New page opened from current page');
+        expect(clickOutput).not.toContain('Popup window detected');
+        expect(clickOutput).not.toContain('cannot be controlled by playwriter');
+        const windowTypes = await serviceWorker.evaluate(async () => {
+            const windows = await chrome.windows.getAll({ populate: false });
+            return windows.map((w) => w.type);
+        });
+        expect(windowTypes).not.toContain('popup');
+        expect(windowTypes).toContain('normal');
+        await client.callTool({
+            name: 'execute',
+            arguments: {
+                code: js `
+          const targetPage = context.pages().find((p) => p.url().endsWith('/target'));
+          if (targetPage) { await targetPage.close(); }
+          await state.popupTestPage.close();
+          delete state.popupTestPage;
+        `,
+            },
+        });
+    }, 60000);
+    it('leaves popup windows alone when no Tabwright tab is connected', async () => {
+        if (!htmlServer)
+            throw new Error('html server not initialized');
+        const browserContext = testCtx.browserContext;
+        const serviceWorker = await getExtensionServiceWorker(browserContext);
+        await serviceWorker.evaluate(async () => {
+            await globalThis.disconnectEverything();
+        });
+        await new Promise((r) => {
+            setTimeout(r, 200);
+        });
+        // Drive the browser directly via browserContext (not MCP/extension) so
+        // the opener tab stays unconnected.
+        const unconnectedPage = await browserContext.newPage();
+        await unconnectedPage.goto(`${htmlServer.baseUrl}/opener`, { waitUntil: 'domcontentloaded' });
+        await unconnectedPage.bringToFront();
+        await unconnectedPage.click('#open-popup');
+        // If relocation DID happen, the popup window would be gone by now.
+        await new Promise((r) => {
+            setTimeout(r, 1500);
+        });
+        const windowTypes = await serviceWorker.evaluate(async () => {
+            const windows = await chrome.windows.getAll({ populate: false });
+            return windows.map((w) => w.type);
+        });
+        expect(windowTypes).toContain('popup');
+        const windowIdsToClose = await serviceWorker.evaluate(async () => {
+            const windows = await chrome.windows.getAll({ populate: false });
+            return windows.filter((w) => w.type === 'popup').map((w) => w.id);
+        });
+        for (const windowId of windowIdsToClose) {
+            if (windowId !== undefined) {
+                await serviceWorker.evaluate(async (id) => {
+                    await chrome.windows.remove(id);
+                }, windowId);
+            }
+        }
+        await unconnectedPage.close();
+    }, 60000);
+});
+//# sourceMappingURL=popup-relocation.test.js.map

package/dist/popup-relocation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup-relocation.test.js","sourceRoot":"","sources":["../src/popup-relocation.test.ts"],"names":[],"mappings":"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"}

package/dist/product-paths.d.ts

@@ -0,0 +1,9 @@
+export declare const TABWRIGHT_DATA_DIR_NAME = ".tabwright";
+export declare const LEGACY_PLAYWRITER_DATA_DIR_NAME = ".playwriter";
+export declare function getTabwrightUserDataDir(options?: {
+    homeDir?: string;
+}): string;
+export declare function getTabwrightProjectDataDir(options?: {
+    cwd?: string;
+}): string;
+//# sourceMappingURL=product-paths.d.ts.map

package/dist/product-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-paths.d.ts","sourceRoot":"","sources":["../src/product-paths.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,uBAAuB,eAAe,CAAA;AACnD,eAAO,MAAM,+BAA+B,gBAAgB,CAAA;AAE5D,wBAAgB,uBAAuB,CAAC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CASlF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CASjF"}

package/dist/product-paths.js

@@ -0,0 +1,24 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+export const TABWRIGHT_DATA_DIR_NAME = '.tabwright';
+export const LEGACY_PLAYWRITER_DATA_DIR_NAME = '.playwriter';
+export function getTabwrightUserDataDir(options = {}) {
+    const homeDir = options.homeDir || os.homedir();
+    const currentDir = path.join(homeDir, TABWRIGHT_DATA_DIR_NAME);
+    const legacyDir = path.join(homeDir, LEGACY_PLAYWRITER_DATA_DIR_NAME);
+    if (!fs.existsSync(currentDir) && fs.existsSync(legacyDir)) {
+        return legacyDir;
+    }
+    return currentDir;
+}
+export function getTabwrightProjectDataDir(options = {}) {
+    const cwd = options.cwd || process.cwd();
+    const currentDir = path.join(cwd, TABWRIGHT_DATA_DIR_NAME);
+    const legacyDir = path.join(cwd, LEGACY_PLAYWRITER_DATA_DIR_NAME);
+    if (!fs.existsSync(currentDir) && fs.existsSync(legacyDir)) {
+        return legacyDir;
+    }
+    return currentDir;
+}
+//# sourceMappingURL=product-paths.js.map