@kkeve/suite 0.0.15 → 0.0.18

package/dist/core/auth.js

@@ -1,224 +0,0 @@
-"use strict";
-/**
- * Auth utilities — acquire storage state for Playwright tests
- *
- * 1. Existing valid storage-state.json → skip
- * 2. CDP connect to user Chrome → reuse login state
- * 3. Manual browser login → fallback
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.acquireStorageState = acquireStorageState;
-const fs = __importStar(require("node:fs"));
-const os = __importStar(require("node:os"));
-const path = __importStar(require("node:path"));
-const node_child_process_1 = require("node:child_process"); // getChromeWsUrl 需要用 lsof 检查端口
-const node_module_1 = require("node:module");
-// ─── Playwright Chromium resolver ───────────────────────────────────────────
-async function getChromium() {
-    const cwdRequire = (0, node_module_1.createRequire)(path.resolve(process.cwd(), 'node_modules'));
-    const pwAbsolutePath = cwdRequire.resolve('@playwright/test');
-    const pwModule = await Promise.resolve(`${pwAbsolutePath}`).then(s => __importStar(require(s)));
-    const chromium = pwModule.chromium || pwModule.default?.chromium;
-    if (!chromium)
-        throw new Error('Failed to resolve chromium from @playwright/test');
-    return chromium;
-}
-// ─── Chrome CDP helpers ─────────────────────────────────────────────────────
-function getChromeUserDataDir() {
-    const p = os.platform();
-    const h = os.homedir();
-    if (p === 'darwin')
-        return path.join(h, 'Library', 'Application Support', 'Google', 'Chrome');
-    if (p === 'win32')
-        return path.join(h, 'AppData', 'Local', 'Google', 'Chrome', 'User Data');
-    return path.join(h, '.config', 'google-chrome');
-}
-/** 读取 DevToolsActivePort 获取 CDP WebSocket URL（端口须正在监听） */
-function getChromeWsUrl() {
-    const portFile = path.join(getChromeUserDataDir(), 'DevToolsActivePort');
-    if (!fs.existsSync(portFile))
-        return null;
-    try {
-        const [portStr, wsPath] = fs.readFileSync(portFile, 'utf8').trim().split('\n').map(l => l.trim()).filter(Boolean);
-        const port = parseInt(portStr, 10);
-        if (!port || !wsPath)
-            return null;
-        try {
-            (0, node_child_process_1.execSync)(`lsof -P -i TCP:${port} 2>/dev/null | grep LISTEN`, { encoding: 'utf8' });
-        }
-        catch {
-            return null;
-        }
-        return `ws://127.0.0.1:${port}${wsPath}`;
-    }
-    catch {
-        return null;
-    }
-}
-/** CDP 连接用户 Chrome → 打开目标页 → 保存 storage-state → 断开
- *  仅连接已运行的 Chrome（keve run 已确保 Chrome 启动 + debug 端口就绪）
- */
-async function authViaCDP(targetUrl, storageStatePath, prefix) {
-    const wsUrl = getChromeWsUrl();
-    if (!wsUrl) {
-        console.log(`${prefix} Chrome CDP not available`);
-        return false;
-    }
-    console.log(`${prefix} Chrome CDP available, connecting...`);
-    try {
-        const chromium = await getChromium();
-        const browser = await chromium.connectOverCDP(wsUrl, { timeout: 10000 });
-        const context = browser.contexts()[0];
-        if (!context) {
-            browser.close();
-            return false;
-        }
-        // 访问目标页面，等登录重定向完成
-        const page = await context.newPage();
-        await page.goto(targetUrl, { waitUntil: 'networkidle', timeout: 60000 });
-        await waitForLoginRedirect(page);
-        const onLoginPage = /login|auth|signin/i.test(page.url());
-        if (onLoginPage) {
-            console.log(`${prefix} CDP connected but target requires login`);
-            await page.close();
-            browser.close();
-            return false;
-        }
-        // 保存 storage-state
-        const cookies = await context.cookies();
-        const state = { cookies, origins: [] };
-        fs.writeFileSync(storageStatePath, JSON.stringify(state, null, 2));
-        await page.close();
-        browser.close();
-        console.log(`${prefix} CDP auth success (${cookies.length} cookies) → ${storageStatePath}`);
-        return cookies.length > 0;
-    }
-    catch (e) {
-        console.warn(`${prefix} CDP connect failed: ${e.message}`);
-        return false;
-    }
-}
-function isStorageStateValid(statePath, targetDomain) {
-    if (!fs.existsSync(statePath))
-        return false;
-    try {
-        const s = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
-        if (!s.cookies?.length)
-            return false;
-        if (targetDomain && !s.cookies.some(c => c.domain?.includes(targetDomain)))
-            return false;
-        const now = Date.now() / 1000;
-        return s.cookies.some(c => !c.expires || c.expires === -1 || c.expires > now);
-    }
-    catch {
-        return false;
-    }
-}
-function extractDomain(url) {
-    try {
-        return new URL(url).hostname;
-    }
-    catch {
-        return undefined;
-    }
-}
-async function waitForLoginRedirect(page, maxMs = 30000) {
-    for (let i = 0; i < maxMs / 500; i++) {
-        if (!/login|auth|signin/i.test(page.url()))
-            break;
-        await page.waitForTimeout(500);
-    }
-    await page.waitForLoadState('networkidle', { timeout: 15000 }).catch(() => { });
-    return !/login|auth|signin|sign-in/i.test(page.url());
-}
-/** 手动登录 → 保存 storage-state */
-async function authViaManualLogin(targetUrl, storageStatePath, prefix) {
-    const loginUrl = targetUrl.replace(/\/?$/, '/login');
-    console.log(`${prefix} Opening browser for manual login: ${loginUrl}`);
-    console.log(`${prefix} Please login. Waiting up to 2 minutes...`);
-    try {
-        const browser = await (await getChromium()).launch({ headless: false });
-        const context = await browser.newContext();
-        const page = await context.newPage();
-        await page.goto(loginUrl, { waitUntil: 'domcontentloaded', timeout: 15000 })
-            .catch(() => page.goto(targetUrl, { waitUntil: 'domcontentloaded', timeout: 15000 }));
-        let loginDetected = false;
-        for (let i = 0; i < 120; i++) {
-            if (!/login|auth|signin|sign-in/i.test(page.url())) {
-                loginDetected = true;
-                break;
-            }
-            await page.waitForTimeout(1000);
-        }
-        if (!loginDetected)
-            console.log(`${prefix} Timeout (2min), saving current state...`);
-        await waitForLoginRedirect(page);
-        await context.storageState({ path: storageStatePath });
-        const c = JSON.parse(fs.readFileSync(storageStatePath, 'utf-8')).cookies?.length || 0;
-        console.log(`${prefix} Auth saved (${c} cookies) → ${storageStatePath}`);
-        await browser.close();
-        return c > 0;
-    }
-    catch (e) {
-        console.error(`${prefix} Manual login error: ${e.message}`);
-        return false;
-    }
-}
-async function acquireStorageState(options = {}) {
-    const targetUrl = options.targetUrl || process.env.PWGEN_TARGET_URL || 'http://localhost:3000';
-    const storageStatePath = options.storageStatePath || path.resolve(process.cwd(), '.auth/storage-state.json');
-    const prefix = options.logPrefix || '[keve]';
-    const targetDomain = extractDomain(targetUrl);
-    const authDir = path.dirname(storageStatePath);
-    if (!fs.existsSync(authDir))
-        fs.mkdirSync(authDir, { recursive: true });
-    // Skip mode
-    if (process.env.PWGEN_SKIP_AUTH === '1' || process.env.PWGEN_SKIP_AUTH === 'true') {
-        fs.writeFileSync(storageStatePath, JSON.stringify({ cookies: [], origins: [] }, null, 2));
-        console.log(`${prefix} PWGEN_SKIP_AUTH=1 → empty storage state saved`);
-        return true;
-    }
-    // Step 1: 已有有效 storage-state
-    if (isStorageStateValid(storageStatePath, targetDomain)) {
-        console.log(`${prefix} Storage state valid → ${storageStatePath}`);
-        return true;
-    }
-    // Step 2: CDP 连接用户 Chrome
-    if (await authViaCDP(targetUrl, storageStatePath, prefix))
-        return true;
-    // Step 3: 手动登录
-    return await authViaManualLogin(targetUrl, storageStatePath, prefix);
-}

