Skip to content

Commit a9bcc58

Browse files
Merge branch 'main' into bugfix/13942
2 parents df9c437 + 6aa81a5 commit a9bcc58

417 files changed

Lines changed: 31430 additions & 977 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/CODE_OF_CONDUCT.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,9 @@ Examples of unacceptable behavior include:
3636
* Other conduct which could reasonably be considered inappropriate in a
3737
professional setting
3838
* Providing bad information by copying output from AI assistants
39-
without verifying its validity
39+
without verifying its validity. This _specifically_ includes autonomous agents
40+
from OpenClaw, etc. We consider these account-bannable on first offense.
41+
You have been warned.
4042

4143
## Enforcement Responsibilities
4244

.github/workflows/performance-check.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ jobs:
3838
pushd package/src
3939
4040
bundle_start=$(date +%s.%3N)
41-
./quarto-bld prepare-dist
41+
./quarto-bld prepare-dist --set-version $(cat ../../version.txt)
4242
bundle_end=$(date +%s.%3N)
4343
bundle_elapsed=$(printf '%.3f\n' $(echo "scale=3; $bundle_end - $bundle_start" | bc))
4444

.github/workflows/test-bundle.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ jobs:
3333
shell: bash
3434
run: |
3535
pushd package/src
36-
./quarto-bld prepare-dist
36+
./quarto-bld prepare-dist --set-version $(cat ../../version.txt)
3737
mv ../../src/quarto.ts ../../src/quarto1.ts
3838
pushd ../pkg-working/bin
3939
./quarto check

.github/workflows/test-smokes.yml

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ jobs:
9494
9595
- name: Install node dependencies
9696
if: ${{ runner.os != 'Windows' || github.event_name == 'schedule' }}
97-
run: yarn
97+
run: npm install --loglevel=error --no-audit
9898
working-directory: ./tests/integration/playwright
9999
shell: bash
100100

@@ -105,7 +105,7 @@ jobs:
105105

106106
- name: Install MECA validator
107107
if: ${{ runner.os != 'Windows' }}
108-
run: npm install -g meca
108+
run: npm install -g meca --loglevel=error --no-audit
109109

110110
- name: Set RENV_PATHS_ROOT
111111
shell: bash
@@ -212,8 +212,9 @@ jobs:
212212
id: cache-typst
213213
uses: ./.github/actions/cache-typst
214214

215-
- name: Install Chrome
216-
uses: browser-actions/setup-chrome@latest
215+
- name: Install Chrome Headless Shell
216+
run: |
217+
quarto install chrome-headless-shell --no-prompt
217218
218219
- name: Setup Julia
219220
uses: julia-actions/setup-julia@v2

.gitignore

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,3 +53,6 @@ tools/sass-variable-explainer/_publish.yml
5353

5454
# generated by tests
5555
tests/docs/callouts.pdf
56+
57+
# quarto cache directories (populated at render time)
58+
.quarto

configuration

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ export PANDOC=3.8.3
1717
export DARTSASS=1.87.0
1818
export ESBUILD=0.25.10
1919
export TYPST=0.14.2
20+
export VERAPDF=1.28.2
2021

2122

2223
# NB: we can't put comments in the same line as export statements because it

configure.cmd

Lines changed: 21 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,6 @@ REM Variables set dynamically (including being read from a file) should be ev
66
REM using ! ! instead of % %. However, this only allows one level of expansion. Do not
77
REM try to create a variable that derives from a derived variable. It will be empty.
88

9-
REM First Check that Deno isn't running since this causes weird and confusing errors
10-
REM find can conflict with one provided in bash with other args so use absolute path
11-
tasklist /fi "ImageName eq deno.exe" /fo csv 2>NUL | "%WINDIR%/system32/find" /I "deno.exe">NUL
12-
if "%ERRORLEVEL%"=="0" goto :denoRunning
13-
149
call package\src\store_win_configuration.bat
1510
call win_configuration.bat
1611

@@ -19,7 +14,27 @@ if NOT DEFINED QUARTO_VENDOR_BINARIES (
1914
)
2015

2116
if "%QUARTO_VENDOR_BINARIES%" == "true" (
22-
RMDIR /S /Q "!QUARTO_DIST_PATH!"
17+
18+
REM Windows-specific: Check if deno.exe is running before deleting package/dist
19+
REM Extracted to package/scripts/windows/check-deno-in-use.cmd for maintainability
20+
call package\scripts\windows\check-deno-in-use.cmd "!QUARTO_DIST_PATH!"
21+
if "!ERRORLEVEL!"=="1" exit /B 1
22+
23+
echo Removing package/dist/ directory...
24+
RMDIR /S /Q "!QUARTO_DIST_PATH!" 2>NUL
25+
26+
REM Fallback: Verify deletion succeeded (defense in depth)
27+
if exist "!QUARTO_DIST_PATH!" (
28+
echo.
29+
echo ============================================================
30+
echo Error: Could not delete package/dist/ directory
31+
echo This may be due to permissions, antivirus, or another process holding files
32+
echo ============================================================
33+
echo.
34+
echo Try closing applications and run configure.cmd again
35+
exit /B 1
36+
)
37+
2338
MKDIR !QUARTO_BIN_PATH!\tools
2439
PUSHD !QUARTO_BIN_PATH!\tools
2540

@@ -97,9 +112,3 @@ COPY package\typst-gather\target\release\typst-gather.exe "!QUARTO_BIN_PATH!\too
97112
endlocal & set QUARTO_BIN_DEV=%QUARTO_BIN_PATH%
98113

99114
GOTO :eof
100-
101-
:denoRunning
102-
103-
echo Please ensure no instances of `deno.exe` are running before configuring.
104-
echo (Deno might be running as an LSP if you have Visual Studio Code open.)
105-
GOTO :eof

llm-docs/CLAUDE.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
# LLM Documentation
2+
3+
This directory contains documentation written for LLM assistants working on the Quarto codebase.
4+
5+
## Staleness Check
6+
7+
Each document has YAML frontmatter with analysis metadata:
8+
9+
```yaml
10+
---
11+
main_commit: abc1234 # merge-base with main (stable reference)
12+
analyzed_date: 2025-01-22
13+
key_files:
14+
- path/to/file1.ts
15+
- path/to/file2.lua
16+
---
17+
```
18+
19+
**Why merge-base?** Branch commits can be rebased or disappear. The merge-base with main is stable and represents the baseline from main that was analyzed.
20+
21+
**Before relying on a document**, check if key files have changed:
22+
23+
```bash
24+
git log --oneline <main_commit>..main -- <key_files>
25+
```
26+
27+
If there are significant changes, re-explore the codebase and update the document.
28+
29+
## Updating Documents
30+
31+
After re-analyzing, update the frontmatter:
32+
33+
```bash
34+
# Get merge-base with main (use upstream/main if that's the main remote)
35+
git merge-base HEAD main | cut -c1-9
36+
```
37+
38+
Then update `main_commit`, `analyzed_date`, and verify `key_files` list is complete.
39+
40+
**Date verification:** Before writing dates, check today's date from the system environment (shown at conversation start). This avoids year typos like writing 2025 when it's 2026.
41+
42+
## Document Purpose
43+
44+
These docs capture architectural understanding that would otherwise require extensive codebase exploration. They are NOT:
45+
- User documentation (that's at quarto.org)
46+
- Code comments (those live in source files)
47+
- Issue-specific notes (those go in PR descriptions)
48+
49+
They ARE:
50+
- Architectural overviews for AI assistants
51+
- File location maps for common tasks
52+
- Pattern documentation for consistency

0 commit comments

Comments
 (0)