fix: suppress sparse hint for depth-limited snapshots

Author: thymikee

src/commands/cli-output.ts

@@ -63,6 +63,7 @@ const cliOutputFormatters: Partial<Record<CommandName, CliOutputFormatter>> = {
       raw: input.raw as boolean | undefined,
       interactiveOnly: input.interactiveOnly as boolean | undefined,
       scope: input.scope as string | undefined,
+      depth: input.depth as number | undefined,
     }),
   wait: messageOutput,
   alert: messageOutput,

src/commands/client-output.ts

@@ -108,6 +108,7 @@ export function snapshotCliOutput(params: {
   raw?: boolean;
   interactiveOnly?: boolean;
   scope?: string;
+  depth?: number;
 }): CliOutput {
   const data = serializeSnapshotResult(params.result);
   return {
@@ -118,6 +119,7 @@ export function snapshotCliOutput(params: {
       raw: params.raw,
       flatten: params.interactiveOnly,
       scoped: typeof params.scope === 'string' && params.scope.trim().length > 0,
+      depthLimited: typeof params.depth === 'number',
     }),
   };
 }

src/utils/__tests__/output.test.ts

@@ -1339,6 +1339,28 @@ test('formatSnapshotText suppresses sparse snapshot hint for scoped reads', () =
   assert.doesNotMatch(text, /sparse accessibility snapshot/);
 });
 
+test('formatSnapshotText suppresses sparse snapshot hint for depth-limited reads', () => {
+  const text = withNoColor(() =>
+    formatSnapshotText(
+      {
+        nodes: [
+          {
+            ref: 'e1',
+            index: 0,
+            depth: 0,
+            type: 'Application',
+            label: 'Main',
+          },
+        ],
+        truncated: false,
+      },
+      { depthLimited: true },
+    ),
+  );
+
+  assert.doesNotMatch(text, /sparse accessibility snapshot/);
+});
+
 test('formatSnapshotText keeps flattened output and adds duplicate nav warning', () => {
   const nodes = Array.from({ length: 24 }, (_, index) => ({
     ref: `e${index + 1}`,

src/utils/output.ts

@@ -59,6 +59,7 @@ type SnapshotTextOptions = {
   raw?: boolean;
   flatten?: boolean;
   scoped?: boolean;
+  depthLimited?: boolean;
 };
 
 export function formatSnapshotText(
@@ -632,9 +633,9 @@ function buildSnapshotNotices(
 
 function formatSparseSnapshotHint(
   nodes: SnapshotNode[],
-  options: Pick<SnapshotTextOptions, 'scoped'>,
+  options: Pick<SnapshotTextOptions, 'scoped' | 'depthLimited'>,
 ): string | null {
-  if (options.scoped === true || nodes.length > 3) return null;
+  if (options.scoped === true || options.depthLimited === true || nodes.length > 3) return null;
   const noun = nodes.length === 1 ? 'node' : 'nodes';
   return `Hint: sparse accessibility snapshot returned ${nodes.length} ${noun}. The app may expose limited accessibility metadata; run screenshot --overlay-refs for visual context.`;
 }