package/dist/core/cdp-resolver.d.ts

@@ -1,5 +0,0 @@
-export interface CdpResolverOptions {
-    endpoint?: string;
-    wsEndpoint?: string;
-}
-export declare function resolveCdpWsUrl(options: CdpResolverOptions): Promise<string | null>;

package/dist/core/cdp-resolver.js

@@ -1,93 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveCdpWsUrl = resolveCdpWsUrl;
-const fs = __importStar(require("node:fs"));
-const os = __importStar(require("node:os"));
-const path = __importStar(require("node:path"));
-const node_child_process_1 = require("node:child_process");
-// TODO: consolidate doc-reading logic into keve-suite/spec
-function getChromeUserDataDir() {
-    const p = os.platform();
-    const h = os.homedir();
-    if (p === 'darwin')
-        return path.join(h, 'Library', 'Application Support', 'Google', 'Chrome');
-    if (p === 'win32')
-        return path.join(h, 'AppData', 'Local', 'Google', 'Chrome', 'User Data');
-    return path.join(h, '.config', 'google-chrome');
-}
-function getChromeWsUrlFromPort() {
-    const portFile = path.join(getChromeUserDataDir(), 'DevToolsActivePort');
-    if (!fs.existsSync(portFile))
-        return null;
-    try {
-        const [portStr, wsPath] = fs.readFileSync(portFile, 'utf8').trim().split('\n').map(l => l.trim()).filter(Boolean);
-        const port = parseInt(portStr, 10);
-        if (!port || !wsPath)
-            return null;
-        try {
-            (0, node_child_process_1.execSync)(`lsof -P -i TCP:${port} 2>/dev/null | grep LISTEN`, { encoding: 'utf8' });
-        }
-        catch {
-            return null;
-        }
-        return `ws://127.0.0.1:${port}${wsPath}`;
-    }
-    catch {
-        return null;
-    }
-}
-async function fetchWsUrlFromHttpEndpoint(endpoint) {
-    try {
-        const url = endpoint.replace(/\/$/, '') + '/json/version';
-        const res = await fetch(url, { signal: AbortSignal.timeout(5000) });
-        const data = await res.json();
-        return data.webSocketDebuggerUrl || null;
-    }
-    catch (e) {
-        console.warn(`[cdp-resolver] Failed to fetch from ${endpoint}: ${e.message}`);
-        return null;
-    }
-}
-async function resolveCdpWsUrl(options) {
-    if (options.wsEndpoint)
-        return options.wsEndpoint;
-    if (options.endpoint) {
-        const wsUrl = await fetchWsUrlFromHttpEndpoint(options.endpoint);
-        if (wsUrl)
-            return wsUrl;
-    }
-    return getChromeWsUrlFromPort();
-}

