Merge branch 'main' into bugfix/no-env-set-past-startup

Author: cscheid

.github/DISCUSSION_TEMPLATE/feature-requests.yml

@@ -4,6 +4,16 @@ body:
   - type: markdown
     attributes:
       value: |
+        Welcome to the Quarto CLI GitHub repository!
+        We are always happy to hear feedback from our users.
+
+        This is the repository for the command-line program `quarto`:
+
+        - If you're reporting an issue with the **Visual Editor** or with the **Visual Studio Code / Positron extension**, please visit https://github.com/quarto-dev/quarto
+        - If you're reporting an issue inside **RStudio**, please visit https://github.com/rstudio/rstudio
+        - If you're reporting an issue inside **Positron**, please visit https://github.com/posit-dev/positron
+        - If you want to ask for help, please use the [Q&A GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/q-a).
+
         First, please check [Quarto Issues](https://github.com/quarto-dev/quarto-cli/issues) and [Feature Requests GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/feature-requests) to see if your feature request has already been discussed.
         If it has, please consider adding a comment to the existing discussion instead of creating a new one.
 

.github/DISCUSSION_TEMPLATE/q-a.yml

@@ -3,7 +3,17 @@ body:
   - type: markdown
     attributes:
       value: |
-        First, please check [Quarto Issues](https://github.com/quarto-dev/quarto-cli/issues) and [Q&A GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/q-a) first to see if your question has already been asked.
+        Welcome to the Quarto CLI GitHub repository!
+        We are always happy to hear feedback from our users.
+
+        This is the repository for the command-line program `quarto`:
+
+        - If you're reporting an issue with the **Visual Editor** or with the **Visual Studio Code / Positron extension**, please visit https://github.com/quarto-dev/quarto
+        - If you're reporting an issue inside **RStudio**, please visit https://github.com/rstudio/rstudio
+        - If you're reporting an issue inside **Positron**, please visit https://github.com/posit-dev/positron
+        - If you want to ask for a feature, please use the [Feature Requests GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/feature-requests).
+
+        First, please check [Quarto Issues](https://github.com/quarto-dev/quarto-cli/issues) and [Q&A GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/q-a) to see if your question has already been asked.
         If it has, please consider adding a comment to the existing discussion instead of creating a new one.
 
         After checking, if you are not sure if your question has already been asked, please create a new discussion.

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -11,8 +11,8 @@ body:
 
         This is the repository for the command-line program `quarto`:
 
-        - If you're reporting an issue with the VS Code extension, please visit https://github.com/quarto-dev/quarto
-        - If you're reporting an issue inside RStudio, please visit https://github.com/rstudio/rstudio
+        - If you're reporting an issue with the **Visual Editor** or with the **Visual Studio Code / Positron extension**, please visit https://github.com/quarto-dev/quarto
+        - If you're reporting an issue inside **RStudio**, please visit https://github.com/rstudio/rstudio
         - If you're reporting an issue inside **Positron**, please visit https://github.com/posit-dev/positron
         - If you want to ask for a feature, please use the [Feature Requests GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/feature-requests).
         - If you want to ask for help, please use the [Q&A GitHub Discussions](https://github.com/quarto-dev/quarto-cli/discussions/categories/q-a).
@@ -53,6 +53,14 @@ body:
             The end.
             ````
 
+  - type: checkboxes
+    attributes:
+      label: "I have:"
+      options:
+        - label: searched the issue tracker for similar issues
+        - label: installed the latest version of [Quarto CLI](https://github.com/quarto-dev/quarto-cli/releases/latest)
+        - label: formatted my issue following the [Bug Reports guide](https://quarto.org/bug-reports.html)
+
   - type: textarea
     attributes:
       label: Bug description

.github/workflows/test-ff-matrix.yml

@@ -47,7 +47,7 @@ jobs:
       - name: Set up R
         uses: r-lib/actions/setup-r@v2
         with:
-          r-version: "4.4.2"
+          r-version: "4.5.0"
           use-public-rspm: true
           # required to avoid rtools bin in path
           windows-path-include-rtools: false

.github/workflows/test-smokes.yml

@@ -68,7 +68,7 @@ jobs:
       - name: Set up R
         uses: r-lib/actions/setup-r@v2
         with:
-          r-version: "4.4.2"
+          r-version: "4.5.0"
           use-public-rspm: true
           # required to avoid rtools bin in path
           windows-path-include-rtools: false

.vscode/launch.json

@@ -8,7 +8,6 @@
       "name": "Launch Deno",
       "request": "launch",
       "type": "node",
-      "program": "${workspaceFolder}/src/quarto.ts",
       "args": ["serve"],
       "cwd": "${workspaceFolder}/../quarto-demo",
       "runtimeExecutable": "${workspaceFolder}/package/dist/bin/tools/deno",
@@ -19,7 +18,8 @@
         "--importmap=${workspaceFolder}/src/import_map.json",
         "--inspect-brk",
         "--allow-all",
-        "--v8-flags=--enable-experimental-regexp-engine,--max-old-space-size=8192,--max-heap-size=8192"
+        "--v8-flags=--enable-experimental-regexp-engine,--max-old-space-size=8192,--max-heap-size=8192",
+        "${workspaceFolder}/src/quarto.ts"
       ],
       "env": {
         "QUARTO_BIN_PATH": "${workspaceFolder}/package/dist/bin",

configuration

@@ -54,7 +54,7 @@ export DATATABLES_CONFIG=bs5/jszip-3.10.1/dt-1.13.8/b-2.4.2/b-html5-2.4.2/b-prin
 export PDF_MAKE=0.2.7
 
 # javascript search dependencies
-export AUTOCOMPLETE_JS=1.11.1
+export AUTOCOMPLETE_JS=1.19.1
 export FUSE_JS=6.6.2
 export ALGOLIA_SEARCH_JS=4.5.1
 export ALGOLIA_SEARCH_INSIGHTS_JS=2.0.3

news/changelog-1.8.md

@@ -10,7 +10,14 @@ All changes included in 1.8:
 
 ### `html`
 
+- ([#678](https://github.com/quarto-dev/quarto-cli/issues/678)): a11y - Provide appropriate `aria-label` to search button.
+- ([#726](https://github.com/quarto-dev/quarto-cli/issues/726)): a11y - Provide `.screen-reader-only` callout type when callout text doesn't naturally include the type.
+- ([#5538](https://github.com/quarto-dev/quarto-cli/issues/5538)): Fix code-copy button style so that scrolling behaves properly.
+- ([#10983](https://github.com/quarto-dev/quarto-cli/issues/10983)): Fix spacing inconsistency between paras and first section headings.
 - ([#12259](https://github.com/quarto-dev/quarto-cli/issues/12259)): Fix conflict between `html-math-method: katex` and crossref popups (author: @benkeks).
+- ([#12734](https://github.com/quarto-dev/quarto-cli/issues/12734)): `highlight-style` now correctly supports setting a different `light` and `dark`.
+- ([#12747](https://github.com/quarto-dev/quarto-cli/issues/12747)): Ensure `th` elements are properly restored when Quarto's HTML table processing is happening.
+- ([#12766](https://github.com/quarto-dev/quarto-cli/issues/12766)): Use consistent equation numbering display for `html-math-method` and `html-math-method.method` for MathJax and KaTeX (author: @mcanouil)
 
 ### `revealjs`
 
@@ -23,6 +30,12 @@ All changes included in 1.8:
 ### `typst`
 
 - ([#12554](https://github.com/quarto-dev/quarto-cli/pull/12554)): CSS properties `font-weight` and `font-style` are translated to Typst `text` properties.
+- ([#12695](https://github.com/quarto-dev/quarto-cli/issues/12695)): Resolve Typst `font-paths` that start with `/` relative to project root.
+- ([#12739](https://github.com/quarto-dev/quarto-cli/pull/12739)): Remove unused variable `heading-background-color` and `heading-decoration` from Typst's templates. They are leftover from previous change, and not part of Brand.yml schema for typography of headings.
+
+### `beamer`
+
+- ([#12775](https://github.com/quarto-dev/quarto-cli/issues/12775)): Convert Quarto-native layouts (divs with `layout` syntax) to Beamer columns, equivalent to using the Pandoc-native syntax of div with `columns` and `column` classes.
 
 ## Projects
 
@@ -35,3 +48,18 @@ All changes included in 1.8:
 ## Crossrefs
 
 - ([#12615](https://github.com/quarto-dev/quarto-cli/pull/12615)): Adds `algorithm` to theorem environments. (author: @jeremy9959)
+
+## Lua Filters
+
+- ([#12727](https://github.com/quarto-dev/quarto-cli/issues/12727)): Do not crash in the presence of malformed tabset contents.
+
+## Commands
+
+### `inspect`
+
+- ([#12733](https://github.com/quarto-dev/quarto-cli/issues/12733)): Add installed extensions to `quarto inspect` project report.
+
+## Other fixes and improvements
+
+- ([#11321](https://github.com/quarto-dev/quarto-cli/issues/11321)): Follow [recommendation from LaTeX project](https://latex-project.org/news/latex2e-news/ltnews40.pdf) and use `lualatex` instead of `xelatex` as the default PDF engine.
+- ([#12782](https://github.com/quarto-dev/quarto-cli/pull/12782)): fix bug on `safeRemoveDirSync`'s detection of safe directory boundaries.

src/command/dev-call/cmd.ts

@@ -2,7 +2,8 @@ import { Command } from "cliffy/command/mod.ts";
 import { quartoConfig } from "../../core/quarto.ts";
 import { commands } from "../command.ts";
 import { buildJsCommand } from "./build-artifacts/cmd.ts";
-import { hidden } from "../../core/lib/external/colors.ts";
+import { validateYamlCommand } from "./validate-yaml/cmd.ts";
+import { showAstTraceCommand } from "./show-ast-trace/cmd.ts";
 
 type CommandOptionInfo = {
   name: string;
@@ -70,4 +71,6 @@ export const devCallCommand = new Command()
     Deno.exit(1);
   })
   .command("cli-info", generateCliInfoCommand)
-  .command("build-artifacts", buildJsCommand);
+  .command("validate-yaml", validateYamlCommand)
+  .command("build-artifacts", buildJsCommand)
+  .command("show-ast-trace", showAstTraceCommand);

src/command/dev-call/show-ast-trace/cmd.ts

@@ -0,0 +1,74 @@
+/*
+ * cmd.ts
+ *
+ * Copyright (C) 2025 Posit Software, PBC
+ */
+
+import { Command } from "cliffy/command/mod.ts";
+import { quartoCacheDir } from "../../../core/appdirs.ts";
+import { quartoConfig } from "../../../core/quarto.ts";
+import {
+  ensureDir,
+  moveSync,
+  safeRemoveDirSync,
+} from "../../../deno_ral/fs.ts";
+import { basename, dirname, join } from "../../../deno_ral/path.ts";
+import { copy } from "fs/copy";
+import { resourcePath } from "../../../core/resources.ts";
+import { execProcess } from "../../../core/process.ts";
+
+const ensureTracingToolsCopied = async () => {
+  const cacheDir = quartoCacheDir();
+  const tracingDir = `${cacheDir}/ast-tracing`;
+  await ensureDir(tracingDir);
+  safeRemoveDirSync(join(tracingDir, "qmd"), cacheDir);
+  await copy(
+    resourcePath(join("tools", "ast-tracing")),
+    join(tracingDir, "qmd"),
+  );
+  return join(tracingDir, "qmd");
+};
+
+export const showAstTraceCommand = new Command()
+  .name("show-ast-trace")
+  .hidden()
+  .arguments("<arguments...>")
+  .description(
+    "Renders the document with AST tracing enabled and then shows the debugging output.\n\n",
+  )
+  .action(async (_options: unknown, input: string, ...args: string[]) => {
+    const toolsPath = await ensureTracingToolsCopied();
+
+    const dir = dirname(input);
+    const base = basename(input, ".qmd");
+    const traceName = join(dir, `${base}-quarto-ast-trace.json`);
+
+    const renderOpts = {
+      cmd: "quarto",
+      env: {
+        "QUARTO_TRACE_FILTERS": traceName,
+      },
+      args: [
+        "render",
+        input,
+        ...args,
+        "--quiet",
+      ],
+    };
+    const _renderResult = await execProcess(renderOpts);
+    // we don't check for errors here because we want to show the trace even if
+    // the render fails
+
+    moveSync(traceName, join(toolsPath, basename(traceName)));
+
+    const _previewResult = await execProcess({
+      cmd: "quarto",
+      cwd: toolsPath,
+      args: [
+        "preview",
+        "trace-viewer.qmd",
+        "-M",
+        `trace_1:${basename(traceName)}`,
+      ],
+    });
+  });