@extenshi/cli 0.20.0 → 0.22.0

package/dist/screenshots-scenes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots-scenes.d.ts","sourceRoot":"","sources":["../src/screenshots-scenes.ts"],"names":[],"mappings":"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"}

package/dist/screenshots-scenes.js

@@ -0,0 +1,276 @@
+/**
+ * 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 { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { InvalidInputError } from './expected-error.js';
+const selector = z.string().min(1).max(500);
+const color = z
+    .string()
+    .max(60)
+    .regex(/^(#[0-9a-f]{3,8}|[a-z]{3,20}|rgba?\([\d\s.,%]+\))$/i, 'must be a CSS color (#hex, rgb() or a name)');
+export const stepSchema = z.union([
+    z.object({ click: selector }).strict(),
+    z.object({ hover: selector }).strict(),
+    z.object({ type: selector, text: z.string().max(2000) }).strict(),
+    z.object({ press: z.string().min(1).max(40) }).strict(),
+    z
+        .object({
+        mouse: z.object({ x: z.number().min(0).max(10000), y: z.number().min(0).max(10000) }).strict(),
+    })
+        .strict(),
+    z.object({ scroll: z.object({ x: z.number().default(0), y: z.number() }).strict() }).strict(),
+    z.object({ wait: z.number().int().min(0).max(30_000) }).strict(),
+    z
+        .object({
+        waitFor: selector,
+        state: z.enum(['visible', 'hidden', 'attached', 'detached']).default('visible'),
+    })
+        .strict(),
+    z
+        .object({
+        storage: z
+            .object({
+            area: z.enum(['local', 'sync', 'session']).default('local'),
+            set: z.record(z.unknown()).optional(),
+            remove: z.array(z.string().max(200)).max(100).optional(),
+            clear: z.boolean().optional(),
+        })
+            .strict(),
+    })
+        .strict(),
+    z.object({ eval: z.string().min(1).max(20_000) }).strict(),
+]);
+const viewportSchema = z
+    .object({ width: z.number().int().min(200).max(3840), height: z.number().int().min(150).max(2400) })
+    .strict();
+const frameSchema = z
+    .object({
+    background: color.optional(),
+    /** Second colour: a top-to-bottom gradient from `background`. */
+    backgroundTo: color.optional(),
+    margin: z.number().int().min(0).max(400).optional(),
+    shadow: z.boolean().optional(),
+    radius: z.number().int().min(0).max(64).optional(),
+})
+    .strict();
+export const OPEN_PATTERN = /^(popup|options|page:.+|fixture:.+|url:https:\/\/.+)$/;
+const sceneSchema = z
+    .object({
+    name: z.string().regex(/^[a-z0-9][a-z0-9-]{0,40}$/, 'scene names are lowercase letters, digits and "-"'),
+    open: z
+        .string()
+        .max(1000)
+        .regex(OPEN_PATTERN, 'open must be popup | options | page:<path> | fixture:<file> | url:https://…'),
+    viewport: viewportSchema.optional(),
+    colorScheme: z.enum(['light', 'dark']).optional(),
+    /** JS run before the page's own scripts (Playwright addInitScript). */
+    init: z.string().max(20_000).optional(),
+    steps: z.array(stepSchema).max(60).default([]),
+    crop: z
+        .union([
+        z.enum(['viewport', 'content', 'fullPage']),
+        z.object({ selector, padding: z.number().int().min(0).max(400).default(0) }).strict(),
+    ])
+        .optional(),
+    fit: z.enum(['contain', 'cover']).default('contain'),
+    frame: frameSchema.optional(),
+    stores: z
+        .array(z.enum(['chrome', 'edge', 'firefox']))
+        .min(1)
+        .optional(),
+})
+    .strict();
+export const scenesFileSchema = z
+    .object({
+    $schema: z.string().optional(),
+    version: z.literal(1).default(1),
+    viewport: viewportSchema.default({ width: 1280, height: 800 }),
+    deviceScaleFactor: z.number().min(1).max(3).default(1),
+    colorScheme: z.enum(['light', 'dark']).default('light'),
+    time: z.string().datetime({ offset: true }).optional(),
+    fixtures: z.string().max(500).optional(),
+    animations: z.enum(['disabled', 'allow']).default('disabled'),
+    frame: frameSchema.default({}),
+    setup: z.array(stepSchema).max(60).default([]),
+    scenes: z.array(sceneSchema).min(1).max(12),
+})
+    .strict()
+    .superRefine((file, ctx) => {
+    const seen = new Set();
+    for (const [i, scene] of file.scenes.entries()) {
+        if (seen.has(scene.name))
+            ctx.addIssue({
+                code: 'custom',
+                path: ['scenes', i, 'name'],
+                message: `duplicate scene name "${scene.name}"`,
+            });
+        seen.add(scene.name);
+    }
+});
+export function parseScenes(raw) {
+    let json;
+    try {
+        json = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new InvalidInputError(`Scenes file is not valid JSON: ${error.message}`);
+    }
+    const parsed = scenesFileSchema.safeParse(json);
+    if (!parsed.success) {
+        const issues = parsed.error.issues.map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`).join('; ');
+        throw new InvalidInputError(`Invalid scenes file — ${issues}`);
+    }
+    return parsed.data;
+}
+// ── Locales ─────────────────────────────────────────────────────────────────
+const LOCALE_CODE = /^[a-z]{2,3}(_[A-Za-z0-9]{2,4})?$/;
+/** `_locales` code → the BCP 47 tag Chromium's --lang expects (pt_BR → pt-BR, es_419 → es-419). */
+export function chromeLang(locale) {
+    return locale.replace('_', '-');
+}
+/**
+ * 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 function resolveCatalogLocale(uiLocale, available, defaultLocale) {
+    const exact = uiLocale.replace('-', '_');
+    const lower = available.map((l) => l.toLowerCase());
+    const hit = lower.indexOf(exact.toLowerCase());
+    if (hit >= 0)
+        return available[hit];
+    const language = exact.split('_')[0].toLowerCase();
+    const base = lower.indexOf(language);
+    if (base >= 0)
+        return available[base];
+    return defaultLocale ?? null;
+}
+export function parseLocales(value, available, defaultLocale) {
+    if (!value) {
+        if (available.length)
+            return [...available].sort((a, b) => a === defaultLocale ? -1 : b === defaultLocale ? 1 : a.localeCompare(b));
+        return [defaultLocale ?? 'en'];
+    }
+    const out = [
+        ...new Set(value
+            .split(',')
+            .map((l) => l.trim())
+            .filter(Boolean)),
+    ];
+    for (const locale of out) {
+        if (!LOCALE_CODE.test(locale))
+            throw new InvalidInputError(`"${locale}" is not a locale code (use en, de, pt_BR…)`);
+        if (available.length && !available.includes(locale))
+            throw new InvalidInputError(`The extension has no _locales/${locale} (it has ${available.join(', ')}). Chrome would fall back to ` +
+                `${defaultLocale ?? 'the default locale'}, so a "${locale}" screenshot would be in the wrong language.`);
+    }
+    return out;
+}
+/**
+ * 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 function pickSampleMessage(messages, defaults) {
+    if (!messages)
+        return null;
+    for (const [key, value] of Object.entries(messages)) {
+        const message = value?.message;
+        if (typeof message !== 'string' || !message.trim() || message.includes('$') || key.startsWith('@@'))
+            continue;
+        if (defaults && defaults[key]?.message === message)
+            continue;
+        return { key, message };
+    }
+    return null;
+}
+// ── Extension identity ──────────────────────────────────────────────────────
+function idFromHash(hex) {
+    return [...hex.slice(0, 32)].map((c) => String.fromCharCode(97 + Number.parseInt(c, 16))).join('');
+}
+/** Chrome's id for an unpacked extension: sha256 of its absolute (real) path, a–p encoded. */
+export function extensionIdForPath(realPath) {
+    return idFromHash(createHash('sha256').update(realPath).digest('hex'));
+}
+/** Chrome's id when the manifest carries a `key` (base64 DER public key). */
+export function extensionIdForKey(key) {
+    return idFromHash(createHash('sha256')
+        .update(Buffer.from(key.replace(/\s+/g, ''), 'base64'))
+        .digest('hex'));
+}
+/**
+ * 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 function placeCapture(content, canvas, opts) {
+    if (opts.fit === 'cover') {
+        const s = Math.max(canvas.width / content.width, canvas.height / content.height);
+        const width = content.width * s;
+        const height = content.height * s;
+        return { x: (canvas.width - width) / 2, y: (canvas.height - height) / 2, width, height };
+    }
+    const exact = content.width === canvas.width && content.height === canvas.height;
+    const margin = exact ? 0 : opts.margin;
+    const fit = Math.min((canvas.width - 2 * margin) / content.width, (canvas.height - 2 * margin) / content.height);
+    // Pixels available per CSS px on the canvas (1 per canvas px) vs captured.
+    const s = Math.min(fit, opts.scale);
+    const width = content.width * s;
+    const height = content.height * s;
+    return { x: (canvas.width - width) / 2, y: (canvas.height - height) / 2, width, height };
+}
+export function screenshotFileName(index, scene, size) {
+    return `${String(index + 1).padStart(2, '0')}-${scene}-${size.width}x${size.height}.png`;
+}
+/** Width/height from a PNG's IHDR. */
+export function pngDimensions(png) {
+    const b = Buffer.from(png.buffer, png.byteOffset, png.byteLength);
+    if (b.length < 24 || b.readUInt32BE(12) !== 0x49484452)
+        throw new Error('Not a PNG');
+    return { width: b.readUInt32BE(16), height: b.readUInt32BE(20) };
+}
+/**
+ * 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 function macLocaleWrapper(executable, lang) {
+    const quote = (s) => `'${s.replace(/'/g, `'\\''`)}'`;
+    return ('#!/bin/sh\n' +
+        '# Generated by extenshi screenshots: run Chromium with a macOS UI language.\n' +
+        'for a; do shift; [ "$a" = about:blank ] || set -- "$@" "$a"; done\n' +
+        `exec ${quote(executable)} "$@" -AppleLanguages ${quote(`(${lang})`)}\n`);
+}
+//# sourceMappingURL=screenshots-scenes.js.map

