@extenshi/cli 0.21.0 → 0.23.0

package/dist/screenshots-scenes.d.ts

@@ -0,0 +1,1383 @@
+/**
+ * Declarative scenes for `extenshi screenshots` — the file format, and the
+ * pure helpers (locale mapping, extension ids, layout, naming) the runner and
+ * its tests share. Nothing here touches a browser.
+ *
+ * scenes.json (version 1):
+ *
+ *   {
+ *     "version": 1,
+ *     "viewport": { "width": 1280, "height": 800 },   // default capture size (CSS px)
+ *     "deviceScaleFactor": 1,                          // 2 = sharper crops, downscaled on compose
+ *     "colorScheme": "light",
+ *     "time": "2026-01-15T10:00:00Z",                  // optional fixed Date.now()
+ *     "fixtures": "fixtures",                          // dir served at http://127.0.0.1:<port>/ (default: scenes dir)
+ *     "frame": { "background": "#eef2ff", "margin": 48, "shadow": true, "radius": 12 },
+ *     "setup": [ { "storage": { "area": "local", "set": { "onboarded": true } } } ],
+ *     "scenes": [
+ *       { "name": "popup", "open": "popup", "steps": [ { "click": "#enable" } ] },
+ *       { "name": "on-a-page", "open": "fixture:article.{locale}.html",
+ *         "steps": [ { "mouse": { "x": 640, "y": 330 } }, { "wait": 400 } ] },
+ *       { "name": "options", "open": "options", "crop": { "selector": "main", "padding": 24 } }
+ *     ]
+ *   }
+ *
+ * `open`: popup | options | page:<extension path> | fixture:<file> | url:<https://…>.
+ * `{locale}` / `{lang}` in `open` expand to the _locales code (pt_BR) / BCP 47 tag (pt-BR).
+ * Steps: click, hover, type (+text), press, mouse {x,y}, scroll {x?,y}, wait <ms>,
+ * waitFor <selector>, storage {area, set?, remove?, clear?} (runs in the
+ * extension's own context), eval <js expression> (runs in the scene page).
+ * `crop`: viewport (default) | content (default for popup) | fullPage | {selector, padding}.
+ * `fit`: contain (default; the capture is centered on the frame background,
+ * never upscaled beyond its captured pixels) | cover (fills the store size).
+ */
+import { z } from 'zod';
+import type { Size } from './store-assets.js';
+export declare const stepSchema: z.ZodUnion<[z.ZodObject<{
+    click: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    click: string;
+}, {
+    click: string;
+}>, z.ZodObject<{
+    hover: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    hover: string;
+}, {
+    hover: string;
+}>, z.ZodObject<{
+    type: z.ZodString;
+    text: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: string;
+    text: string;
+}, {
+    type: string;
+    text: string;
+}>, z.ZodObject<{
+    press: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    press: string;
+}, {
+    press: string;
+}>, z.ZodObject<{
+    mouse: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    mouse: {
+        x: number;
+        y: number;
+    };
+}, {
+    mouse: {
+        x: number;
+        y: number;
+    };
+}>, z.ZodObject<{
+    scroll: z.ZodObject<{
+        x: z.ZodDefault<z.ZodNumber>;
+        y: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        y: number;
+        x?: number | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    scroll: {
+        x: number;
+        y: number;
+    };
+}, {
+    scroll: {
+        y: number;
+        x?: number | undefined;
+    };
+}>, z.ZodObject<{
+    wait: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    wait: number;
+}, {
+    wait: number;
+}>, z.ZodObject<{
+    waitFor: z.ZodString;
+    state: z.ZodDefault<z.ZodEnum<["visible", "hidden", "attached", "detached"]>>;
+}, "strict", z.ZodTypeAny, {
+    waitFor: string;
+    state: "detached" | "visible" | "hidden" | "attached";
+}, {
+    waitFor: string;
+    state?: "detached" | "visible" | "hidden" | "attached" | undefined;
+}>, z.ZodObject<{
+    storage: z.ZodObject<{
+        area: z.ZodDefault<z.ZodEnum<["local", "sync", "session"]>>;
+        set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        remove: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        clear: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        area: "local" | "sync" | "session";
+        set?: Record<string, unknown> | undefined;
+        remove?: string[] | undefined;
+        clear?: boolean | undefined;
+    }, {
+        set?: Record<string, unknown> | undefined;
+        area?: "local" | "sync" | "session" | undefined;
+        remove?: string[] | undefined;
+        clear?: boolean | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    storage: {
+        area: "local" | "sync" | "session";
+        set?: Record<string, unknown> | undefined;
+        remove?: string[] | undefined;
+        clear?: boolean | undefined;
+    };
+}, {
+    storage: {
+        set?: Record<string, unknown> | undefined;
+        area?: "local" | "sync" | "session" | undefined;
+        remove?: string[] | undefined;
+        clear?: boolean | undefined;
+    };
+}>, z.ZodObject<{
+    eval: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    eval: string;
+}, {
+    eval: string;
+}>]>;
+export type Step = z.infer<typeof stepSchema>;
+export declare const OPEN_PATTERN: RegExp;
+declare const sceneSchema: z.ZodObject<{
+    name: z.ZodString;
+    open: z.ZodString;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        width: number;
+        height: number;
+    }, {
+        width: number;
+        height: number;
+    }>>;
+    colorScheme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+    /** JS run before the page's own scripts (Playwright addInitScript). */
+    init: z.ZodOptional<z.ZodString>;
+    steps: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        click: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        click: string;
+    }, {
+        click: string;
+    }>, z.ZodObject<{
+        hover: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        hover: string;
+    }, {
+        hover: string;
+    }>, z.ZodObject<{
+        type: z.ZodString;
+        text: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: string;
+        text: string;
+    }, {
+        type: string;
+        text: string;
+    }>, z.ZodObject<{
+        press: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        press: string;
+    }, {
+        press: string;
+    }>, z.ZodObject<{
+        mouse: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            x: number;
+            y: number;
+        }, {
+            x: number;
+            y: number;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        mouse: {
+            x: number;
+            y: number;
+        };
+    }, {
+        mouse: {
+            x: number;
+            y: number;
+        };
+    }>, z.ZodObject<{
+        scroll: z.ZodObject<{
+            x: z.ZodDefault<z.ZodNumber>;
+            y: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            x: number;
+            y: number;
+        }, {
+            y: number;
+            x?: number | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        scroll: {
+            x: number;
+            y: number;
+        };
+    }, {
+        scroll: {
+            y: number;
+            x?: number | undefined;
+        };
+    }>, z.ZodObject<{
+        wait: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        wait: number;
+    }, {
+        wait: number;
+    }>, z.ZodObject<{
+        waitFor: z.ZodString;
+        state: z.ZodDefault<z.ZodEnum<["visible", "hidden", "attached", "detached"]>>;
+    }, "strict", z.ZodTypeAny, {
+        waitFor: string;
+        state: "detached" | "visible" | "hidden" | "attached";
+    }, {
+        waitFor: string;
+        state?: "detached" | "visible" | "hidden" | "attached" | undefined;
+    }>, z.ZodObject<{
+        storage: z.ZodObject<{
+            area: z.ZodDefault<z.ZodEnum<["local", "sync", "session"]>>;
+            set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            remove: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            clear: z.ZodOptional<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            area: "local" | "sync" | "session";
+            set?: Record<string, unknown> | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        }, {
+            set?: Record<string, unknown> | undefined;
+            area?: "local" | "sync" | "session" | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        storage: {
+            area: "local" | "sync" | "session";
+            set?: Record<string, unknown> | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        };
+    }, {
+        storage: {
+            set?: Record<string, unknown> | undefined;
+            area?: "local" | "sync" | "session" | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        };
+    }>, z.ZodObject<{
+        eval: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        eval: string;
+    }, {
+        eval: string;
+    }>]>, "many">>;
+    crop: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["viewport", "content", "fullPage"]>, z.ZodObject<{
+        selector: z.ZodString;
+        padding: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        selector: string;
+        padding: number;
+    }, {
+        selector: string;
+        padding?: number | undefined;
+    }>]>>;
+    fit: z.ZodDefault<z.ZodEnum<["contain", "cover"]>>;
+    frame: z.ZodOptional<z.ZodObject<{
+        background: z.ZodOptional<z.ZodString>;
+        /** Second colour: a top-to-bottom gradient from `background`. */
+        backgroundTo: z.ZodOptional<z.ZodString>;
+        margin: z.ZodOptional<z.ZodNumber>;
+        shadow: z.ZodOptional<z.ZodBoolean>;
+        radius: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        background?: string | undefined;
+        backgroundTo?: string | undefined;
+        margin?: number | undefined;
+        shadow?: boolean | undefined;
+        radius?: number | undefined;
+    }, {
+        background?: string | undefined;
+        backgroundTo?: string | undefined;
+        margin?: number | undefined;
+        shadow?: boolean | undefined;
+        radius?: number | undefined;
+    }>>;
+    stores: z.ZodOptional<z.ZodArray<z.ZodEnum<["chrome", "edge", "firefox"]>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    open: string;
+    steps: ({
+        click: string;
+    } | {
+        hover: string;
+    } | {
+        type: string;
+        text: string;
+    } | {
+        press: string;
+    } | {
+        mouse: {
+            x: number;
+            y: number;
+        };
+    } | {
+        scroll: {
+            x: number;
+            y: number;
+        };
+    } | {
+        wait: number;
+    } | {
+        waitFor: string;
+        state: "detached" | "visible" | "hidden" | "attached";
+    } | {
+        storage: {
+            area: "local" | "sync" | "session";
+            set?: Record<string, unknown> | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        };
+    } | {
+        eval: string;
+    })[];
+    fit: "contain" | "cover";
+    stores?: ("chrome" | "edge" | "firefox")[] | undefined;
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+    colorScheme?: "light" | "dark" | undefined;
+    init?: string | undefined;
+    crop?: "content" | "viewport" | "fullPage" | {
+        selector: string;
+        padding: number;
+    } | undefined;
+    frame?: {
+        background?: string | undefined;
+        backgroundTo?: string | undefined;
+        margin?: number | undefined;
+        shadow?: boolean | undefined;
+        radius?: number | undefined;
+    } | undefined;
+}, {
+    name: string;
+    open: string;
+    stores?: ("chrome" | "edge" | "firefox")[] | undefined;
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+    colorScheme?: "light" | "dark" | undefined;
+    init?: string | undefined;
+    steps?: ({
+        click: string;
+    } | {
+        hover: string;
+    } | {
+        type: string;
+        text: string;
+    } | {
+        press: string;
+    } | {
+        mouse: {
+            x: number;
+            y: number;
+        };
+    } | {
+        scroll: {
+            y: number;
+            x?: number | undefined;
+        };
+    } | {
+        wait: number;
+    } | {
+        waitFor: string;
+        state?: "detached" | "visible" | "hidden" | "attached" | undefined;
+    } | {
+        storage: {
+            set?: Record<string, unknown> | undefined;
+            area?: "local" | "sync" | "session" | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        };
+    } | {
+        eval: string;
+    })[] | undefined;
+    crop?: "content" | "viewport" | "fullPage" | {
+        selector: string;
+        padding?: number | undefined;
+    } | undefined;
+    fit?: "contain" | "cover" | undefined;
+    frame?: {
+        background?: string | undefined;
+        backgroundTo?: string | undefined;
+        margin?: number | undefined;
+        shadow?: boolean | undefined;
+        radius?: number | undefined;
+    } | undefined;
+}>;
+export type Scene = z.infer<typeof sceneSchema>;
+export declare const scenesFileSchema: z.ZodEffects<z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodDefault<z.ZodLiteral<1>>;
+    viewport: z.ZodDefault<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        width: number;
+        height: number;
+    }, {
+        width: number;
+        height: number;
+    }>>;
+    deviceScaleFactor: z.ZodDefault<z.ZodNumber>;
+    colorScheme: z.ZodDefault<z.ZodEnum<["light", "dark"]>>;
+    time: z.ZodOptional<z.ZodString>;
+    fixtures: z.ZodOptional<z.ZodString>;
+    animations: z.ZodDefault<z.ZodEnum<["disabled", "allow"]>>;
+    frame: z.ZodDefault<z.ZodObject<{
+        background: z.ZodOptional<z.ZodString>;
+        /** Second colour: a top-to-bottom gradient from `background`. */
+        backgroundTo: z.ZodOptional<z.ZodString>;
+        margin: z.ZodOptional<z.ZodNumber>;
+        shadow: z.ZodOptional<z.ZodBoolean>;
+        radius: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        background?: string | undefined;
+        backgroundTo?: string | undefined;
+        margin?: number | undefined;
+        shadow?: boolean | undefined;
+        radius?: number | undefined;
+    }, {
+        background?: string | undefined;
+        backgroundTo?: string | undefined;
+        margin?: number | undefined;
+        shadow?: boolean | undefined;
+        radius?: number | undefined;
+    }>>;
+    setup: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        click: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        click: string;
+    }, {
+        click: string;
+    }>, z.ZodObject<{
+        hover: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        hover: string;
+    }, {
+        hover: string;
+    }>, z.ZodObject<{
+        type: z.ZodString;
+        text: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: string;
+        text: string;
+    }, {
+        type: string;
+        text: string;
+    }>, z.ZodObject<{
+        press: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        press: string;
+    }, {
+        press: string;
+    }>, z.ZodObject<{
+        mouse: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            x: number;
+            y: number;
+        }, {
+            x: number;
+            y: number;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        mouse: {
+            x: number;
+            y: number;
+        };
+    }, {
+        mouse: {
+            x: number;
+            y: number;
+        };
+    }>, z.ZodObject<{
+        scroll: z.ZodObject<{
+            x: z.ZodDefault<z.ZodNumber>;
+            y: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            x: number;
+            y: number;
+        }, {
+            y: number;
+            x?: number | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        scroll: {
+            x: number;
+            y: number;
+        };
+    }, {
+        scroll: {
+            y: number;
+            x?: number | undefined;
+        };
+    }>, z.ZodObject<{
+        wait: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        wait: number;
+    }, {
+        wait: number;
+    }>, z.ZodObject<{
+        waitFor: z.ZodString;
+        state: z.ZodDefault<z.ZodEnum<["visible", "hidden", "attached", "detached"]>>;
+    }, "strict", z.ZodTypeAny, {
+        waitFor: string;
+        state: "detached" | "visible" | "hidden" | "attached";
+    }, {
+        waitFor: string;
+        state?: "detached" | "visible" | "hidden" | "attached" | undefined;
+    }>, z.ZodObject<{
+        storage: z.ZodObject<{
+            area: z.ZodDefault<z.ZodEnum<["local", "sync", "session"]>>;
+            set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            remove: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            clear: z.ZodOptional<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            area: "local" | "sync" | "session";
+            set?: Record<string, unknown> | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        }, {
+            set?: Record<string, unknown> | undefined;
+            area?: "local" | "sync" | "session" | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        storage: {
+            area: "local" | "sync" | "session";
+            set?: Record<string, unknown> | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        };
+    }, {
+        storage: {
+            set?: Record<string, unknown> | undefined;
+            area?: "local" | "sync" | "session" | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        };
+    }>, z.ZodObject<{
+        eval: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        eval: string;
+    }, {
+        eval: string;
+    }>]>, "many">>;
+    scenes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        open: z.ZodString;
+        viewport: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            width: number;
+            height: number;
+        }, {
+            width: number;
+            height: number;
+        }>>;
+        colorScheme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+        /** JS run before the page's own scripts (Playwright addInitScript). */
+        init: z.ZodOptional<z.ZodString>;
+        steps: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodObject<{
+            click: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            click: string;
+        }, {
+            click: string;
+        }>, z.ZodObject<{
+            hover: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            hover: string;
+        }, {
+            hover: string;
+        }>, z.ZodObject<{
+            type: z.ZodString;
+            text: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            type: string;
+            text: string;
+        }, {
+            type: string;
+            text: string;
+        }>, z.ZodObject<{
+            press: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            press: string;
+        }, {
+            press: string;
+        }>, z.ZodObject<{
+            mouse: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                x: number;
+                y: number;
+            }, {
+                x: number;
+                y: number;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            mouse: {
+                x: number;
+                y: number;
+            };
+        }, {
+            mouse: {
+                x: number;
+                y: number;
+            };
+        }>, z.ZodObject<{
+            scroll: z.ZodObject<{
+                x: z.ZodDefault<z.ZodNumber>;
+                y: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                x: number;
+                y: number;
+            }, {
+                y: number;
+                x?: number | undefined;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            scroll: {
+                x: number;
+                y: number;
+            };
+        }, {
+            scroll: {
+                y: number;
+                x?: number | undefined;
+            };
+        }>, z.ZodObject<{
+            wait: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            wait: number;
+        }, {
+            wait: number;
+        }>, z.ZodObject<{
+            waitFor: z.ZodString;
+            state: z.ZodDefault<z.ZodEnum<["visible", "hidden", "attached", "detached"]>>;
+        }, "strict", z.ZodTypeAny, {
+            waitFor: string;
+            state: "detached" | "visible" | "hidden" | "attached";
+        }, {
+            waitFor: string;
+            state?: "detached" | "visible" | "hidden" | "attached" | undefined;
+        }>, z.ZodObject<{
+            storage: z.ZodObject<{
+                area: z.ZodDefault<z.ZodEnum<["local", "sync", "session"]>>;
+                set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                remove: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                clear: z.ZodOptional<z.ZodBoolean>;
+            }, "strict", z.ZodTypeAny, {
+                area: "local" | "sync" | "session";
+                set?: Record<string, unknown> | undefined;
+                remove?: string[] | undefined;
+                clear?: boolean | undefined;
+            }, {
+                set?: Record<string, unknown> | undefined;
+                area?: "local" | "sync" | "session" | undefined;
+                remove?: string[] | undefined;
+                clear?: boolean | undefined;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            storage: {
+                area: "local" | "sync" | "session";
+                set?: Record<string, unknown> | undefined;
+                remove?: string[] | undefined;
+                clear?: boolean | undefined;
+            };
+        }, {
+            storage: {
+                set?: Record<string, unknown> | undefined;
+                area?: "local" | "sync" | "session" | undefined;
+                remove?: string[] | undefined;
+                clear?: boolean | undefined;
+            };
+        }>, z.ZodObject<{
+            eval: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            eval: string;
+        }, {
+            eval: string;
+        }>]>, "many">>;
+        crop: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["viewport", "content", "fullPage"]>, z.ZodObject<{
+            selector: z.ZodString;
+            padding: z.ZodDefault<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            selector: string;
+            padding: number;
+        }, {
+            selector: string;
+            padding?: number | undefined;
+        }>]>>;
+        fit: z.ZodDefault<z.ZodEnum<["contain", "cover"]>>;
+        frame: z.ZodOptional<z.ZodObject<{
+            background: z.ZodOptional<z.ZodString>;
+            /** Second colour: a top-to-bottom gradient from `background`. */
+            backgroundTo: z.ZodOptional<z.ZodString>;
+            margin: z.ZodOptional<z.ZodNumber>;
+            shadow: z.ZodOptional<z.ZodBoolean>;
+            radius: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            background?: string | undefined;
+            backgroundTo?: string | undefined;
+            margin?: number | undefined;
+            shadow?: boolean | undefined;
+            radius?: number | undefined;
+        }, {
+            background?: string | undefined;
+            backgroundTo?: string | undefined;
+            margin?: number | undefined;
+            shadow?: boolean | undefined;
+            radius?: number | undefined;
+        }>>;
+        stores: z.ZodOptional<z.ZodArray<z.ZodEnum<["chrome", "edge", "firefox"]>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        open: string;
+        steps: ({
+            click: string;
+        } | {
+            hover: string;
+        } | {
+            type: string;
+            text: string;
+        } | {
+            press: string;
+        } | {
+            mouse: {
+                x: number;
+                y: number;
+            };
+        } | {
+            scroll: {
+                x: number;
+                y: number;
+            };
+        } | {
+            wait: number;
+        } | {
+            waitFor: string;
+            state: "detached" | "visible" | "hidden" | "attached";
+        } | {
+            storage: {
+                area: "local" | "sync" | "session";
+                set?: Record<string, unknown> | undefined;
+                remove?: string[] | undefined;
+                clear?: boolean | undefined;
+            };
+        } | {
+            eval: string;
+        })[];
+        fit: "contain" | "cover";
+        stores?: ("chrome" | "edge" | "firefox")[] | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | undefined;
+        colorScheme?: "light" | "dark" | undefined;
+        init?: string | undefined;
+        crop?: "content" | "viewport" | "fullPage" | {
+            selector: string;
+            padding: number;
+        } | undefined;
+        frame?: {
+            background?: string | undefined;
+            backgroundTo?: string | undefined;
+            margin?: number | undefined;
+            shadow?: boolean | undefined;
+            radius?: number | undefined;
+        } | undefined;
+    }, {
+        name: string;
+        open: string;
+        stores?: ("chrome" | "edge" | "firefox")[] | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | undefined;
+        colorScheme?: "light" | "dark" | undefined;
+        init?: string | undefined;
+        steps?: ({
+            click: string;
+        } | {
+            hover: string;
+        } | {
+            type: string;
+            text: string;
+        } | {
+            press: string;
+        } | {
+            mouse: {
+                x: number;
+                y: number;
+            };
+        } | {
+            scroll: {
+                y: number;
+                x?: number | undefined;
+            };
+        } | {
+            wait: number;
+        } | {
+            waitFor: string;
+            state?: "detached" | "visible" | "hidden" | "attached" | undefined;
+        } | {
+            storage: {
+                set?: Record<string, unknown> | undefined;
+                area?: "local" | "sync" | "session" | undefined;
+                remove?: string[] | undefined;
+                clear?: boolean | undefined;
+            };
+        } | {
+            eval: string;
+        })[] | undefined;
+        crop?: "content" | "viewport" | "fullPage" | {
+            selector: string;
+            padding?: number | undefined;
+        } | undefined;
+        fit?: "contain" | "cover" | undefined;
+        frame?: {
+            background?: string | undefined;
+            backgroundTo?: string | undefined;
+            margin?: number | undefined;
+            shadow?: boolean | undefined;
+            radius?: number | undefined;
+        } | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    version: 1;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    colorScheme: "light" | "dark";
+    frame: {
+        background?: string | undefined;
+        backgroundTo?: string | undefined;
+        margin?: number | undefined;
+        shadow?: boolean | undefined;
+        radius?: number | undefined;
+    };
+    deviceScaleFactor: number;
+    animations: "disabled" | "allow";
+    setup: ({
+        click: string;
+    } | {
+        hover: string;
+    } | {
+        type: string;
+        text: string;
+    } | {
+        press: string;
+    } | {
+        mouse: {
+            x: number;
+            y: number;
+        };
+    } | {
+        scroll: {
+            x: number;
+            y: number;
+        };
+    } | {
+        wait: number;
+    } | {
+        waitFor: string;
+        state: "detached" | "visible" | "hidden" | "attached";
+    } | {
+        storage: {
+            area: "local" | "sync" | "session";
+            set?: Record<string, unknown> | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        };
+    } | {
+        eval: string;
+    })[];
+    scenes: {
+        name: string;
+        open: string;
+        steps: ({
+            click: string;
+        } | {
+            hover: string;
+        } | {
+            type: string;
+            text: string;
+        } | {
+            press: string;
+        } | {
+            mouse: {
+                x: number;
+                y: number;
+            };
+        } | {
+            scroll: {
+                x: number;
+                y: number;
+            };
+        } | {
+            wait: number;
+        } | {
+            waitFor: string;
+            state: "detached" | "visible" | "hidden" | "attached";
+        } | {
+            storage: {
+                area: "local" | "sync" | "session";
+                set?: Record<string, unknown> | undefined;
+                remove?: string[] | undefined;
+                clear?: boolean | undefined;
+            };
+        } | {
+            eval: string;
+        })[];
+        fit: "contain" | "cover";
+        stores?: ("chrome" | "edge" | "firefox")[] | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | undefined;
+        colorScheme?: "light" | "dark" | undefined;
+        init?: string | undefined;
+        crop?: "content" | "viewport" | "fullPage" | {
+            selector: string;
+            padding: number;
+        } | undefined;
+        frame?: {
+            background?: string | undefined;
+            backgroundTo?: string | undefined;
+            margin?: number | undefined;
+            shadow?: boolean | undefined;
+            radius?: number | undefined;
+        } | undefined;
+    }[];
+    $schema?: string | undefined;
+    time?: string | undefined;
+    fixtures?: string | undefined;
+}, {
+    scenes: {
+        name: string;
+        open: string;
+        stores?: ("chrome" | "edge" | "firefox")[] | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | undefined;
+        colorScheme?: "light" | "dark" | undefined;
+        init?: string | undefined;
+        steps?: ({
+            click: string;
+        } | {
+            hover: string;
+        } | {
+            type: string;
+            text: string;
+        } | {
+            press: string;
+        } | {
+            mouse: {
+                x: number;
+                y: number;
+            };
+        } | {
+            scroll: {
+                y: number;
+                x?: number | undefined;
+            };
+        } | {
+            wait: number;
+        } | {
+            waitFor: string;
+            state?: "detached" | "visible" | "hidden" | "attached" | undefined;
+        } | {
+            storage: {
+                set?: Record<string, unknown> | undefined;
+                area?: "local" | "sync" | "session" | undefined;
+                remove?: string[] | undefined;
+                clear?: boolean | undefined;
+            };
+        } | {
+            eval: string;
+        })[] | undefined;
+        crop?: "content" | "viewport" | "fullPage" | {
+            selector: string;
+            padding?: number | undefined;
+        } | undefined;
+        fit?: "contain" | "cover" | undefined;
+        frame?: {
+            background?: string | undefined;
+            backgroundTo?: string | undefined;
+            margin?: number | undefined;
+            shadow?: boolean | undefined;
+            radius?: number | undefined;
+        } | undefined;
+    }[];
+    version?: 1 | undefined;
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+    colorScheme?: "light" | "dark" | undefined;
+    frame?: {
+        background?: string | undefined;
+        backgroundTo?: string | undefined;
+        margin?: number | undefined;
+        shadow?: boolean | undefined;
+        radius?: number | undefined;
+    } | undefined;
+    $schema?: string | undefined;
+    deviceScaleFactor?: number | undefined;
+    time?: string | undefined;
+    fixtures?: string | undefined;
+    animations?: "disabled" | "allow" | undefined;
+    setup?: ({
+        click: string;
+    } | {
+        hover: string;
+    } | {
+        type: string;
+        text: string;
+    } | {
+        press: string;
+    } | {
+        mouse: {
+            x: number;
+            y: number;
+        };
+    } | {
+        scroll: {
+            y: number;
+            x?: number | undefined;
+        };
+    } | {
+        wait: number;
+    } | {
+        waitFor: string;
+        state?: "detached" | "visible" | "hidden" | "attached" | undefined;
+    } | {
+        storage: {
+            set?: Record<string, unknown> | undefined;
+            area?: "local" | "sync" | "session" | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        };
+    } | {
+        eval: string;
+    })[] | undefined;
+}>, {
+    version: 1;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    colorScheme: "light" | "dark";
+    frame: {
+        background?: string | undefined;
+        backgroundTo?: string | undefined;
+        margin?: number | undefined;
+        shadow?: boolean | undefined;
+        radius?: number | undefined;
+    };
+    deviceScaleFactor: number;
+    animations: "disabled" | "allow";
+    setup: ({
+        click: string;
+    } | {
+        hover: string;
+    } | {
+        type: string;
+        text: string;
+    } | {
+        press: string;
+    } | {
+        mouse: {
+            x: number;
+            y: number;
+        };
+    } | {
+        scroll: {
+            x: number;
+            y: number;
+        };
+    } | {
+        wait: number;
+    } | {
+        waitFor: string;
+        state: "detached" | "visible" | "hidden" | "attached";
+    } | {
+        storage: {
+            area: "local" | "sync" | "session";
+            set?: Record<string, unknown> | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        };
+    } | {
+        eval: string;
+    })[];
+    scenes: {
+        name: string;
+        open: string;
+        steps: ({
+            click: string;
+        } | {
+            hover: string;
+        } | {
+            type: string;
+            text: string;
+        } | {
+            press: string;
+        } | {
+            mouse: {
+                x: number;
+                y: number;
+            };
+        } | {
+            scroll: {
+                x: number;
+                y: number;
+            };
+        } | {
+            wait: number;
+        } | {
+            waitFor: string;
+            state: "detached" | "visible" | "hidden" | "attached";
+        } | {
+            storage: {
+                area: "local" | "sync" | "session";
+                set?: Record<string, unknown> | undefined;
+                remove?: string[] | undefined;
+                clear?: boolean | undefined;
+            };
+        } | {
+            eval: string;
+        })[];
+        fit: "contain" | "cover";
+        stores?: ("chrome" | "edge" | "firefox")[] | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | undefined;
+        colorScheme?: "light" | "dark" | undefined;
+        init?: string | undefined;
+        crop?: "content" | "viewport" | "fullPage" | {
+            selector: string;
+            padding: number;
+        } | undefined;
+        frame?: {
+            background?: string | undefined;
+            backgroundTo?: string | undefined;
+            margin?: number | undefined;
+            shadow?: boolean | undefined;
+            radius?: number | undefined;
+        } | undefined;
+    }[];
+    $schema?: string | undefined;
+    time?: string | undefined;
+    fixtures?: string | undefined;
+}, {
+    scenes: {
+        name: string;
+        open: string;
+        stores?: ("chrome" | "edge" | "firefox")[] | undefined;
+        viewport?: {
+            width: number;
+            height: number;
+        } | undefined;
+        colorScheme?: "light" | "dark" | undefined;
+        init?: string | undefined;
+        steps?: ({
+            click: string;
+        } | {
+            hover: string;
+        } | {
+            type: string;
+            text: string;
+        } | {
+            press: string;
+        } | {
+            mouse: {
+                x: number;
+                y: number;
+            };
+        } | {
+            scroll: {
+                y: number;
+                x?: number | undefined;
+            };
+        } | {
+            wait: number;
+        } | {
+            waitFor: string;
+            state?: "detached" | "visible" | "hidden" | "attached" | undefined;
+        } | {
+            storage: {
+                set?: Record<string, unknown> | undefined;
+                area?: "local" | "sync" | "session" | undefined;
+                remove?: string[] | undefined;
+                clear?: boolean | undefined;
+            };
+        } | {
+            eval: string;
+        })[] | undefined;
+        crop?: "content" | "viewport" | "fullPage" | {
+            selector: string;
+            padding?: number | undefined;
+        } | undefined;
+        fit?: "contain" | "cover" | undefined;
+        frame?: {
+            background?: string | undefined;
+            backgroundTo?: string | undefined;
+            margin?: number | undefined;
+            shadow?: boolean | undefined;
+            radius?: number | undefined;
+        } | undefined;
+    }[];
+    version?: 1 | undefined;
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+    colorScheme?: "light" | "dark" | undefined;
+    frame?: {
+        background?: string | undefined;
+        backgroundTo?: string | undefined;
+        margin?: number | undefined;
+        shadow?: boolean | undefined;
+        radius?: number | undefined;
+    } | undefined;
+    $schema?: string | undefined;
+    deviceScaleFactor?: number | undefined;
+    time?: string | undefined;
+    fixtures?: string | undefined;
+    animations?: "disabled" | "allow" | undefined;
+    setup?: ({
+        click: string;
+    } | {
+        hover: string;
+    } | {
+        type: string;
+        text: string;
+    } | {
+        press: string;
+    } | {
+        mouse: {
+            x: number;
+            y: number;
+        };
+    } | {
+        scroll: {
+            y: number;
+            x?: number | undefined;
+        };
+    } | {
+        wait: number;
+    } | {
+        waitFor: string;
+        state?: "detached" | "visible" | "hidden" | "attached" | undefined;
+    } | {
+        storage: {
+            set?: Record<string, unknown> | undefined;
+            area?: "local" | "sync" | "session" | undefined;
+            remove?: string[] | undefined;
+            clear?: boolean | undefined;
+        };
+    } | {
+        eval: string;
+    })[] | undefined;
+}>;
+export type ScenesFile = z.infer<typeof scenesFileSchema>;
+export declare function parseScenes(raw: string): ScenesFile;
+/** `_locales` code → the BCP 47 tag Chromium's --lang expects (pt_BR → pt-BR, es_419 → es-419). */
+export declare function chromeLang(locale: string): string;
+/**
+ * Which `_locales/<dir>` Chrome renders for a UI locale: the exact locale, then
+ * its language, then default_locale. (chrome.i18n's documented lookup order.)
+ */
+export declare function resolveCatalogLocale(uiLocale: string, available: readonly string[], defaultLocale?: string): string | null;
+export declare function parseLocales(value: string | undefined, available: readonly string[], defaultLocale?: string): string[];
+/**
+ * One message that proves which catalog is active: present in `messages`,
+ * different from the default locale's, and free of `$` placeholders (which
+ * chrome.i18n would substitute).
+ */
+export declare function pickSampleMessage(messages: Record<string, {
+    message?: unknown;
+}> | null, defaults: Record<string, {
+    message?: unknown;
+}> | null): {
+    key: string;
+    message: string;
+} | null;
+/** Chrome's id for an unpacked extension: sha256 of its absolute (real) path, a–p encoded. */
+export declare function extensionIdForPath(realPath: string): string;
+/** Chrome's id when the manifest carries a `key` (base64 DER public key). */
+export declare function extensionIdForKey(key: string): string;
+export interface Placement {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Where a capture of `content` CSS px (captured at `scale` device pixels per
+ * CSS px) lands on a `canvas`: `contain` centers it inside the margin and never
+ * magnifies past its captured pixels; `cover` fills the canvas.
+ */
+export declare function placeCapture(content: Size, canvas: Size, opts: {
+    fit: 'contain' | 'cover';
+    margin: number;
+    scale: number;
+}): Placement;
+export declare function screenshotFileName(index: number, scene: string, size: Size): string;
+/** Width/height from a PNG's IHDR. */
+export declare function pngDimensions(png: Uint8Array): Size;
+/**
+ * macOS Chromium ignores --lang: its UI language comes from AppleLanguages,
+ * which Cocoa reads from `-AppleLanguages (xx)` in argv. Playwright refuses
+ * positional arguments, so this wrapper appends them — and drops Playwright's
+ * trailing `about:blank`, because headless Chromium rejects a second startup
+ * target (the `(xx)` value is parsed as one).
+ */
+export declare function macLocaleWrapper(executable: string, lang: string): string;
+export {};
+//# sourceMappingURL=screenshots-scenes.d.ts.map