package/dist/core/global-setup.d.ts

@@ -1,6 +0,0 @@
-declare global {
-    var __keve_cdp_browser: import('@playwright/test').Browser | undefined;
-}
-export declare function getCdpBrowser(): Promise<import('@playwright/test').Browser | null>;
-export declare function isCdpMode(): boolean;
-export default function (): Promise<void>;

package/dist/core/global-setup.js

@@ -1,123 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCdpBrowser = getCdpBrowser;
-exports.isCdpMode = isCdpMode;
-exports.default = default_1;
-const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
-const auth_1 = require("./auth");
-async function getCdpBrowser() {
-    // 如果已有共享的 browser 对象，直接复用
-    if (globalThis.__keve_cdp_browser && globalThis.__keve_cdp_browser.isConnected()) {
-        return globalThis.__keve_cdp_browser;
-    }
-    const { chromium } = await Promise.resolve().then(() => __importStar(require('@playwright/test')));
-    let wsUrl = process.env.KEVE_CDP_WS_ENDPOINT;
-    // 如果只提供了 HTTP endpoint，自动获取 WebSocket URL
-    if (!wsUrl && process.env.KEVE_CDP_ENDPOINT) {
-        const httpUrl = process.env.KEVE_CDP_ENDPOINT.replace(/\/$/, '');
-        try {
-            const resp = await fetch(`${httpUrl}/json/version`, { signal: AbortSignal.timeout(5000) });
-            const data = await resp.json();
-            wsUrl = data.webSocketDebuggerUrl;
-            console.log(`[keve CDP] Resolved WS endpoint: ${wsUrl}`);
-        }
-        catch (e) {
-            console.warn(`[keve CDP] Failed to resolve CDP WebSocket URL from ${httpUrl}: ${e.message} — falling back to non-CDP mode`);
-            return null;
-        }
-    }
-    if (!wsUrl) {
-        console.warn(`[keve CDP] No CDP endpoint configured — falling back to non-CDP mode`);
-        return null;
-    }
-    try {
-        const browser = await chromium.connectOverCDP(wsUrl, { timeout: 15000 });
-        console.log(`[keve CDP] Connected via ${wsUrl}`);
-        globalThis.__keve_cdp_browser = browser;
-        return browser;
-    }
-    catch (connectErr) {
-        console.warn(`[keve CDP] connectOverCDP failed: ${connectErr.message} — falling back to non-CDP mode`);
-        return null;
-    }
-}
-function isCdpMode() {
-    return !!process.env.KEVE_CDP_WS_ENDPOINT || !!process.env.KEVE_CDP_ENDPOINT;
-}
-async function default_1() {
-    const projectRoot = path.resolve(process.cwd());
-    const storageStatePath = path.resolve(projectRoot, '.auth/storage-state.json');
-    const cdpEndpoint = process.env.KEVE_CDP_ENDPOINT || process.env.KEVE_CDP_WS_ENDPOINT;
-    if (cdpEndpoint) {
-        console.log(`[keve global-setup] CDP endpoint detected: ${cdpEndpoint}`);
-        // CDP 模式：在 global-setup 中提前连接一次，缓存 Browser 对象
-        // getCdpBrowser() 失败时返回 null 并清除 CDP 环境变量 → 后续 fixture 自动 fallback
-        const browser = await getCdpBrowser();
-        if (browser) {
-            const contexts = browser.contexts();
-            const pages = contexts.length > 0 ? contexts[0].pages() : [];
-            console.log(`[keve global-setup] CDP connected. contexts=${contexts.length}, pages=${pages.length}`);
-            if (pages.length > 0) {
-                console.log(`[keve global-setup] Existing tabs: ${pages.map(p => p.url()).join(', ')}`);
-            }
-        }
-        else {
-            console.warn(`[keve global-setup] CDP connection failed — tests will use non-CDP fallback (chromium.launch)`);
-        }
-        if (!fs.existsSync(storageStatePath)) {
-            const authDir = path.dirname(storageStatePath);
-            if (!fs.existsSync(authDir))
-                fs.mkdirSync(authDir, { recursive: true });
-            fs.writeFileSync(storageStatePath, JSON.stringify({ cookies: [], origins: [] }));
-        }
-        return;
-    }
-    console.log(`[keve global-setup] Acquiring fresh auth state...`);
-    const success = await (0, auth_1.acquireStorageState)({
-        logPrefix: '[keve global-setup]',
-    });
-    if (!success) {
-        console.warn(`[keve global-setup] Auth acquisition failed. Tests may fail due to auth issues.`);
-        if (!fs.existsSync(storageStatePath)) {
-            const authDir = path.dirname(storageStatePath);
-            if (!fs.existsSync(authDir))
-                fs.mkdirSync(authDir, { recursive: true });
-            fs.writeFileSync(storageStatePath, JSON.stringify({ cookies: [], origins: [] }));
-            console.log(`[keve global-setup] Created empty storage state → ${storageStatePath}`);
-        }
-    }
-}