package/dist/screenshots-scenes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots-scenes.js","sourceRoot":"","sources":["../src/screenshots-scenes.ts"],"names":[],"mappings":"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"}

package/dist/screenshots.d.ts

@@ -0,0 +1,145 @@
+/**
+ * `extenshi screenshots <unpacked-dir|zip> --scenes scenes.json` — store
+ * screenshots per locale, without a human.
+ *
+ * Loads the build into Chromium (Playwright, resolved lazily from the project or
+ * the CLI's own install — never bundled), runs the declarative scenes from
+ * screenshots-scenes.ts once per locale, and writes each store's screenshot size
+ * (store-assets.ts STORE_SCREENSHOT_SPECS) with stable names:
+ *
+ *   <out>/<store>/<locale>/01-popup-1280x800.png
+ *   <out>/screenshots.json            (index: files, sha256, verified locales)
+ *
+ * Locale switching is the part that silently goes wrong elsewhere, so it is
+ * verified, not assumed: each locale gets a fresh Chromium whose UI language is
+ * set per platform (--lang; LANGUAGE on Linux; -AppleLanguages on macOS, where
+ * --lang is ignored), then `chrome.i18n` inside the extension must report that
+ * locale AND render a message from `_locales/<locale>`. A mismatch fails the run
+ * instead of producing English screenshots labelled German.
+ *
+ * Determinism: fixed viewport and device scale factor, `reducedMotion`,
+ * animations/transitions/caret disabled, UTC timezone, optional fixed clock,
+ * fonts + images awaited before every capture, and the store canvas composed
+ * with resvg (no browser scaling). The source directory is never modified — the
+ * build is staged into a temporary copy (a zip is extracted there).
+ *
+ * TODO(evidence): `--evidence` (record `screenshots` evidence per locale) is
+ * deliberately not implemented here — it belongs to the shared `--evidence`
+ * mechanism being added for `package` / `test smoke`. screenshots.json already
+ * carries per-locale file lists and hashes for it to consume.
+ */
+import { type Size, type StoreId } from './store-assets.js';
+type Json = Record<string, any>;
+interface PwPage {
+    goto(url: string, opts?: Json): Promise<unknown>;
+    url(): string;
+    close(): Promise<void>;
+    evaluate<T>(fn: string | ((arg: any) => T | Promise<T>), arg?: unknown): Promise<T>;
+    screenshot(opts?: Json): Promise<Buffer>;
+    setViewportSize(size: Size): Promise<void>;
+    emulateMedia(opts: Json): Promise<void>;
+    addInitScript(script: Json): Promise<void>;
+    waitForTimeout(ms: number): Promise<void>;
+    locator(selector: string): any;
+    keyboard: {
+        press(key: string): Promise<void>;
+    };
+    mouse: {
+        move(x: number, y: number): Promise<void>;
+        wheel(dx: number, dy: number): Promise<void>;
+    };
+    clock?: {
+        setFixedTime(time: Date): Promise<void>;
+    };
+}
+interface PwContext {
+    pages(): PwPage[];
+    newPage(): Promise<PwPage>;
+    serviceWorkers(): {
+        url(): string;
+    }[];
+    waitForEvent(event: string, opts?: Json): Promise<unknown>;
+    close(): Promise<void>;
+    browser(): {
+        version(): string;
+    } | null;
+}
+interface Playwright {
+    chromium: {
+        executablePath(): string;
+        launchPersistentContext(dir: string, opts: Json): Promise<PwContext>;
+    };
+}
+export declare const PROBE_PAGE = "__extenshi_screenshots__.html";
+/** Resolve Playwright from the project first, then from the CLI's own install. */
+export declare function loadPlaywright(cwd?: string, bases?: string[]): Playwright;
+export interface StagedExtension {
+    dir: string;
+    id: string;
+    manifest: Json;
+    locales: string[];
+    defaultLocale?: string;
+    messages: Record<string, Record<string, {
+        message?: unknown;
+    }> | null>;
+    warnings: string[];
+}
+/**
+ * Copy (or unzip) the build into `work/extension`, never touching the source.
+ * The copy gets one extra, empty page — the probe the runner uses to reach
+ * chrome.i18n / chrome.storage in the extension's own context.
+ */
+export declare function stageExtension(input: string, work: string): Promise<StagedExtension>;
+/** Static server for fixture pages on 127.0.0.1 — content scripts do not run on file://. */
+export declare function startFixtureServer(root: string): Promise<{
+    origin: string;
+    close(): Promise<void>;
+}>;
+interface Capture {
+    png: Buffer;
+    css: Size;
+}
+/** Compose a capture onto a store-size canvas with resvg (exact pixels, no browser scaling). */
+export declare function composeOnCanvas(capture: Capture, canvas: Size, opts: {
+    fit: 'contain' | 'cover';
+    dsf: number;
+    background: string;
+    backgroundTo?: string;
+    margin: number;
+    shadow: boolean;
+    radius: number;
+}): Promise<Buffer>;
+export interface ScreenshotsOptions {
+    scenes: string;
+    locales?: string;
+    store?: string;
+    out?: string;
+    /** Use each store's smaller accepted size (Chrome 640×400, Edge 640×480, AMO 640×400). */
+    small?: boolean;
+    headed?: boolean;
+    json?: boolean;
+}
+export interface ScreenshotFile {
+    store: StoreId;
+    locale: string;
+    scene: string;
+    path: string;
+    width: number;
+    height: number;
+    sha256: string;
+}
+export interface ScreenshotsResult {
+    outDir: string;
+    files: ScreenshotFile[];
+    locales: {
+        locale: string;
+        uiLocale: string;
+        catalog: string | null;
+        sample: string | null;
+    }[];
+    warnings: string[];
+}
+export declare function runScreenshots(input: string, opts: ScreenshotsOptions): Promise<ScreenshotsResult>;
+export declare function runScreenshotsCommand(input: string, opts: ScreenshotsOptions): Promise<void>;
+export {};
+//# sourceMappingURL=screenshots.d.ts.map

package/dist/screenshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots.d.ts","sourceRoot":"","sources":["../src/screenshots.ts"],"names":[],"mappings":"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"}