leapfrog-mcp 0.6.2 → 0.6.3

package/dist/paginate.d.ts

@@ -0,0 +1,42 @@
+import type { Page } from "playwright-core";
+import type { Session } from "./types.js";
+export interface PaginateOptions {
+    extractType: "text" | "html" | "js";
+    extractTarget?: string;
+    extractJs?: string;
+    nextSelector: string;
+    paginationType: "click" | "scroll" | "url";
+    urlPattern?: string;
+    maxPages: number;
+    delayMs: number;
+    maxCharsPerPage: number;
+    stopWhen: "no_next" | "empty" | "duplicate" | "auto";
+}
+export interface PaginatePageResult {
+    pageNum: number;
+    url: string;
+    data: string;
+    tokens: number;
+}
+export interface PaginateMetadata {
+    totalPages: number;
+    stoppedBecause: "no_next" | "empty" | "duplicate" | "max_pages" | "error" | "blocked";
+    totalChars: number;
+    urls: string[];
+    duration: number;
+}
+export interface PaginateResult {
+    pages: PaginatePageResult[];
+    metadata: PaginateMetadata;
+}
+/**
+ * Execute a full pagination loop in a single call.
+ *
+ * Supports three pagination strategies:
+ * - **click**: Finds and clicks a "next" button each iteration
+ * - **scroll**: Infinite-scroll with height-change detection
+ * - **url**: Iterates through URL patterns with {page} placeholder
+ *
+ * Returns extracted content from each page plus metadata about the run.
+ */
+export declare function paginate(page: Page, session: Session, opts: PaginateOptions): Promise<PaginateResult>;