@doxbrix/doxloop 0.1.4 → 0.2.0

package/dist/capture.d.ts

@@ -1,4 +1,44 @@
 import type { DesignReference } from './types.js';
+export interface PlaywrightPage {
+    goto(url: string, options?: object): Promise<{
+        url(): string;
+    } | null>;
+    waitForTimeout(milliseconds: number): Promise<void>;
+    screenshot(options: object): Promise<unknown>;
+    setContent(html: string, options?: object): Promise<void>;
+    evaluate<T>(script: string): Promise<T>;
+    evaluate<T, A>(callback: (argument: A) => T | Promise<T>, argument: A): Promise<T>;
+    evaluate<T>(callback: () => T | Promise<T>): Promise<T>;
+    addScriptTag(options: {
+        content: string;
+    }): Promise<unknown>;
+    keyboard: {
+        press(key: string): Promise<void>;
+    };
+    route(pattern: string, handler: (route: PlaywrightRoute) => Promise<void>): Promise<void>;
+    url(): string;
+}
+interface PlaywrightRoute {
+    request(): {
+        url(): string;
+        isNavigationRequest(): boolean;
+    };
+    abort(reason?: string): Promise<void>;
+    continue(): Promise<void>;
+}
+export interface PlaywrightContext {
+    newPage(): Promise<PlaywrightPage>;
+    close(): Promise<void>;
+}
+export interface PlaywrightBrowser {
+    newContext(options: object): Promise<PlaywrightContext>;
+    close(): Promise<void>;
+}
+export interface PlaywrightModule {
+    chromium: {
+        launch(options?: object): Promise<PlaywrightBrowser>;
+    };
+}
 export declare function toolsDir(): string;
 export declare function resolveCaptureUrls(references: DesignReference[], requested: string[]): string[];
 export declare function captureSlug(raw: string): string;
@@ -7,4 +47,12 @@ export declare function capture(options: {
     urls: string[];
 }): Promise<void>;
 export declare function isPrivateAddress(address: string): boolean;
+export declare function ensurePlaywright(): Promise<PlaywrightModule>;
+/**
+ * The managed Playwright when it is already installed, without installing
+ * anything: quick checks (such as the sign-in probe) must never start a
+ * download of a few hundred MB, so they fall back when this is undefined.
+ */
+export declare function loadInstalledPlaywright(): Promise<PlaywrightModule | undefined>;
+export {};
 //# sourceMappingURL=capture.d.ts.map

package/dist/capture.js

@@ -256,7 +256,7 @@ const EXTRACT_SCRIPT = String.raw `(() => {
 async function extractStyles(page) {
     return page.evaluate(EXTRACT_SCRIPT);
 }
-async function ensurePlaywright() {
+export async function ensurePlaywright() {
     const directory = toolsDir();
     const entry = join(directory, 'node_modules', 'playwright', 'index.js');
     const browserSentinel = join(directory, '.chromium-ready');
@@ -283,6 +283,25 @@ async function ensurePlaywright() {
     }
     return playwright;
 }
+/**
+ * The managed Playwright when it is already installed, without installing
+ * anything: quick checks (such as the sign-in probe) must never start a
+ * download of a few hundred MB, so they fall back when this is undefined.
+ */
+export async function loadInstalledPlaywright() {
+    const directory = toolsDir();
+    const entry = join(directory, 'node_modules', 'playwright', 'index.js');
+    if (!(await pathExists(entry)) || !(await pathExists(join(directory, '.chromium-ready'))))
+        return undefined;
+    try {
+        const loaded = (await import(pathToFileURL(entry).href));
+        const playwright = 'chromium' in loaded ? loaded : loaded.default;
+        return playwright?.chromium ? playwright : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 function npmCommand() {
     return process.platform === 'win32' ? 'npm.cmd' : 'npm';
 }