@wasao/kagemusha 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import chalk from "chalk";
+import { Command } from "commander";
+import { captureCommand } from "./commands/capture.js";
+import { initCommand } from "./commands/init.js";
+import { previewCommand } from "./commands/preview.js";
+import { runCommand } from "./commands/run.js";
+import { validateCommand } from "./commands/validate.js";
+const BANNER = `
+  ${chalk.bold("kagemusha")} ${chalk.gray("v0.1.0")}
+  ${chalk.dim("The shadow warrior for your documentation.")}
+
+  ${chalk.white("Auto-update help center screenshots")}
+  ${chalk.white("when your code changes.")}
+`;
+const program = new Command();
+program
+    .name("kagemusha")
+    .version("0.1.0")
+    .addHelpText("beforeAll", BANNER)
+    .configureHelp({
+    sortSubcommands: false,
+});
+program
+    .command("init")
+    .description("Set up config, screenshot definitions, and GitHub Actions workflow")
+    .action(initCommand);
+program
+    .command("run")
+    .description("Run full pipeline: capture → upload to S3")
+    .option("--ids <ids>", "Comma-separated screenshot definition IDs")
+    .action(runCommand);
+program
+    .command("capture")
+    .description("Capture screenshots only")
+    .option("--ids <ids>", "Comma-separated screenshot definition IDs")
+    .option("--all", "Capture all definitions")
+    .action(captureCommand);
+program
+    .command("preview")
+    .description("Preview screenshots locally (opens browser)")
+    .option("--id <id>", "Preview a specific definition")
+    .action(previewCommand);
+program
+    .command("validate")
+    .description("Validate config and definition files")
+    .action(validateCommand);
+// Phase 2 commands
+program
+    .command("compare")
+    .description(`Compare screenshots with baselines (VRT) ${chalk.yellow("[coming soon]")}`)
+    .action(() => {
+    console.log(chalk.yellow("\n🚧 compare is coming in Phase 2.\n"));
+});
+program
+    .command("publish")
+    .description("Publish screenshots to Intercom / external services " +
+    chalk.yellow("[coming soon]"))
+    .action(() => {
+    console.log(chalk.yellow("\n🚧 publish is coming in Phase 2.\n"));
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,MAAM,GAAG;IACX,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC/C,KAAK,CAAC,GAAG,CAAC,4CAA4C,CAAC;;IAEvD,KAAK,CAAC,KAAK,CAAC,qCAAqC,CAAC;IAClD,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAAC;CACzC,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACL,IAAI,CAAC,WAAW,CAAC;KACjB,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC;KAChC,aAAa,CAAC;IACd,eAAe,EAAE,KAAK;CACtB,CAAC,CAAC;AAEJ,OAAO;KACL,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CACX,oEAAoE,CACpE;KACA,MAAM,CAAC,WAAW,CAAC,CAAC;AAEtB,OAAO;KACL,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,aAAa,EAAE,2CAA2C,CAAC;KAClE,MAAM,CAAC,UAAU,CAAC,CAAC;AAErB,OAAO;KACL,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,aAAa,EAAE,2CAA2C,CAAC;KAClE,MAAM,CAAC,OAAO,EAAE,yBAAyB,CAAC;KAC1C,MAAM,CAAC,cAAc,CAAC,CAAC;AAEzB,OAAO;KACL,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,6CAA6C,CAAC;KAC1D,MAAM,CAAC,WAAW,EAAE,+BAA+B,CAAC;KACpD,MAAM,CAAC,cAAc,CAAC,CAAC;AAEzB,OAAO;KACL,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,sCAAsC,CAAC;KACnD,MAAM,CAAC,eAAe,CAAC,CAAC;AAE1B,mBAAmB;AACnB,OAAO;KACL,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CACX,4CAA4C,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAC3E;KACA,MAAM,CAAC,GAAG,EAAE;IACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sCAAsC,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC,CAAC;AAEJ,OAAO;KACL,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CACX,sDAAsD;IACrD,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,CAC9B;KACA,MAAM,CAAC,GAAG,EAAE;IACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sCAAsC,CAAC,CAAC,CAAC;AACnE,CAAC,CAAC,CAAC;AAEJ,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/annotate.d.ts

@@ -0,0 +1,3 @@
+import type { CaptureResult, ScreenshotDefinition } from "../types.js";
+export declare function annotateScreenshots(definitions: ScreenshotDefinition[], results: CaptureResult[], _projectRoot: string): Promise<CaptureResult[]>;
+//# sourceMappingURL=annotate.d.ts.map

package/dist/lib/annotate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotate.d.ts","sourceRoot":"","sources":["../../src/lib/annotate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,aAAa,EAEb,oBAAoB,EACpB,MAAM,aAAa,CAAC;AAErB,wBAAsB,mBAAmB,CACxC,WAAW,EAAE,oBAAoB,EAAE,EACnC,OAAO,EAAE,aAAa,EAAE,EACxB,YAAY,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,EAAE,CAAC,CAoB1B"}

package/dist/lib/annotate.js

@@ -0,0 +1,102 @@
+import fs from "node:fs";
+import sharp from "sharp";
+export async function annotateScreenshots(definitions, results, _projectRoot) {
+    const annotatedResults = [];
+    for (const result of results) {
+        const def = definitions.find((d) => d.id === result.id);
+        if (!def?.decorations?.length) {
+            // No decorations — copy raw as annotated
+            const annotatedPath = result.rawPath.replace(".raw.png", ".png");
+            fs.copyFileSync(result.rawPath, annotatedPath);
+            annotatedResults.push({ ...result, annotatedPath });
+            continue;
+        }
+        const annotatedPath = result.rawPath.replace(".raw.png", ".png");
+        await drawAnnotations(result.rawPath, annotatedPath, def.decorations);
+        annotatedResults.push({ ...result, annotatedPath });
+    }
+    return annotatedResults;
+}
+async function drawAnnotations(inputPath, outputPath, decorations) {
+    const image = sharp(inputPath);
+    const metadata = await image.metadata();
+    const width = metadata.width ?? 1280;
+    const height = metadata.height ?? 720;
+    const svgParts = [];
+    for (const dec of decorations) {
+        switch (dec.type) {
+            case "rect":
+                svgParts.push(renderRect(dec));
+                break;
+            case "arrow":
+                svgParts.push(renderArrow(dec));
+                break;
+            case "label":
+                svgParts.push(renderLabel(dec));
+                break;
+        }
+    }
+    const svgOverlay = `
+    <svg width="${width}" height="${height}" xmlns="http://www.w3.org/2000/svg">
+      <defs>
+        <marker id="arrowhead" markerWidth="10" markerHeight="7"
+                refX="10" refY="3.5" orient="auto" fill="red">
+          <polygon points="0 0, 10 3.5, 0 7" />
+        </marker>
+      </defs>
+      ${svgParts.join("\n")}
+    </svg>
+  `;
+    await image
+        .composite([{ input: Buffer.from(svgOverlay), top: 0, left: 0 }])
+        .toFile(outputPath);
+}
+function renderRect(dec) {
+    const color = dec.style?.color ?? "#FF0000";
+    const strokeWidth = dec.style?.strokeWidth ?? 2;
+    const borderRadius = dec.style?.borderRadius ?? 0;
+    if ("selector" in dec.target) {
+        // Selector-based rects need runtime resolution — use placeholder
+        // In real usage, the bounding box is resolved during capture
+        return `<!-- rect: selector "${dec.target.selector}" needs runtime resolution -->`;
+    }
+    const { x, y, width, height } = dec.target;
+    return `<rect x="${x}" y="${y}" width="${width}" height="${height}"
+    rx="${borderRadius}" ry="${borderRadius}"
+    fill="none" stroke="${color}" stroke-width="${strokeWidth}" />`;
+}
+function renderArrow(dec) {
+    const color = dec.style?.color ?? "#FF0000";
+    const strokeWidth = dec.style?.strokeWidth ?? 2;
+    const from = "x" in dec.from ? dec.from : { x: 0, y: 0 };
+    const to = "x" in dec.to ? dec.to : { x: 100, y: 100 };
+    return `<line x1="${from.x}" y1="${from.y}" x2="${to.x}" y2="${to.y}"
+    stroke="${color}" stroke-width="${strokeWidth}"
+    marker-end="url(#arrowhead)" />`;
+}
+function renderLabel(dec) {
+    const fontSize = dec.style?.fontSize ?? 14;
+    const color = dec.style?.color ?? "#FF0000";
+    const bg = dec.style?.background ?? "#FFFFFF";
+    const pos = "x" in dec.position ? dec.position : { x: 0, y: 0 };
+    const paddingX = 6;
+    const paddingY = 4;
+    const textWidth = dec.text.length * fontSize * 0.6;
+    const textHeight = fontSize;
+    return `
+    <rect x="${pos.x - paddingX}" y="${pos.y - textHeight - paddingY}"
+      width="${textWidth + paddingX * 2}" height="${textHeight + paddingY * 2}"
+      rx="4" ry="4" fill="${bg}" stroke="${color}" stroke-width="1" />
+    <text x="${pos.x}" y="${pos.y}" font-size="${fontSize}"
+      fill="${color}" font-family="sans-serif">${escapeXml(dec.text)}</text>
+  `;
+}
+function escapeXml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+//# sourceMappingURL=annotate.js.map

package/dist/lib/annotate.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,9 @@
+import type { KagemushaConfig, Route, ScreenshotDefinition } from "../types.js";
+export declare function findProjectRoot(startDir?: string): string;
+export declare function loadConfig(projectRoot?: string): KagemushaConfig;
+export declare function loadDefinitions(projectRoot?: string): ScreenshotDefinition[];
+export declare function loadRouting(projectRoot?: string): Route[];
+export declare function loadDefinitionById(id: string, projectRoot?: string): ScreenshotDefinition | undefined;
+export declare function validateConfig(config: KagemushaConfig): string[];
+export declare function validateDefinition(def: ScreenshotDefinition): string[];
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAMhF,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAWxE;AAED,wBAAgB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAYhE;AAED,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAa5E;AAED,wBAAgB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAWzD;AAED,wBAAgB,kBAAkB,CACjC,EAAE,EAAE,MAAM,EACV,WAAW,CAAC,EAAE,MAAM,GAClB,oBAAoB,GAAG,SAAS,CAGlC;AAkBD,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAWhE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,EAAE,CActE"}

package/dist/lib/config.js

@@ -0,0 +1,92 @@
+import fs from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+const CONFIG_FILENAME = "kagemusha.config.yaml";
+const DEFINITIONS_DIR = ".kagemusha/definitions";
+const ROUTING_FILENAME = ".kagemusha/routing.yaml";
+export function findProjectRoot(startDir = process.cwd()) {
+    let dir = startDir;
+    while (dir !== path.dirname(dir)) {
+        if (fs.existsSync(path.join(dir, CONFIG_FILENAME))) {
+            return dir;
+        }
+        dir = path.dirname(dir);
+    }
+    throw new Error(`${CONFIG_FILENAME} not found. Run "kagemusha init" to set up your project.`);
+}
+export function loadConfig(projectRoot) {
+    const root = projectRoot ?? findProjectRoot();
+    const configPath = path.join(root, CONFIG_FILENAME);
+    if (!fs.existsSync(configPath)) {
+        throw new Error(`Config file not found: ${configPath}`);
+    }
+    const raw = fs.readFileSync(configPath, "utf-8");
+    const config = parseYaml(raw);
+    resolveEnvVars(config);
+    return config;
+}
+export function loadDefinitions(projectRoot) {
+    const root = projectRoot ?? findProjectRoot();
+    const defsDir = path.join(root, DEFINITIONS_DIR);
+    if (!fs.existsSync(defsDir)) {
+        return [];
+    }
+    const files = fs.readdirSync(defsDir).filter((f) => f.endsWith(".json"));
+    return files.map((file) => {
+        const content = fs.readFileSync(path.join(defsDir, file), "utf-8");
+        return JSON.parse(content);
+    });
+}
+export function loadRouting(projectRoot) {
+    const root = projectRoot ?? findProjectRoot();
+    const routingPath = path.join(root, ROUTING_FILENAME);
+    if (!fs.existsSync(routingPath)) {
+        return [];
+    }
+    const raw = fs.readFileSync(routingPath, "utf-8");
+    const parsed = parseYaml(raw);
+    return parsed.routes ?? [];
+}
+export function loadDefinitionById(id, projectRoot) {
+    const defs = loadDefinitions(projectRoot);
+    return defs.find((d) => d.id === id);
+}
+function resolveEnvVars(obj) {
+    if (obj === null || obj === undefined)
+        return;
+    if (typeof obj === "object") {
+        for (const [key, value] of Object.entries(obj)) {
+            if (typeof value === "string") {
+                obj[key] = value.replace(/\$\{(\w+)\}/g, (_, envVar) => process.env[envVar] ?? "");
+            }
+            else if (typeof value === "object") {
+                resolveEnvVars(value);
+            }
+        }
+    }
+}
+export function validateConfig(config) {
+    const errors = [];
+    if (!config.app?.baseUrl) {
+        errors.push("app.baseUrl is required");
+    }
+    if (!config.screenshot?.defaultViewport) {
+        errors.push("screenshot.defaultViewport is required");
+    }
+    return errors;
+}
+export function validateDefinition(def) {
+    const errors = [];
+    if (!def.id)
+        errors.push("id is required");
+    if (!def.url)
+        errors.push("url is required");
+    if (!def.capture)
+        errors.push("capture is required");
+    if (def.capture &&
+        !["fullPage", "selector", "crop"].includes(def.capture.mode)) {
+        errors.push(`capture.mode must be "fullPage", "selector", or "crop"`);
+    }
+    return errors;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/crawl.d.ts

@@ -0,0 +1,6 @@
+export interface DiscoveredPage {
+    path: string;
+    title: string;
+}
+export declare function discoverPages(baseUrl: string, maxDepth?: number, maxPages?: number): Promise<DiscoveredPage[]>;
+//# sourceMappingURL=crawl.d.ts.map

package/dist/lib/crawl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawl.d.ts","sourceRoot":"","sources":["../../src/lib/crawl.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,aAAa,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAU,EACpB,QAAQ,GAAE,MAAW,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC,CAqD3B"}

package/dist/lib/crawl.js

@@ -0,0 +1,95 @@
+export async function discoverPages(baseUrl, maxDepth = 2, maxPages = 50) {
+    const { chromium } = await import("playwright-chromium");
+    const browser = await chromium.launch({ headless: true });
+    const context = await browser.newContext();
+    const origin = new URL(baseUrl).origin;
+    const visited = new Set();
+    const results = [];
+    const queue = [{ url: baseUrl, depth: 0 }];
+    try {
+        while (queue.length > 0 && results.length < maxPages) {
+            const item = queue.shift();
+            if (!item)
+                break;
+            const normalized = normalizeUrl(item.url, origin);
+            if (!normalized || visited.has(normalized))
+                continue;
+            visited.add(normalized);
+            try {
+                const page = await context.newPage();
+                await page.goto(normalized, {
+                    waitUntil: "domcontentloaded",
+                    timeout: 10000,
+                });
+                const title = await page.title();
+                const pagePath = new URL(page.url()).pathname;
+                results.push({
+                    path: pagePath,
+                    title: title || pagePath,
+                });
+                if (item.depth < maxDepth) {
+                    const links = await collectLinks(page, origin);
+                    for (const link of links) {
+                        if (!visited.has(link)) {
+                            queue.push({ url: link, depth: item.depth + 1 });
+                        }
+                    }
+                }
+                await page.close();
+            }
+            catch {
+                // Skip pages that fail to load
+            }
+        }
+    }
+    finally {
+        await browser.close();
+    }
+    return results;
+}
+async function collectLinks(page, origin) {
+    const hrefs = await page.evaluate(() => Array.from(document.querySelectorAll("a[href]")).map((a) => a.href));
+    return hrefs
+        .map((href) => normalizeUrl(href, origin))
+        .filter((url) => url !== null);
+}
+function normalizeUrl(url, origin) {
+    try {
+        const parsed = new URL(url, origin);
+        // Same origin only
+        if (parsed.origin !== origin)
+            return null;
+        // Skip non-page resources
+        const skip = [
+            ".js",
+            ".css",
+            ".png",
+            ".jpg",
+            ".jpeg",
+            ".gif",
+            ".svg",
+            ".ico",
+            ".woff",
+            ".woff2",
+            ".ttf",
+            ".eot",
+            ".pdf",
+            ".zip",
+            ".json",
+            ".xml",
+        ];
+        if (skip.some((ext) => parsed.pathname.endsWith(ext)))
+            return null;
+        // Skip anchors and mailto
+        if (url.startsWith("mailto:") || url.startsWith("tel:"))
+            return null;
+        // Remove hash and search params for deduplication
+        parsed.hash = "";
+        parsed.search = "";
+        return parsed.toString();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=crawl.js.map

package/dist/lib/crawl.js.map

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

package/dist/lib/screenshot.d.ts

@@ -0,0 +1,3 @@
+import type { CaptureResult, KagemushaConfig, ScreenshotDefinition } from "../types.js";
+export declare function captureScreenshots(config: KagemushaConfig, definitions: ScreenshotDefinition[], projectRoot: string): Promise<CaptureResult[]>;
+//# sourceMappingURL=screenshot.d.ts.map

package/dist/lib/screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/lib/screenshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,MAAM,aAAa,CAAC;AAmBrB,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,eAAe,EACvB,WAAW,EAAE,oBAAoB,EAAE,EACnC,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,EAAE,CAAC,CAsB1B"}

package/dist/lib/screenshot.js

@@ -0,0 +1,166 @@
+import fs from "node:fs";
+import path from "node:path";
+async function loadPlaywright() {
+    try {
+        return await import("playwright-chromium");
+    }
+    catch {
+        throw new Error("Playwright is required for screenshot capture.\n" +
+            "Install it with: npm install -D playwright && npx playwright install chromium");
+    }
+}
+const SCREENSHOTS_DIR = "screenshots";
+export async function captureScreenshots(config, definitions, projectRoot) {
+    const outputDir = path.join(projectRoot, SCREENSHOTS_DIR);
+    fs.mkdirSync(outputDir, { recursive: true });
+    const { chromium } = await loadPlaywright();
+    const browser = await chromium.launch({ headless: true });
+    const results = [];
+    try {
+        const context = await createAuthenticatedContext(browser, config);
+        for (const def of definitions) {
+            const result = await captureOne(context, config, def, outputDir);
+            results.push(result);
+        }
+        await context.close();
+    }
+    finally {
+        await browser.close();
+    }
+    return results;
+}
+async function createAuthenticatedContext(browser, config) {
+    const viewport = config.screenshot.defaultViewport;
+    const context = await browser.newContext({
+        viewport: { width: viewport.width, height: viewport.height },
+        deviceScaleFactor: viewport.deviceScaleFactor ?? 2,
+    });
+    if (config.auth) {
+        const page = await context.newPage();
+        const loginUrl = new URL(config.auth.loginUrl, config.app.baseUrl).toString();
+        await page.goto(loginUrl);
+        await executeActions(page, config.auth.steps);
+        await page.close();
+    }
+    return context;
+}
+async function captureOne(context, config, def, outputDir) {
+    const page = await context.newPage();
+    if (def.viewport) {
+        await page.setViewportSize({
+            width: def.viewport.width,
+            height: def.viewport.height,
+        });
+    }
+    const url = resolveUrl(config.app.baseUrl, def.url, def.urlParams);
+    await page.goto(url, { waitUntil: "networkidle" });
+    if (def.hideElements?.length) {
+        await hideElements(page, def.hideElements);
+    }
+    if (def.beforeCapture?.length) {
+        await executeActions(page, def.beforeCapture);
+    }
+    const rawPath = path.join(outputDir, `${def.id}.raw.png`);
+    await takeScreenshot(page, def, rawPath);
+    await page.close();
+    const timestamp = new Date().toISOString();
+    return {
+        id: def.id,
+        rawPath,
+        annotatedPath: rawPath, // annotate step will create the final version
+        timestamp,
+    };
+}
+async function takeScreenshot(page, def, outputPath) {
+    switch (def.capture.mode) {
+        case "fullPage":
+            await page.screenshot({ path: outputPath, fullPage: true });
+            break;
+        case "selector": {
+            const element = await page.waitForSelector(def.capture.selector, {
+                timeout: 10000,
+            });
+            if (!element) {
+                throw new Error(`Element not found: ${def.capture.selector} (definition: ${def.id})`);
+            }
+            await element.screenshot({ path: outputPath });
+            break;
+        }
+        case "crop": {
+            const { start, end } = def.capture.crop;
+            await page.screenshot({
+                path: outputPath,
+                clip: {
+                    x: start.x,
+                    y: start.y,
+                    width: end.x - start.x,
+                    height: end.y - start.y,
+                },
+            });
+            break;
+        }
+    }
+}
+async function executeActions(page, actions) {
+    for (const action of actions) {
+        switch (action.action) {
+            case "click":
+                await page.click(action.selector);
+                break;
+            case "type":
+                await page.fill(action.selector, action.text);
+                break;
+            case "select":
+                await page.selectOption(action.selector, action.value);
+                break;
+            case "hover":
+                await page.hover(action.selector);
+                break;
+            case "scroll":
+                if (action.selector) {
+                    await page
+                        .locator(action.selector)
+                        .evaluate((el, y) => el.scrollTo(0, y), action.y);
+                }
+                else {
+                    await page.evaluate((y) => window.scrollTo(0, y), action.y);
+                }
+                break;
+            case "wait":
+                await page.waitForTimeout(action.ms);
+                break;
+            case "waitForSelector":
+                await page.waitForSelector(action.selector, {
+                    timeout: action.timeout ?? 10000,
+                });
+                break;
+            case "waitForNavigation":
+                await page.waitForLoadState("networkidle", {
+                    timeout: action.timeout ?? 30000,
+                });
+                break;
+            case "evaluate":
+                await page.evaluate(action.script);
+                break;
+        }
+    }
+}
+async function hideElements(page, selectors) {
+    for (const selector of selectors) {
+        await page.evaluate((sel) => {
+            document.querySelectorAll(sel).forEach((el) => {
+                el.style.display = "none";
+            });
+        }, selector);
+    }
+}
+function resolveUrl(baseUrl, urlPath, params) {
+    let resolved = urlPath;
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            resolved = resolved.replace(`{${key}}`, value);
+        }
+    }
+    return new URL(resolved, baseUrl).toString();
+}
+//# sourceMappingURL=screenshot.js.map

package/dist/lib/screenshot.js.map

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

package/dist/lib/upload.d.ts

@@ -0,0 +1,9 @@
+import type { CaptureResult, KagemushaConfig } from "../types.js";
+export interface UploadResult {
+    id: string;
+    url: string;
+    bucket: string;
+    key: string;
+}
+export declare function uploadToS3(config: KagemushaConfig, results: CaptureResult[], _projectRoot: string): Promise<UploadResult[]>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/lib/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/lib/upload.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,wBAAsB,UAAU,CAC/B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,aAAa,EAAE,EACxB,YAAY,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CAmDzB"}