@skrillex1224/playwright-toolkit 2.1.226 → 2.1.228

package/index.d.ts

@@ -220,12 +220,51 @@ export interface HumanClickOptions {
     restore?: boolean;
 }
 
+export interface HumanPressOptions {
+    reactionDelay?: number;
+    holdDelay?: number;
+    focusDelay?: number;
+    scrollIfNeeded?: boolean;
+    throwOnMissing?: boolean;
+    keyboardOptions?: Record<string, any>;
+}
+
+export interface MachineClickSelectorOptions {
+    targetParent?: boolean;
+    parent?: boolean;
+    pick?: 'first' | 'last';
+    last?: boolean;
+    visibleOnly?: boolean;
+    fallbackDomClick?: boolean;
+    forceMouse?: boolean;
+    mouseOptions?: Record<string, any>;
+    clickOptions?: Record<string, any>;
+}
+
+export interface MachineHumanizeModule {
+    clickPoint(page: Page, point: { x: number; y: number }, options?: MachineClickSelectorOptions): Promise<boolean>;
+    clickPoint(page: Page, x: number, y: number, options?: MachineClickSelectorOptions): Promise<boolean>;
+    click(page: Page, target: string | { x: number; y: number } | ElementHandle | Locator, options?: Record<string, any>): Promise<boolean>;
+    focus(page: Page, target: string | ElementHandle | Locator, options?: Record<string, any>): Promise<boolean>;
+    fill(page: Page, target: string | ElementHandle | Locator, value: string, options?: Record<string, any>): Promise<boolean>;
+    type(page: Page, text: string, options?: Record<string, any>): Promise<boolean>;
+    type(page: Page, target: string | ElementHandle | Locator, text: string, options?: Record<string, any>): Promise<boolean>;
+    keyboardType(page: Page, text: string, options?: Record<string, any>): Promise<boolean>;
+    selectorCenterPoint(page: Page, selector: string, options?: MachineClickSelectorOptions): Promise<{ x: number; y: number } | null>;
+    domClick(page: Page, selector: string, options?: MachineClickSelectorOptions): Promise<boolean>;
+    clickSelectorCenter(page: Page, selector: string, options?: MachineClickSelectorOptions): Promise<boolean>;
+}
+
 export interface HumanizeModule {
+    /** M = Machine: native/mechanical operations for compatibility paths. */
+    M: MachineHumanizeModule;
     initializeCursor(page: Page): Promise<void>;
     jitterMs(base: number, jitterPercent?: number): number;
     humanMove(page: Page, target: string | { x: number; y: number } | ElementHandle | Locator): Promise<boolean>;
     humanScroll(page: Page, target: string | ElementHandle | Locator, options?: Record<string, any>): Promise<{ element: ElementHandle | Locator | null; didScroll: boolean; restore?: (() => Promise<void>) | null }>;
     humanType(page: Page, selector: string, text: string, options?: HumanTypeOptions): Promise<void>;
+    humanPress(page: Page, key: string, options?: HumanPressOptions): Promise<boolean>;
+    humanPress(page: Page, target: string | ElementHandle | Locator, key: string, options?: HumanPressOptions): Promise<boolean>;
     humanClick(page: Page, target: string | ElementHandle | Locator | null | undefined, options?: HumanClickOptions): Promise<boolean>;
     humanClear(page: Page, selector: string): Promise<void>;
     warmUpBrowsing(page: Page, baseDuration?: number): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skrillex1224/playwright-toolkit",
-  "version": "2.1.226",
+  "version": "2.1.228",
   "description": "一个在 Apify/Crawlee Actor 中启用实时截图视图的实用工具库。",
   "main": "dist/index.cjs",
   "module": "dist/index.js",