Make provideStatementRange() create a single chunk virtual doc (#914)

* Make `provideStatementRange()` create a single chunk virtual doc

* CHANGELOG

* Add basic virtual doc snapshot tests

* Copyright year

Author: DavisVaughan

apps/vscode/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## 1.130.0 (Unreleased)
 
+- Fixed a bug where a parse error in one chunk meant you could not perform statement execution in another chunk (<https://github.com/quarto-dev/quarto/pull/914>).
+
 ## 1.129.0 (Release on 2026-01-29)
 
 - Fixed Copilot completions in `.qmd` documents (<https://github.com/quarto-dev/quarto/pull/887>).

apps/vscode/src/host/hooks.ts

@@ -3,7 +3,7 @@
  *
  * Positron-specific functionality.
  *
- * Copyright (C) 2022 by Posit Software, PBC
+ * Copyright (C) 2022-2026 by Posit Software, PBC
  *
  * Unless you have received this program directly from Posit Software pursuant
  * to the terms of a commercial license agreement with Posit Software, then
@@ -22,7 +22,7 @@ import { ExtensionHost, HostWebviewPanel, HostStatementRangeProvider, HostHelpTo
 import { CellExecutor, cellExecutorForLanguage, executableLanguages, isKnitrDocument, pythonWithReticulate } from './executors';
 import { ExecuteQueue } from './execute-queue';
 import { MarkdownEngine } from '../markdown/engine';
-import { virtualDoc, adjustedPosition, unadjustedRange, withVirtualDocUri } from "../vdoc/vdoc";
+import { virtualDoc, adjustedPosition, unadjustedRange, withVirtualDocUri, VirtualDocStyle } from "../vdoc/vdoc";
 import { Position, Range } from 'vscode';
 import { Uri } from 'vscode';
 
@@ -199,7 +199,7 @@ class EmbeddedStatementRangeProvider implements HostStatementRangeProvider {
     document: vscode.TextDocument,
     position: vscode.Position,
     token: vscode.CancellationToken): Promise<hooks.StatementRange | undefined> {
-    const vdoc = await virtualDoc(document, position, this._engine);
+    const vdoc = await virtualDoc(document, position, this._engine, VirtualDocStyle.Block);
     if (vdoc) {
       return await withVirtualDocUri(vdoc, document.uri, "statementRange", async (uri: vscode.Uri) => {
         const result = await vscode.commands.executeCommand<hooks.StatementRange>(

apps/vscode/src/test/codeBlocks.test.ts

@@ -1,6 +1,6 @@
 import * as vscode from "vscode";
 import * as assert from "assert";
-import { WORKSPACE_PATH, examplesOutUri, openAndShowTextDocument } from "./test-utils";
+import { WORKSPACE_PATH, examplesOutUri, openAndShowExamplesOutTextDocument } from "./test-utils";
 import { isExecutableLanguageBlock, languageNameFromBlock } from "quarto-core";
 import { MarkdownEngine } from "../markdown/engine";
 
@@ -17,7 +17,7 @@ suite("Code block detection", function () {
   // doesn't have a preceding blank line. This real-world example has many
   // .notes divs which caused later code blocks to not be detected.
   test("Detects code blocks in document with many divs (issue #521)", async function () {
-    const { doc } = await openAndShowTextDocument("div-code-blocks.qmd");
+    const { doc } = await openAndShowExamplesOutTextDocument("div-code-blocks.qmd");
 
     const tokens = engine.parse(doc);
     const executableBlocks = tokens.filter(isExecutableLanguageBlock);
@@ -49,7 +49,7 @@ suite("Code block detection", function () {
   });
 
   test("Detects code block in simple document", async function () {
-    const { doc } = await openAndShowTextDocument("hello.qmd");
+    const { doc } = await openAndShowExamplesOutTextDocument("hello.qmd");
 
     const tokens = engine.parse(doc);
     const executableBlocks = tokens.filter(isExecutableLanguageBlock);

apps/vscode/src/test/examples/generated_snapshots/vdoc/blocks-python.py

@@ -0,0 +1,31 @@
+# type: ignore
+# flake8: noqa
+#
+#
+#
+#
+#
+#
+#
+#
+1 + 1
+#
+#
+#
+2 + 2
+#
+#
+#
+#
+#
+#
+#
+4 + 4
+#
+#
+#
+#
+#
+#
+#
+#

apps/vscode/src/test/examples/generated_snapshots/vdoc/blocks-r.R

@@ -0,0 +1,29 @@
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+3 + 3
+#
+#
+#
+#
+#
+#
+#
+5 + 5
+#
+#
+#
+#

apps/vscode/src/test/examples/generated_snapshots/vdoc/one-block.R

@@ -0,0 +1,29 @@
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+3 + 3
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#

apps/vscode/src/test/examples/vdoc/blocks.qmd

@@ -0,0 +1,26 @@
+---
+title: "Test all blocks for language at position"
+format: html
+---
+
+## Header
+
+```{python}
+1 + 1
+```
+
+```{python}
+2 + 2
+```
+
+```{r}
+3 + 3
+```
+
+```{python}
+4 + 4
+```
+
+```{r}
+5 + 5
+```

apps/vscode/src/test/examples/vdoc/oob.qmd

@@ -0,0 +1,12 @@
+---
+title: "OOB"
+format: html
+---
+
+## Header
+
+```{python}
+1 + 1
+```
+
+Yo

apps/vscode/src/test/quartoDoc.test.ts

@@ -1,6 +1,6 @@
 import * as vscode from "vscode";
 import * as assert from "assert";
-import { WORKSPACE_PATH, readOrCreateSnapshot, examplesOutUri, wait, roundtrip, openAndShowTextDocument } from "./test-utils";
+import { WORKSPACE_PATH, readOrCreateSnapshot, examplesOutUri, wait, roundtrip, openAndShowExamplesOutTextDocument } from "./test-utils";
 import { isQuartoDoc } from "../core/doc";
 
 
@@ -13,7 +13,7 @@ suite("Quarto basics", function () {
   });
 
   test("Can open a Quarto document", async function () {
-    const { editor } = await openAndShowTextDocument("hello.qmd");
+    const { editor } = await openAndShowExamplesOutTextDocument("hello.qmd");
 
     assert.strictEqual(editor?.document.languageId, "quarto");
     assert.strictEqual(isQuartoDoc(editor?.document), true);
@@ -23,7 +23,7 @@ suite("Quarto basics", function () {
   //       test. That's okay for this test, but could cause issues if you expect a qmd to look how it
   //       does in `/examples`.
   test("Roundtrip doesn't change hello.qmd", async function () {
-    const { doc } = await openAndShowTextDocument("hello.qmd");
+    const { doc } = await openAndShowExamplesOutTextDocument("hello.qmd");
 
     const { before, after } = await roundtrip(doc);
 
@@ -44,7 +44,7 @@ suite("Quarto basics", function () {
 
   // a test to prevent situations like https://github.com/quarto-dev/quarto/issues/845
   test("Can open a non-qmd file normally", async function () {
-    const { editor, doc } = await openAndShowTextDocument("hello.lua");
+    const { editor, doc } = await openAndShowExamplesOutTextDocument("hello.lua");
 
     editor.edit((editBuilder) => {
       editBuilder.insert(new vscode.Position(0, 0), 'print("hiyo")\n');
@@ -57,7 +57,7 @@ suite("Quarto basics", function () {
   });
 
   test("Roundtrip doesn't change nested-checked-list.qmd", async function () {
-    const { doc } = await openAndShowTextDocument("nested-checked-list.qmd");
+    const { doc } = await openAndShowExamplesOutTextDocument("nested-checked-list.qmd");
 
     const { before, after } = await roundtrip(doc);
 
@@ -78,7 +78,7 @@ function roundtripSnapshotTest(filename: string) {
   const snapshotFileName = `roundtripped-${filename}`;
 
   test(`Roundtripped ${filename} matches snapshot`, async function () {
-    const { doc } = await openAndShowTextDocument(filename);
+    const { doc } = await openAndShowExamplesOutTextDocument(filename);
 
     const { after } = await roundtrip(doc);
 

apps/vscode/src/test/test-utils.ts

@@ -26,8 +26,16 @@ export function wait(ms: number) {
   return new Promise(resolve => setTimeout(resolve, ms));
 }
 
-export async function openAndShowTextDocument(fileName: string) {
-  const doc = await vscode.workspace.openTextDocument(examplesOutUri(fileName));
+export async function openAndShowExamplesTextDocument(fileName: string) {
+  return openAndShowUri(examplesUri(fileName));
+}
+
+export async function openAndShowExamplesOutTextDocument(fileName: string) {
+  return openAndShowUri(examplesOutUri(fileName));
+}
+
+async function openAndShowUri(uri: vscode.Uri) {
+  const doc = await vscode.workspace.openTextDocument(uri);
   const editor = await vscode.window.showTextDocument(doc);
   return { doc, editor };
 }