package/dist/core/keve-decorators.d.ts

@@ -1,51 +0,0 @@
-/**
- * keve-decorators — @keveModel + @keveScene 装饰器
- *
- * 使用 TC39 Stage 3 装饰器 API (Playwright 1.58+ 默认支持)
- *
- * 执行顺序（TC39 Stage 3 规范）：
- * 1. Method decorator 函数调用 → 注册 addInitializer
- * 2. Class decorator 函数调用 → 注册 addInitializer
- * 3. Method addInitializers 执行 → @keveScene 注册场景到 WeakMap
- * 4. Class addInitializer 执行 → @keveModel 读取 WeakMap 并调用 test.describe
- *
- * 两层装饰器 + 函数调用：
- *   Model (模块) → test.describe → @keveModel
- *   Scene (场景) → test → @keveScene (fn.toString() 捕获完整脚本)
- *   Goal  (步骤) → 步骤元数据 → keveGoal() 函数调用（在方法体内）
- */
-import { type KeveGoalMeta } from './keve-registry';
-/** Called by keve-test.ts to register the extended test instance */
-export declare function setKeveTest(t: any): void;
-/** Get the current keve test instance (extended with fixtures) */
-export declare function getKeveTest(): any;
-export type { KeveGoalMeta, KeveEvalMeta, ErrorCategory } from './keve-registry';
-export interface KeveSceneMeta {
-    id: string;
-    description: string;
-    title: string;
-    code: string;
-    goals: KeveGoalMeta[];
-    fn: Function;
-}
-/**
- * @keveModel(name) — Class decorator (模块层)
- * Uses context.addInitializer to defer test.describe() registration
- * until AFTER all @keveScene addInitializers have run.
- */
-export declare function keveModel(id: string, description: string): <T extends {
-    new (...args: any[]): {};
-}>(ctor: T, context: ClassDecoratorContext) => T;
-/**
- * @keveScene(title) — Method decorator (场景层, static methods only)
- * Captures fn.toString() as the complete scene script.
- * Wraps fn with try-catch-finally to classify errors and decide skipAI.
- * Registers scene metadata to both WeakMap and global Map.
- *
- * The wrapper preserves the original function's destructuring signature by
- * extracting the parameter text from fn.toString() and constructing a wrapper
- * via new Function(), so Playwright can correctly resolve fixture dependencies.
- */
-export declare function keveScene(id: string, description: string): (fn: Function, context: ClassMethodDecoratorContext) => Function;
-/** 获取 Model 下注册的所有 Scene */
-export declare function getModelScenes(ctor: Function): KeveSceneMeta[] | null;

