@yule-h2o/web_auto_flow 0.0.5

package/dist/share/bootstrap.d.ts

@@ -0,0 +1,14 @@
+import { Stagehand } from "@browserbasehq/stagehand";
+import type { PlanDefinition } from "./compose";
+export interface BrowserOptions {
+    stagehand?: {
+        model?: string;
+        headless?: boolean;
+    };
+}
+export declare function createChromeProfile(baseDir: string): string;
+export declare function createBrowser(baseDir: string, options?: BrowserOptions): Promise<{
+    stagehand: Stagehand;
+    page: import("playwright-core").Page;
+}>;
+export declare function runPlan(plan: PlanDefinition, options?: BrowserOptions): Promise<import("./types").TestReport>;

package/dist/share/compose.d.ts

@@ -0,0 +1,131 @@
+import type { PageLike } from "../core/rule-engine/types";
+import type { RuleResult } from "../core/rule-engine/types";
+import type { AIResult } from "../core/ai-engine/types";
+import type { TestReport, TestContextOptions } from "./types";
+import { RuleTest } from "../core/rule-engine/RuleTest";
+import { AITest } from "../core/ai-engine/AITest";
+/**
+ * 可自动执行的 RuleTest
+ *
+ * 用法：
+ *   await check("名称").element("input").performance("FCP")
+ *   //                      ↑ 链式构建       ↑
+ *   //        ↑ await 触发 .run(page)
+ */
+declare class AutoRuleTest extends RuleTest {
+    private _page;
+    private _onResult;
+    constructor(name: string, page: PageLike, onResult: (r: RuleResult) => void);
+    element: (selector: string, opts?: import("../core/rule-engine/types").ElementAssertionOptions) => this;
+    text: (selector: string, expected: string | RegExp, opts?: import("../core/rule-engine/types").TextAssertionOptions) => this;
+    attribute: (selector: string, attribute: string, expected: string | RegExp, opts?: import("../core/rule-engine/types").AttributeAssertionOptions) => this;
+    url: (expected: string | RegExp, opts?: import("../core/rule-engine/types").NavigationAssertionOptions) => this;
+    title: (expected: string | RegExp, opts?: import("../core/rule-engine/types").NavigationAssertionOptions) => this;
+    meta: (metaName: string, expected: string | RegExp, opts?: import("../core/rule-engine/types").NavigationAssertionOptions) => this;
+    status: (urlOrPattern: string | RegExp, expectedStatus: number, opts?: import("../core/rule-engine/types").NetworkAssertionOptions) => this;
+    performance: (metric: import("../core/rule-engine/assertions/performance").PerfMetric, opts?: import("../core/rule-engine/types").PerformanceAssertionOptions, customValue?: number) => this;
+    accessibility: (selector: string, opts?: import("../core/rule-engine/types").AccessibilityAssertionOptions) => this;
+    custom: (label: string, fn: (page: PageLike) => Promise<Omit<import("./types").AssertionResult, "type">>) => this;
+    then<TResult1 = RuleResult, TResult2 = never>(onfulfilled?: ((value: RuleResult) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+}
+/**
+ * 可自动执行的 AITest
+ *
+ * 用法：
+ *   await inspect("名称").anomaly().sentiment(".msg", "positive")
+ */
+declare class AutoAITest extends AITest {
+    private _page;
+    private _onResult;
+    constructor(name: string, page: PageLike, onResult: (r: AIResult) => void, stagehand: any);
+    anomaly: (opts?: import("../core/ai-engine/types").AnomalyOptions) => this;
+    sentiment: (selector: string, expected: "positive" | "negative" | "neutral", criteria?: string) => this;
+    quality: (selector: string, opts: import("../core/ai-engine/types").QualityOptions) => this;
+    then<TResult1 = AIResult, TResult2 = never>(onfulfilled?: ((value: AIResult) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+}
+/** 网络抓包器 */
+export interface CapturedResponse {
+    url: string;
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+    timestamp: number;
+}
+export interface NetworkRecorder {
+    getCalls: () => CapturedResponse[];
+    filter: (urlPattern: string | RegExp) => CapturedResponse[];
+    assertCall: (urlPattern: string | RegExp, opts?: {
+        status?: number;
+        bodySchema?: Record<string, string>;
+        bodyContains?: string;
+    }) => {
+        passed: boolean;
+        message: string;
+    };
+}
+export interface TestContext {
+    /** 计划名称 */
+    name: string;
+    /** Playwright Page */
+    page: PageLike;
+    /** Stagehand 实例 */
+    stagehand: any;
+    /** 元素是否在页面上 */
+    has: (selector: string) => Promise<boolean>;
+    /** 一组选择器哪个在页面上，返回索引；都不在返回 -1 */
+    which: (selectors: string[]) => Promise<number>;
+    /** 点击第一个/第 n 个可见元素 */
+    click: (selector: string, nth?: number) => Promise<void>;
+    /** 填充输入框 */
+    fill: (selector: string, value: string) => Promise<void>;
+    /** 截图（自动编号） */
+    screenshot: (label: string) => Promise<void>;
+    /** 等待 */
+    sleep: (ms: number) => Promise<void>;
+    /** AI 交互（act + anomaly），失败自动降级 */
+    ai: (instruction: string) => Promise<void>;
+    /** 等待元素出现（超时 10s） */
+    wait: (selector: string, timeout?: number) => Promise<void>;
+    /** Rule Engine 断言 */
+    check: (name: string) => AutoRuleTest;
+    /** 抓包 */
+    network: () => NetworkRecorder;
+    /** 编排任务：原生 + AI Fallback */
+    task: (label: string, fn: (page: PageLike) => Promise<void>, aiFallback?: string) => Promise<boolean>;
+    inspect: (name: string) => AutoAITest;
+}
+export declare function createTestContext(page: PageLike, options?: TestContextOptions): TestContext;
+export interface PlanDefinition {
+    /** 运行测试，返回报告 */
+    run: (page: PageLike, options?: {
+        stagehand?: any;
+        outputDir?: string;
+    }) => Promise<TestReport>;
+    /** 计划名称 */
+    name: string;
+}
+/**
+ * 定义测试计划
+ *
+ * @example
+ * ```ts
+ * export default definePlan("PWA 登录", async ({ page, has, click, fill, screenshot, check, ai }) => {
+ *   await page.goto("https://example.com/login");
+ *
+ *   await check("登录页元素")
+ *     .element("input", { minCount: 2 })
+ *     .performance("FCP", { lt: 3000 });
+ *
+ *   await fill('input[type="email"]', "test@test.com");
+ *   await click('[type="submit"]');
+ *   await screenshot("登录后");
+ *
+ *   await check("登录结果")
+ *     .url("/dashboard");
+ * });
+ * ```
+ */
+export declare function definePlan(name: string, setup: (ctx: TestContext) => Promise<void>): PlanDefinition;
+/** 判断当前文件是否作为入口直接运行 */
+export declare function isMain(metaUrl: string): boolean;
+export {};

package/dist/share/html-reporter.d.ts

@@ -0,0 +1,2 @@
+import type { TestReport } from "./types";
+export declare function writeHtmlReport(report: TestReport, outputDir: string): string;

package/dist/share/network.d.ts

@@ -0,0 +1,7 @@
+export interface CapturedResponse {
+    url: string;
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+    timestamp: number;
+}

package/dist/share/reporter.d.ts

@@ -0,0 +1,13 @@
+import type { RuleResult, AIResult, TestReport } from "./types";
+export declare class Reporter {
+    private planName;
+    private startedAt;
+    private screenshots;
+    constructor(planName: string);
+    /** 构建报告 */
+    build(ruleResults: RuleResult[], aiResults: AIResult[], actionTotal: number, actionFailed: number): TestReport;
+    private buildRuleLayer;
+    private buildAILayer;
+}
+/** 在控制台打印报告摘要 */
+export declare function printReport(report: TestReport): void;

package/dist/share/types.d.ts

@@ -0,0 +1,51 @@
+import type { RuleResult, AssertionResult, PageLike } from "../core/rule-engine/types";
+import type { AIResult, AIAssertionResult } from "../core/ai-engine/types";
+export type { RuleResult, AssertionResult, AIResult, AIAssertionResult, PageLike };
+/** 单层报告摘要 */
+export interface LayerSummary {
+    passed: number;
+    failed: number;
+    skipped: number;
+    total: number;
+    passRate: number;
+    duration: number;
+}
+/** 失败项 */
+export interface FailureItem {
+    layer: "rule" | "ai" | "action";
+    testName: string;
+    assertionName: string;
+    message: string;
+    details?: string;
+}
+/** 测试报告 */
+export interface TestReport {
+    planName: string;
+    startedAt: string;
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        skipped: number;
+        duration: number;
+        costEstimate: number;
+    };
+    layers: {
+        rule: LayerSummary;
+        ai: LayerSummary | null;
+        actions: {
+            total: number;
+            failed: number;
+        };
+    };
+    failures: FailureItem[];
+    artifacts: {
+        screenshots: string[];
+    };
+}
+/** 上下文配置 */
+export interface TestContextOptions {
+    stagehand?: any;
+    outputDir?: string;
+    planName?: string;
+}

package/dist/share/user-config.d.ts

@@ -0,0 +1,33 @@
+export interface H2OUserConfig {
+    /** AI 配置 */
+    ai?: {
+        /** API Key */
+        apiKey?: string;
+        /** 模型标识 */
+        model?: string;
+        /** 请求超时 (ms) */
+        timeout?: number;
+        /** 温度 */
+        temperature?: number;
+        /** 最大 token */
+        maxTokens?: number;
+    };
+    /** 输出配置 */
+    output?: {
+        /** 日志/截图/报告 输出根目录，默认 "./logs" */
+        dir?: string;
+    };
+    /** 浏览器配置 */
+    browser?: {
+        /** 无头模式 */
+        headless?: boolean;
+        /** 视口 */
+        viewport?: {
+            width: number;
+            height: number;
+        };
+    };
+}
+/** 定义配置（纯类型助手，不做运行时处理） */
+export declare function defineConfig(config: H2OUserConfig): H2OUserConfig;
+export declare function loadUserConfig(): Promise<H2OUserConfig>;

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@yule-h2o/web_auto_flow",
+  "version": "0.0.5",
+  "type": "module",
+  "description": "Playwright + Stagehand AI 端到端自动化测试框架",
+  "keywords": [
+    "testing",
+    "e2e",
+    "playwright",
+    "stagehand",
+    "ai",
+    "automation"
+  ],
+  "author": "820125507@qq.com",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "prepublishOnly": "pnpm build"
+  },
+  "packageManager": "pnpm@10.28.2",
+  "dependencies": {
+    "@browserbasehq/stagehand": "^3.5.0",
+    "playwright-core": "^1.61.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "rollup": "^4.62.2",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3"
+  }
+}