@walkrstudio/cli 0.2.0

package/README.md

@@ -0,0 +1,108 @@
+# @walkr/cli
+
+CLI for running Walkr demos in Studio and exporting media.
+
+## Install
+
+```bash
+npm install -g @walkr/cli
+```
+
+Or run without global install:
+
+```bash
+npx walkr
+```
+
+## Commands
+
+### `walkr dev <script>`
+
+Opens Walkr Studio with live reload.
+
+```bash
+walkr dev demo.ts
+```
+
+### `walkr export <script> [options]`
+
+Exports a walkthrough to `mp4`, `gif`, `webm`, or `embed`.
+
+```bash
+walkr export demo.ts --format mp4 --output demo.mp4
+```
+
+### `walkr --help`
+
+Shows command help and examples.
+
+## `walkr export` options
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `--format` | `mp4 \| gif \| webm \| embed` | `mp4` | Output format. |
+| `--output` | `string` | `output.<ext>` | Output path. For `embed`, extension is `.html`. |
+| `--width` | `number` | `1920` | Render width in px. |
+| `--height` | `number` | `1080` | Render height in px. |
+
+## Example `demo.ts`
+
+```ts
+import {
+  walkr,
+  moveTo,
+  click,
+  type,
+  highlight,
+  scroll,
+  wait,
+  sequence,
+  parallel,
+  zoom,
+  pan,
+} from "@walkr/core";
+
+export default walkr({
+  url: "https://example.com",
+  title: "Walkr CLI demo",
+  description: "A complete scripted walkthrough for local preview/export",
+  cursor: {
+    shape: "circle",
+    color: "#22d3ee",
+    size: 18,
+    shadow: true,
+    clickColor: "#0ea5e9",
+  },
+  steps: [
+    moveTo(620, 380, { duration: 700 }),
+    click(620, 380),
+    type("hello@example.com", { selector: "input[name=email]", delay: 35 }),
+    parallel(
+      highlight(".submit-btn", {
+        spotlight: true,
+        color: "#22d3ee",
+        duration: 1200,
+        backdropOpacity: 0.35,
+      }),
+      sequence(
+        wait(200),
+        moveTo(810, 505, { duration: 500 }),
+      ),
+    ),
+    click(810, 505),
+    sequence(
+      wait(300),
+      scroll(0, 700, { smooth: true }),
+      wait(200),
+      zoom(1.2, { x: 960, y: 500 }),
+      pan(960, 460, { duration: 500 }),
+    ),
+  ],
+});
+```
+
+## Requirements
+
+- Node.js `>=18`
+- `pnpm`
+- `@walkr/playwright` installed in your project for `walkr export`

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAIA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/cli.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+import { devCommand } from "./dev.js";
+import { exportCommand } from "./export.js";
+export const VERSION = "0.1.0";
+const USAGE = `\
+Usage: walkr <command> [options]
+
+Commands:
+  walkr dev <script>                  Start Walkr Studio with live script reload
+  walkr export <script> [options]     Export walkthrough as video or embed
+
+Export options:
+  --format  mp4|gif|webm|embed        Output format (default: mp4)
+  --output  <path>                    Output file path (default: output.<ext>)
+  --width   <n>                       Video width in px (default: 1920)
+  --height  <n>                       Video height in px (default: 1080)
+
+Examples:
+  walkr dev demo.ts
+  walkr export demo.ts --format gif --output demo.gif
+  walkr export demo.ts --format embed --output demo.html
+`;
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    const result = {
+        command: null,
+        scriptPath: null,
+        exportOptions: {},
+        help: false,
+        version: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--help" || arg === "-h") {
+            result.help = true;
+            continue;
+        }
+        if (arg === "--version" || arg === "-v") {
+            result.version = true;
+            continue;
+        }
+        if (arg === "--format") {
+            result.exportOptions.format = args[++i];
+            continue;
+        }
+        if (arg === "--output") {
+            result.exportOptions.output = args[++i];
+            continue;
+        }
+        if (arg === "--width") {
+            result.exportOptions.width = parseInt(args[++i], 10);
+            continue;
+        }
+        if (arg === "--height") {
+            result.exportOptions.height = parseInt(args[++i], 10);
+            continue;
+        }
+        if (!result.command) {
+            result.command = arg;
+        }
+        else if (!result.scriptPath) {
+            result.scriptPath = arg;
+        }
+    }
+    return result;
+}
+async function main() {
+    const parsed = parseArgs(process.argv);
+    if (parsed.version) {
+        console.log(`walkr v${VERSION}`);
+        return;
+    }
+    if (parsed.help || !parsed.command) {
+        console.log(USAGE);
+        return;
+    }
+    if (parsed.command === "dev") {
+        if (!parsed.scriptPath) {
+            console.error("Error: walkr dev requires a script path.\n");
+            console.error("  Example: walkr dev demo.ts");
+            process.exit(1);
+        }
+        await devCommand(parsed.scriptPath);
+        return;
+    }
+    if (parsed.command === "export") {
+        if (!parsed.scriptPath) {
+            console.error("Error: walkr export requires a script path.\n");
+            console.error("  Example: walkr export demo.ts --format mp4");
+            process.exit(1);
+        }
+        await exportCommand(parsed.scriptPath, parsed.exportOptions);
+        return;
+    }
+    console.error(`Error: unknown command "${parsed.command}"\n`);
+    console.error(USAGE);
+    process.exit(1);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/dev.d.ts

@@ -0,0 +1,2 @@
+export declare function devCommand(scriptPath: string): Promise<void>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAgCA,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuFlE"}

package/dist/dev.js

@@ -0,0 +1,98 @@
+import { spawn } from "node:child_process";
+import { mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { loadScriptWalkthrough, watchScript } from "./watch.js";
+const STUDIO_PORT = 5174;
+const PROXY_PREFIX = "/__target__";
+function openBrowser(url) {
+    const start = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+    spawn(start, [url], { detached: true, stdio: "ignore" }).unref();
+}
+function rewriteWalkthroughUrl(walkthrough, targetOrigin) {
+    return {
+        ...walkthrough,
+        originalUrl: walkthrough.url,
+        url: walkthrough.url.replace(targetOrigin, PROXY_PREFIX),
+    };
+}
+function writeWalkthroughJson(path, walkthrough, targetOrigin) {
+    const proxied = targetOrigin ? rewriteWalkthroughUrl(walkthrough, targetOrigin) : walkthrough;
+    writeFileSync(path, JSON.stringify(proxied, null, 2));
+}
+export async function devCommand(scriptPath) {
+    const resolvedScript = resolve(process.cwd(), scriptPath);
+    // Resolve the studio package path (sibling in monorepo)
+    const studioRoot = new URL("../../studio", import.meta.url).pathname;
+    // Write loaded walkthrough JSON to Studio's public dir so it can fetch on startup
+    const walkthroughJsonPath = resolve(studioRoot, "public", "walkthrough.json");
+    mkdirSync(dirname(walkthroughJsonPath), { recursive: true });
+    console.log(`\nWalkr Studio starting…`);
+    console.log(`Script: ${scriptPath}\n`);
+    // Load the script first (awaited) to extract the target origin before Vite starts
+    const initialWalkthrough = await loadScriptWalkthrough(resolvedScript);
+    let targetOrigin = "";
+    try {
+        targetOrigin = new URL(initialWalkthrough.url).origin;
+    }
+    catch {
+        console.error(`[walkr] Invalid walkthrough URL: ${initialWalkthrough.url}`);
+    }
+    console.log(`Target origin: ${targetOrigin}`);
+    writeWalkthroughJson(walkthroughJsonPath, initialWalkthrough, targetOrigin);
+    // Write proxy target file so the Vite config can read it (survives Vite restarts)
+    const proxyTargetPath = resolve(studioRoot, ".walkr-proxy-target");
+    writeFileSync(proxyTargetPath, targetOrigin);
+    // Watch for subsequent script changes
+    const stopWatcher = watchScript(resolvedScript, () => {
+        void (async () => {
+            try {
+                const walkthrough = await loadScriptWalkthrough(resolvedScript);
+                console.log("Script reloaded, writing walkthrough.json…");
+                writeWalkthroughJson(walkthroughJsonPath, walkthrough, targetOrigin);
+            }
+            catch (error) {
+                console.error(`[walkr] Failed to reload script`, error);
+            }
+        })();
+    });
+    const vite = spawn("npx", ["vite", "--port", String(STUDIO_PORT)], {
+        cwd: studioRoot,
+        stdio: ["ignore", "pipe", "pipe"],
+        shell: false,
+        env: {
+            ...process.env,
+            WALKR_PROXY_TARGET: targetOrigin,
+        },
+    });
+    let ready = false;
+    const onData = (data) => {
+        const text = data.toString();
+        process.stdout.write(text);
+        if (!ready && (text.includes("Local:") || text.includes("localhost"))) {
+            ready = true;
+            const url = `http://localhost:${STUDIO_PORT}`;
+            console.log(`\nWalkr Studio running at ${url}\n`);
+            openBrowser(url);
+        }
+    };
+    vite.stdout.on("data", onData);
+    vite.stderr.on("data", onData);
+    const cleanup = () => {
+        console.log("\nShutting down…");
+        stopWatcher();
+        try {
+            rmSync(proxyTargetPath, { force: true });
+        }
+        catch { }
+        vite.kill("SIGTERM");
+        process.exit(0);
+    };
+    process.on("SIGINT", cleanup);
+    process.on("SIGTERM", cleanup);
+    await new Promise((resolve) => {
+        vite.on("close", () => {
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

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

package/dist/export.d.ts

@@ -0,0 +1,8 @@
+export interface ExportOptions {
+    format?: "mp4" | "gif" | "webm" | "embed";
+    output?: string;
+    width?: number;
+    height?: number;
+}
+export declare function exportCommand(scriptPath: string, options: ExportOptions): Promise<void>;
+//# sourceMappingURL=export.d.ts.map

package/dist/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAwBD,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD7F"}

package/dist/export.js

@@ -0,0 +1,63 @@
+import { pathToFileURL } from "node:url";
+function isWalkthrough(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const v = value;
+    return typeof v.url === "string" && Array.isArray(v.steps);
+}
+async function loadWalkthrough(scriptPath) {
+    const url = pathToFileURL(scriptPath);
+    url.searchParams.set("t", String(Date.now()));
+    const mod = (await import(url.toString()));
+    const wt = mod.default;
+    if (!isWalkthrough(wt)) {
+        throw new Error(`Script "${scriptPath}" must export a Walkthrough as default. Got: ${typeof wt}`);
+    }
+    return wt;
+}
+export async function exportCommand(scriptPath, options) {
+    const format = options.format ?? "mp4";
+    const ext = format === "embed" ? "html" : format;
+    const output = options.output ?? `output.${ext}`;
+    console.log(`\nWalkr Export`);
+    console.log(`  Script:  ${scriptPath}`);
+    console.log(`  Format:  ${format}`);
+    console.log(`  Output:  ${output}`);
+    console.log(`  Size:    ${options.width ?? 1920} × ${options.height ?? 1080}`);
+    console.log();
+    console.log("Loading script…");
+    const walkthrough = await loadWalkthrough(scriptPath);
+    console.log(`  Steps: ${walkthrough.steps.length}`);
+    // Dynamic import of @walkrstudio/playwright (peer dep — must be installed)
+    let captureWalkthrough;
+    try {
+        const mod = (await import("@walkrstudio/playwright"));
+        captureWalkthrough = mod.captureWalkthrough;
+    }
+    catch {
+        throw new Error("@walkrstudio/playwright is not installed. Run: pnpm add @walkrstudio/playwright");
+    }
+    console.log("Capturing frames…");
+    let lastPercent = -1;
+    const result = await captureWalkthrough(walkthrough, {
+        format,
+        output,
+        width: options.width ?? 1920,
+        height: options.height ?? 1080,
+        fps: 30,
+        onProgress: (percent) => {
+            const rounded = Math.round(percent);
+            if (rounded !== lastPercent && rounded % 5 === 0) {
+                lastPercent = rounded;
+                process.stdout.write(`\r  Capturing frames… ${rounded}%`);
+            }
+        },
+    });
+    process.stdout.write("\n");
+    console.log("Encoding…");
+    console.log();
+    console.log(`Done: ${result.outputPath}`);
+    console.log(`  Frames:   ${result.frameCount}`);
+    console.log(`  Duration: ${(result.duration / 1000).toFixed(2)}s`);
+}
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export declare const VERSION = "0.1.0";
+export { devCommand } from "./dev.js";
+export type { ExportOptions } from "./export.js";
+export { exportCommand } from "./export.js";
+export { watch, watchScript } from "./watch.js";
+//# 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":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export const VERSION = "0.1.0";
+export { devCommand } from "./dev.js";
+export { exportCommand } from "./export.js";
+export { watch, watchScript } from "./watch.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/watch.d.ts

@@ -0,0 +1,5 @@
+import type { Walkthrough } from "@walkrstudio/core";
+export declare const loadScriptWalkthrough: (scriptPath: string) => Promise<Walkthrough>;
+export declare const watchScript: (scriptPath: string, callback: () => void) => (() => void);
+export declare const watch: (scriptPath: string, onChange: (walkthrough: Walkthrough) => void) => (() => void);
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAarD,eAAO,MAAM,qBAAqB,GAAU,YAAY,MAAM,KAAG,OAAO,CAAC,WAAW,CAUnF,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,YAAY,MAAM,EAAE,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAuBjF,CAAC;AAEF,eAAO,MAAM,KAAK,GAChB,YAAY,MAAM,EAClB,UAAU,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,KAC3C,CAAC,MAAM,IAAI,CAqBb,CAAC"}

package/dist/watch.js

@@ -0,0 +1,60 @@
+import { watch as fsWatch } from "node:fs";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+const WATCH_DEBOUNCE_MS = 200;
+const isWalkthrough = (value) => {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const maybeWalkthrough = value;
+    return typeof maybeWalkthrough.url === "string" && Array.isArray(maybeWalkthrough.steps);
+};
+export const loadScriptWalkthrough = async (scriptPath) => {
+    const scriptUrl = pathToFileURL(scriptPath);
+    scriptUrl.searchParams.set("t", String(Date.now()));
+    const importedModule = (await import(scriptUrl.href));
+    if (!isWalkthrough(importedModule.default)) {
+        throw new Error("Script default export must be a Walkthrough");
+    }
+    return importedModule.default;
+};
+export const watchScript = (scriptPath, callback) => {
+    const absolutePath = resolve(scriptPath);
+    let debounceTimer = null;
+    const watcher = fsWatch(absolutePath, () => {
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+        }
+        debounceTimer = setTimeout(() => {
+            console.log(`[walkr] File change detected: ${absolutePath}`);
+            callback();
+        }, WATCH_DEBOUNCE_MS);
+    });
+    return () => {
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+            debounceTimer = null;
+        }
+        watcher.close();
+    };
+};
+export const watch = (scriptPath, onChange) => {
+    const absolutePath = resolve(scriptPath);
+    const reload = async () => {
+        try {
+            const walkthrough = await loadScriptWalkthrough(absolutePath);
+            onChange(walkthrough);
+        }
+        catch (error) {
+            console.error(`[walkr] Failed to load script ${absolutePath}`, error);
+        }
+    };
+    void reload();
+    const stopWatching = watchScript(absolutePath, () => {
+        void reload();
+    });
+    return () => {
+        stopWatching();
+    };
+};
+//# sourceMappingURL=watch.js.map

package/dist/watch.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@walkrstudio/cli",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "walkr": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@walkrstudio/core": "0.2.0"
+  },
+  "peerDependencies": {
+    "@walkrstudio/playwright": "0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@walkrstudio/playwright": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "@walkrstudio/playwright": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "biome check src",
+    "type-check": "tsc -p tsconfig.json --noEmit",
+    "dev": "tsc -p tsconfig.json --watch"
+  }
+}