browse 0.9.2 → 0.9.3-alpha-2f5e085

package/README.md

@@ -33,7 +33,7 @@ npm install -g browse
 npm install -g browse
 
 browse open https://example.com
-browse snapshot --compact
+browse snapshot
 browse click @0-12
 browse fill @0-8 "hello"
 browse get title
@@ -89,8 +89,8 @@ browse forward        # Navigate forward
 The accessibility snapshot is the recommended way for agents to discover elements. It prints a tree of refs like `@0-12` that the element commands accept directly.
 
 ```bash
-browse snapshot                 # Accessibility snapshot + cached refs
-browse snapshot --compact       # Tree only, no ref maps
+browse snapshot                 # Accessibility tree + cached refs (lean by default)
+browse snapshot --full          # Also include the ref maps (xpathMap, urlMap)
 browse snapshot --filter submit # Filter lines by text or /regex/, keeping ancestors
 browse snapshot --max-depth 4   # Trim output deeper than this depth
 ```

package/dist/commands/snapshot.js

@@ -2,17 +2,20 @@ import { Flags } from "@oclif/core";
 import { BrowseCommand } from "../base.js";
 import { driverCommandFlags, runDriverCommandFromFlags, } from "../lib/driver/command-cli.js";
 export default class Snapshot extends BrowseCommand {
-    static description = "Print the active page accessibility snapshot and cache refs for element commands.";
+    static description = "Print the active page accessibility snapshot and cache refs for element commands. Pass --full to also include the ref maps (xpathMap, urlMap).";
     static examples = [
         "browse snapshot",
-        "browse snapshot --compact",
+        "browse snapshot --full",
         "browse snapshot --filter submit",
         "browse snapshot --max-depth 4",
     ];
     static flags = {
         ...driverCommandFlags,
+        full: Flags.boolean({
+            description: "Also include the ref maps (xpathMap, urlMap).",
+        }),
         compact: Flags.boolean({
-            description: "Print only the formatted tree, without ref maps.",
+            description: "Deprecated and has no effect; use --full to include the ref maps.",
         }),
         filter: Flags.string({
             description: "Filter output lines by text or /regex/ while preserving matching ancestors.",
@@ -25,8 +28,11 @@ export default class Snapshot extends BrowseCommand {
     };
     async run() {
         const { flags } = await this.parse(Snapshot);
+        if (flags.compact && process.stderr.isTTY) {
+            this.warn("`--compact` is deprecated and has no effect; use `--full` to include the ref maps.");
+        }
         await runDriverCommandFromFlags("snapshot", {
-            compact: flags.compact,
+            full: flags.full,
             filter: flags.filter,
             maxDepth: flags["max-depth"],
         }, flags);

package/dist/lib/driver/commands/snapshot.js

@@ -2,9 +2,9 @@ import { z } from "zod";
 import { formatSnapshotTree } from "./snapshot-format.js";
 export const snapshotHandlers = {
     async snapshot(manager, params) {
-        const { compact, filter, maxDepth } = z
+        const { full, filter, maxDepth } = z
             .object({
-            compact: z.boolean().optional(),
+            full: z.boolean().optional(),
             filter: z.string().optional(),
             maxDepth: z.number().int().nonnegative().optional(),
         })
@@ -16,17 +16,16 @@ export const snapshotHandlers = {
             xpathMap: snapshot.xpathMap ?? {},
         });
         const tree = formatSnapshotTree(snapshot.formattedTree, {
-            compact,
             filter,
             maxDepth,
         });
-        if (compact) {
-            return { tree };
+        if (full) {
+            return {
+                tree,
+                urlMap: snapshot.urlMap,
+                xpathMap: snapshot.xpathMap,
+            };
         }
-        return {
-            tree,
-            urlMap: snapshot.urlMap,
-            xpathMap: snapshot.xpathMap,
-        };
+        return { tree };
     },
 };