package/dist/core/keve-decorators.js

@@ -1,95 +0,0 @@
-"use strict";
-/**
- * keve-decorators — @keveModel + @keveScene 装饰器
- *
- * 使用 TC39 Stage 3 装饰器 API (Playwright 1.58+ 默认支持)
- *
- * 执行顺序（TC39 Stage 3 规范）：
- * 1. Method decorator 函数调用 → 注册 addInitializer
- * 2. Class decorator 函数调用 → 注册 addInitializer
- * 3. Method addInitializers 执行 → @keveScene 注册场景到 WeakMap
- * 4. Class addInitializer 执行 → @keveModel 读取 WeakMap 并调用 test.describe
- *
- * 两层装饰器 + 函数调用：
- *   Model (模块) → test.describe → @keveModel
- *   Scene (场景) → test → @keveScene (fn.toString() 捕获完整脚本)
- *   Goal  (步骤) → 步骤元数据 → keveGoal() 函数调用（在方法体内）
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setKeveTest = setKeveTest;
-exports.getKeveTest = getKeveTest;
-exports.keveModel = keveModel;
-exports.keveScene = keveScene;
-exports.getModelScenes = getModelScenes;
-const test_1 = require("@playwright/test");
-const keve_registry_1 = require("./keve-registry");
-// ─── Configurable test reference ────────────────────────────────────
-// keveModel needs to call test.describe / test — but it must use the EXTENDED test
-// (with keveGoal/keveAssert fixtures), not the base @playwright/test.
-// keve-test.ts calls setKeveTest() after creating the extended test.
-let _keveTest = test_1.test;
-/** Called by keve-test.ts to register the extended test instance */
-function setKeveTest(t) { _keveTest = t; }
-/** Get the current keve test instance (extended with fixtures) */
-function getKeveTest() { return _keveTest; }
-// ─── Internal Registry (WeakMap per Model constructor) ─────────────
-/** Model → Scene 列表：每个 @keveModel 类下注册的 @keveScene 列表 */
-const modelScenesMap = new WeakMap();
-// ─── Error Classification ──────────────────────────────────────────
-// Error classification moved to keve-report.ts onTestEnd — 
-// onTestEnd has access to result.error and result.status, which is more reliable
-// than try-catch in the decorator (async rejections, test-level timeouts can bypass decorator catch).
-// ─── TC39 Stage 3 Decorators ──────────────────────────────────────
-/**
- * @keveModel(name) — Class decorator (模块层)
- * Uses context.addInitializer to defer test.describe() registration
- * until AFTER all @keveScene addInitializers have run.
- */
-function keveModel(id, description) {
-    return (ctor, context) => {
-        context.addInitializer(function () {
-            const ctor = this;
-            const scenes = modelScenesMap.get(ctor) || [];
-            _keveTest.describe(`${id}: ${description}`, () => {
-                for (const scene of scenes) {
-                    _keveTest(scene.title, scene.fn);
-                }
-            });
-        });
-        return ctor;
-    };
-}
-/**
- * @keveScene(title) — Method decorator (场景层, static methods only)
- * Captures fn.toString() as the complete scene script.
- * Wraps fn with try-catch-finally to classify errors and decide skipAI.
- * Registers scene metadata to both WeakMap and global Map.
- *
- * The wrapper preserves the original function's destructuring signature by
- * extracting the parameter text from fn.toString() and constructing a wrapper
- * via new Function(), so Playwright can correctly resolve fixture dependencies.
- */
-function keveScene(id, description) {
-    return (fn, context) => {
-        const code = fn.toString(); // Capture original code BEFORE wrapping
-        const title = `${id}: ${description}`;
-        // Register the original function directly — Playwright resolves fixture dependencies
-        // by parsing fn.toString() / AST. Wrapping with new Function() breaks this resolution.
-        // Error classification is handled in onTestEnd (keve-report.ts), not here.
-        context.addInitializer(function () {
-            const ctor = this;
-            if (!modelScenesMap.has(ctor))
-                modelScenesMap.set(ctor, []);
-            const scene = { id, description, title, code, goals: [], fn };
-            modelScenesMap.get(ctor).push(scene);
-            // Register to global maps for Reporter access
-            keve_registry_1.sceneCodeMap.set(title, code); // Stores ORIGINAL code, not wrapped
-        });
-        return fn; // Return original function unchanged — preserves fixture parameter signature
-    };
-}
-// ─── Utility ───────────────────────────────────────────────────────
-/** 获取 Model 下注册的所有 Scene */
-function getModelScenes(ctor) {
-    return modelScenesMap.get(ctor) || null;
-}