Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

docs: rebuild the site with Astro and Starlight (#3866)

Maximilian Roos8e405bced90a
diff --git a/.claude/skills/running-tend/SKILL.md b/.claude/skills/running-tend/SKILL.md
index 1dce69f44..d714c968a 100644
--- a/.claude/skills/running-tend/SKILL.md
+++ b/.claude/skills/running-tend/SKILL.md
@@ -302,7 +302,8 @@ For each weekly run, check upstream and bump:
- **`baptiste0928/cargo-install@v3` blocks** in `.github/workflows/{affected,ci,coverage,nightly}.yaml` and `.github/actions/{test,tend}-setup/action.yaml` — every `version: "=X.Y.Z"` against `cargo info <crate>`. Today: `cargo-affected`, `cargo-insta`, `cargo-nextest`, `cargo-llvm-cov`, `cargo-msrv`, `cargo-udeps`, `lychee`, `worktrunk`. `cargo-affected` is pinned twice in `affected.yaml`; move both together. Verify each crate's `rust-version` against the pinned toolchain and note compatibility in the PR body (see PR #1657 for the format).
- **`hustcer/setup-nu@v3`** `version:` input — latest from `gh api repos/nushell/nushell/releases/latest --jq '.tag_name'`. Four call sites: `coverage.yaml` (`code-coverage`), `nightly.yaml` (`feature-powerset`), `benchmarks.yaml` (`benchmarks`), and `actions/test-setup/action.yaml`.
- **Codex Cloud tools** — `dev/codex.sh` pins pre-commit, cargo-insta, cargo-nextest, Nushell, and PowerShell; `setup-web` pins Nushell and PowerShell. Keep cargo-insta, cargo-nextest, and Nushell level with `.github/actions/test-setup/action.yaml`, which pins the same three — the gate runs `--all-features`, so Nushell's version moves PTY snapshots. Nothing under `.github/` pins PowerShell (CI runs whatever the runner image ships), so bump that one on its own.
-- **`taiki-e/[email protected]`** `tool: zola@<ver>` in the `check-docs` job — latest from `gh api repos/getzola/zola/releases/latest --jq '.tag_name'`.
+- **Docs site packages** in `docs/package.json` are covered by Dependabot's
+ `/docs` npm entry. Do not duplicate those bumps in this manual pin pass.
- **Runner images** — `ubuntu-24.04`, `macos-15`, `windows-2022`. Keep `windows-2022` pinned (actions/runner-images#12677 — windows-2025 lacks the D: drive).
Discovery shortcut: a recent green CI run on `main` flags cargo-install drift directly via workflow annotations. `gh run view <run-id> --json jobs --jq '.jobs[].databaseId' | xargs -I{} gh api repos/<owner>/<repo>/check-runs/{}/annotations` returns one warning per outdated pin.
@@ -359,7 +360,7 @@ git grep -niE "claude|codex"
Check the latest IDs at <https://docs.anthropic.com/en/docs/about-claude/models> and <https://developers.openai.com/codex/models>. The recommended commit-message commands should use the most recent fastest model from each vendor (Haiku for Anthropic, the smallest current Codex variant for OpenAI).
-**On drift, open a PR — don't file an issue.** The source of truth is `after_long_help` in `src/cli/mod.rs`; edit it and let `cargo test --test integration test_docs_are_in_sync` regenerate the mirrors under `docs/content/` and `skills/worktrunk/reference/`. The "smallest current variant" call is a judgment — pick the one the vendor's models page currently positions as fastest/smallest, and explain the choice in the PR body. Verifying the new model name with an installed CLI (`codex -m <name>`, etc.) isn't possible in this CI sandbox; the PR is the right output anyway, and the maintainer tests on merge.
+**On drift, open a PR — don't file an issue.** The source of truth is `after_long_help` in `src/cli/mod.rs`; edit it and let `cargo test --test integration test_docs_are_in_sync` regenerate the mirrors under `docs/src/content/docs/` and `skills/worktrunk/reference/`. The "smallest current variant" call is a judgment — pick the one the vendor's models page currently positions as fastest/smallest, and explain the choice in the PR body. Verifying the new model name with an installed CLI (`codex -m <name>`, etc.) isn't possible in this CI sandbox; the PR is the right output anyway, and the maintainer tests on merge.
## Weekly Maintenance: Agent App Integration Surfaces
diff --git a/.config/clawpatch/features/feat_custom_remove.json b/.config/clawpatch/features/feat_custom_remove.json
index 8202f6954..cff816d16 100644
--- a/.config/clawpatch/features/feat_custom_remove.json
+++ b/.config/clawpatch/features/feat_custom_remove.json
@@ -46,7 +46,7 @@
"reason": "dirty detection"
},
{
- "path": "docs/content/faq.md",
+ "path": "docs/src/content/docs/faq.md",
"reason": "documented destructive surface"
},
{
diff --git a/.config/lychee.toml b/.config/lychee.toml
index 394c5daa6..712275e22 100644
--- a/.config/lychee.toml
+++ b/.config/lychee.toml
@@ -1,8 +1,8 @@
# Lychee link checker configuration
# See: https://lychee.cli.rs/
-# Root directory for resolving absolute paths (e.g., /assets/...)
-root_dir = "docs/static"
+# Built Astro root for resolving absolute routes and assets.
+root_dir = "docs/dist"
# Network resilience - handles transient failures
max_retries = 6
@@ -21,10 +21,7 @@ cache_exclude_status = "400..=599" # Don't cache errors (only successes)
# Exclude sites that block GitHub Actions or have reliability issues
exclude = [
- # Zola internal links use @/ syntax (validated by `zola check`, not lychee)
- "/@/",
-
- # Links to files under docs/static/ that `test_docs_are_in_sync` generates.
+ # Links to files under docs/public/ that `test_docs_are_in_sync` generates.
# It guarantees their existence, and they point at the live site — so a
# newly added one always 404s until the site is deployed. The first pattern
# covers llms.txt's self-referential index entries; prose and template
@@ -92,10 +89,10 @@ exclude_path = [
# Generated plugin-skills mirror: a byte-identical copy of `skills/`, synced
# by `test_docs_are_in_sync`. Every file here is already link-checked at its
# authored `skills/` source, where `reference/README.md` is a symlink to the
- # repo-root README and its relative `docs/static/logo.png` resolves. The sync
+ # repo-root README and its relative `docs/public/logo.png` resolves. The sync
# dereferences that symlink into a real file, so under the mirror the
# repo-root-relative image path resolves to a nonexistent
- # `plugins/worktrunk/skills/worktrunk/reference/docs/static/logo.png`.
+ # `plugins/worktrunk/skills/worktrunk/reference/docs/public/logo.png`.
# Excluding the redundant copy avoids that false positive without losing
# coverage (the authored source is still checked).
"plugins/worktrunk/skills/",
diff --git a/.config/wt.toml b/.config/wt.toml
index 77ab6a6fd..e583e4129 100644
--- a/.config/wt.toml
+++ b/.config/wt.toml
@@ -1,12 +1,19 @@
-[post-start]
+[[post-start]]
# Copy target/ from main worktree using CoW (~3s vs ~68s full rebuild)
deps = "wt step copy-ignored"
assets = "task fetch-assets"
-# `zola serve` runs forever; tether kills its whole process tree when the
+
+# Restore any packages copy-ignored could not share. The common case uses the
+# local npm cache and finishes without reaching the network.
+[[post-start]]
+docs-install = "npm --prefix docs install --prefer-offline --no-audit --no-fund"
+
+# Astro's dev server runs forever; tether kills its whole process tree when the
# worktree is removed (any path — `wt remove`, `git worktree remove`, `rm -rf`),
-# so no `pre-remove`/`post-remove` cleanup is needed. `-C docs` runs zola in the
-# docs subdir; the worktree root is still what teardown watches.
-docs = "wt step tether -C docs -- zola serve -p {{ branch | hash_port }}"
+# so no `pre-remove`/`post-remove` cleanup is needed. The worktree root is still
+# what teardown watches even though the server runs from `docs/`.
+[[post-start]]
+docs = "wt step tether -C docs -- npm run dev -- --host 127.0.0.1 --port {{ branch | hash_port }}"
[post-merge]
clippy = "pre-commit run clippy --all-files || true"
diff --git a/.gitattributes b/.gitattributes
index 69188f905..2a0b2330e 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,17 +1,17 @@
# Collapse auto-generated files in GitHub PR diffs. These are regenerated by
# `test_docs_are_in_sync` in tests/integration_tests/readme_sync.rs — edits
# belong in the primary source (src/cli/mod.rs for command pages,
-# docs/content/*.md for everything else).
+# docs/src/content/docs/*.md for everything else).
skills/worktrunk/reference/*.md linguist-generated=true
# Skill-only files and the top-level README symlink are primary sources — edited
-# directly, not regenerated from docs/content/. Exempt them so real edits stay
+# directly, not regenerated from docs/src/content/docs/. Exempt them so real edits stay
# visible in PR diffs.
skills/worktrunk/reference/README.md linguist-generated=false
skills/worktrunk/reference/shell-integration.md linguist-generated=false
skills/worktrunk/reference/troubleshooting.md linguist-generated=false
-docs/static/*.md linguist-generated=true
-docs/static/llms.txt linguist-generated=true
-docs/static/.well-known/agent-skills/index.json linguist-generated=true
+docs/public/*.md linguist-generated=true
+docs/public/llms.txt linguist-generated=true
+docs/public/.well-known/agent-skills/index.json linguist-generated=true
# Shell templates are embedded into the binary at compile time (askama); a
# CRLF checkout would leak \r into the shell code Windows-built binaries emit.
templates/* text eol=lf
diff --git a/.github/dependabot.yaml b/.github/dependabot.yaml
index 66174c0e7..55b73bc6e 100644
--- a/.github/dependabot.yaml
+++ b/.github/dependabot.yaml
@@ -21,3 +21,15 @@ updates:
schedule:
interval: daily
labels: []
+
+ - package-ecosystem: npm
+ directory: "/docs"
+ schedule:
+ interval: weekly
+ commit-message:
+ prefix: "chore: "
+ groups:
+ docs-site:
+ patterns:
+ - "*"
+ labels: []
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index ce4e9070c..d99d8eb15 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -225,11 +225,24 @@ jobs:
- name: 📂 Checkout code
uses: actions/checkout@v7
- - name: Setup Zola
- uses: taiki-e/[email protected]
+ - name: Setup Node.js
+ uses: actions/setup-node@v6
with:
+ node-version: 24
+ cache: npm
+ cache-dependency-path: docs/package-lock.json
- - name: 🕷️ Build docs
- run: zola build
+ - name: Install docs dependencies
+ run: npm ci
+ working-directory: docs
+
+ - name: Fetch assets
+ env:
+ GH_TOKEN: ${{ github.token }}
+ run: |
+ gh repo clone max-sixty/worktrunk-assets /tmp/worktrunk-assets -- --depth 1
+ cp -r /tmp/worktrunk-assets/assets docs/public/
+
+ - name: 🕷️ Check and build docs
+ run: npm run check && npm test && npm run build && npm run test:site
working-directory: docs
diff --git a/.github/workflows/nightly.yaml b/.github/workflows/nightly.yaml
index 727338db6..3132e9ae2 100644
--- a/.github/workflows/nightly.yaml
+++ b/.github/workflows/nightly.yaml
@@ -358,11 +358,12 @@ jobs:
link-check:
# The pre-commit `lychee-system` hook (manual stage) over every tracked
- # .md/.txt file. It lives here, not in PR CI: link health depends on the
- # outside world (429s, bot-blocking, transient outages), so it was the
- # flakiest PR check — and link rot isn't PR-correlated anyway; links
- # break when external sites change, not when code does. A failure opens
- # the nightly-failure issue instead of reddening an unrelated PR.
+ # .md/.txt file, resolving local routes against the built Astro site. It
+ # lives here, not in PR CI: link health depends on the outside world
+ # (429s, bot-blocking, transient outages), so it was the flakiest PR
+ # check — and link rot isn't PR-correlated anyway; links break when
+ # external sites change, not when code does. A failure opens the
+ # nightly-failure issue instead of reddening an unrelated PR.
needs: gate
if: needs.gate.outputs.run == 'true'
runs-on: ubuntu-24.04
@@ -373,6 +374,28 @@ jobs:
- name: 📂 Checkout code
uses: actions/checkout@v7
+ - name: Setup Node.js
+ uses: actions/setup-node@v6
+ with:
+ node-version: 24
+ cache: npm
+ cache-dependency-path: docs/package-lock.json
+
+ - name: Install docs dependencies
+ run: npm ci
+ working-directory: docs
+
+ - name: Fetch docs assets
+ env:
+ GH_TOKEN: ${{ github.token }}
+ run: |
+ gh repo clone max-sixty/worktrunk-assets /tmp/worktrunk-assets -- --depth 1
+ cp -r /tmp/worktrunk-assets/assets docs/public/
+
+ - name: Build docs
+ run: npm run build
+ working-directory: docs
+
- name: Install lychee
uses: baptiste0928/cargo-install@v3
with:
diff --git a/.github/workflows/publish-docs.yaml b/.github/workflows/publish-docs.yaml
index 7f002f07b..9c0d4ab82 100644
--- a/.github/workflows/publish-docs.yaml
+++ b/.github/workflows/publish-docs.yaml
@@ -22,25 +22,31 @@ jobs:
- name: 📂 Checkout code
uses: actions/checkout@v7
- - name: Setup Zola
- uses: taiki-e/[email protected]
+ - name: Setup Node.js
+ uses: actions/setup-node@v6
with:
+ node-version: 24
+ cache: npm
+ cache-dependency-path: docs/package-lock.json
+
+ - name: Install docs dependencies
+ run: npm ci
+ working-directory: docs
- name: Fetch assets
env:
GH_TOKEN: ${{ github.token }}
run: |
gh repo clone max-sixty/worktrunk-assets /tmp/worktrunk-assets -- --depth 1
- cp -r /tmp/worktrunk-assets/assets docs/static/
+ cp -r /tmp/worktrunk-assets/assets docs/public/
- name: 🕷️ Build docs
- run: zola build
+ run: npm run check && npm test && npm run build && npm run test:site
working-directory: docs
- uses: actions/upload-pages-artifact@v5
with:
- path: docs/public/
+ path: docs/dist/
retention-days: 1
deploy-docs:
diff --git a/.gitignore b/.gitignore
index 0fa10eebe..8b496315e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,5 @@
/target
-docs/static/assets/
+docs/public/assets/
docs/demos/out/
# Claude Code per-developer local settings (never share these)
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 7f521587e..2d3ec6e9b 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -31,7 +31,8 @@ repos:
- repo: https://github.com/lycheeverse/lychee
rev: nightly
hooks:
- # Check links using .config/lychee.toml exclusions
+ # Check links using .config/lychee.toml exclusions. Build the docs first
+ # so root-relative site links resolve against docs/dist.
# Uses lychee-system (requires `cargo install lychee`) to avoid /bin/bash dependency on Windows
#
# Manual stage only: link health depends on external sites (429s,
diff --git a/.typos.toml b/.typos.toml
index c806dc710..1fef86e5d 100644
--- a/.typos.toml
+++ b/.typos.toml
@@ -2,7 +2,7 @@
extend-exclude = ["docs/demos/vhs-keystrokes/", "*.snap", "vendor/", "*.log"]
[default]
-# Generated `wt list` doc embeds (README, docs/content, skills mirrors) truncate
+# Generated `wt list` doc embeds (README, site docs, skills mirrors) truncate
# long commit messages with a trailing … . The cut leaves a word fragment glued
# to the ellipsis (e.g. "authenticat…"), which typos would "correct" to the full
# word — re-breaking the doc-sync test on every run. A token immediately followed
diff --git a/CLAUDE.md b/CLAUDE.md
index 4159c032d..bcb02144b 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -44,7 +44,7 @@ Load relevant skills before starting; reload when scope changes mid-session. Pro
## Documentation
-Behavior changes require doc updates. `src/cli/mod.rs` (`after_long_help` plus clap attributes) is the PRIMARY SOURCE for command pages; their rendered mirrors in `docs/content/` and `skills/worktrunk/reference/` are generated, as is all of `plugins/worktrunk/skills/` — but both directories also hold hand-edited primaries (non-command docs in `docs/content/`, skill-only pages like `shell-integration.md` in the reference dir), so check which file is primary in the sync taxonomy before editing. Ask: "does `--help` still describe what the code does?" `cargo test --test integration test_docs_are_in_sync` checks doc sync; editing help text (`after_long_help`, `about`, arg docs) also changes the rendered `--help` snapshots, which that test leaves untouched — `cargo insta test --accept --test integration -- test_help` regenerates them (the pre-merge hook runs both). Sync taxonomy, help-text authoring (three render contexts, link text, config-TOML blocks): `docs/CLAUDE.md`.
+Behavior changes require doc updates. `src/cli/mod.rs` (`after_long_help` plus clap attributes) is the PRIMARY SOURCE for command pages; their rendered mirrors in `docs/src/content/docs/` and `skills/worktrunk/reference/` are generated, as is all of `plugins/worktrunk/skills/` — but both directories also hold hand-edited primaries (non-command docs in `docs/src/content/docs/`, skill-only pages like `shell-integration.md` in the reference dir), so check which file is primary in the sync taxonomy before editing. Ask: "does `--help` still describe what the code does?" `cargo test --test integration test_docs_are_in_sync` checks doc sync; editing help text (`after_long_help`, `about`, arg docs) also changes the rendered `--help` snapshots, which that test leaves untouched — `cargo insta test --accept --test integration -- test_help` regenerates them (the pre-merge hook runs both). Sync taxonomy, help-text authoring (three render contexts, link text, config-TOML blocks): `docs/CLAUDE.md`.
## Plugin Layout
@@ -66,7 +66,7 @@ These stop where git's own protections stop, and matching git is deliberate in e
- `wt merge` and `wt step push` overwrite an ignored file in the destination worktree whose path the incoming commits track, exactly as a `git merge` run there would (`src/commands/worktree/push.rs`).
- Removal's final dirty-worktree gate is answered by the fsmonitor daemon under `core.fsmonitor`, exactly as `git worktree remove`'s own gate is (`src/git/remove.rs`).
-Full inventory: FAQ [What files does Worktrunk create?](docs/content/faq.md#what-files-does-worktrunk-create) and [What can Worktrunk delete?](docs/content/faq.md#what-can-worktrunk-delete). Review new code that changes this surface against those sections.
+Full inventory: FAQ [What files does Worktrunk create?](docs/src/content/docs/faq.md#what-files-does-worktrunk-create) and [What can Worktrunk delete?](docs/src/content/docs/faq.md#what-can-worktrunk-delete). Review new code that changes this surface against those sections.
## Command Execution Principles
diff --git a/Cargo.lock b/Cargo.lock
index 65f5cd18a..13d05c64f 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -73,16 +73,6 @@ dependencies = [
"ansitok",
]
-[[package]]
-name = "ansi-to-html"
-version = "0.2.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1747e9bde0e06cdfa780fcba909df1fa220f82421ead1fd4a93427763d2cbda6"
-dependencies = [
- "memchr",
- "regex",
-]
-
[[package]]
name = "ansi-to-tui"
version = "8.0.1"
@@ -4813,7 +4803,6 @@ name = "worktrunk"
version = "0.74.0"
dependencies = [
"ansi-str",
- "ansi-to-html",
"ansi-to-tui",
"anstream",
"anstyle",
diff --git a/Cargo.toml b/Cargo.toml
index 50e98c8e8..a04f9373a 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -26,19 +26,18 @@ filterset = "binary_id(=worktrunk) | binary_id(=worktrunk::bin/wt)"
# tests/integration_tests/readme_sync.rs reads each of these at runtime (via
# fs::read_to_string) and asserts the committed copies stay in sync — both the
-# sources (README.md, docs/content markdown, docs/config.toml's site title and
-# description, src/cli/mod.rs, src/llm.rs, the skill references, Taskfile.yaml)
+# sources (README.md, docs/src/content/docs Markdown, src/cli/mod.rs,
+# src/llm.rs, the skill references, Taskfile.yaml)
# and the generated artifacts it regenerates and compares against (the
-# dev/*.example.toml files, docs/static/llms.txt, the agent-skills index.json).
+# dev/*.example.toml files, docs/public/llms.txt, the agent-skills index.json).
# Editing any of them flips the test, but coverage can't link a runtime-read
# file to it.
[[workspace.metadata.affected.rule]]
globs = [
"README.md",
"docs/**/*.md",
- "docs/config.toml",
- "docs/static/llms.txt",
- "docs/static/.well-known/agent-skills/index.json",
+ "docs/public/llms.txt",
+ "docs/public/.well-known/agent-skills/index.json",
"dev/*.toml",
"src/cli/mod.rs",
"src/llm.rs",
@@ -321,7 +320,6 @@ criterion = "0.8"
portable-pty = "0.9"
regex = "1.12.3"
vt100 = "0.16.2"
-ansi-to-html = "0.2.3"
wt-perf = { path = "tests/helpers/wt-perf" }
similar = "3.1.1"
jsonschema = { version = "0.49", default-features = false }
diff --git a/README.md b/README.md
index d113ddba7..b86cf5637 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
<!-- markdownlint-disable MD033 -->
-<h1><img src="docs/static/logo.png" alt="Worktrunk logo" width="50" align="absmiddle">&nbsp;&nbsp;Worktrunk</h1>
+<h1><img src="docs/public/logo.png" alt="Worktrunk logo" width="50" align="absmiddle">&nbsp;&nbsp;Worktrunk</h1>
<!-- Crates.io badge below disabled while shields.io is rate-limited by crates.io
(renders "CRATES.IO: INVALID"). Tracking: badges/shields#11879. Restore once fixed.
@@ -25,7 +25,7 @@ A quick demo:
> ### 📚 Full documentation at [worktrunk.dev](https://worktrunk.dev) 📚
-<!-- ⚠️ AUTO-GENERATED from docs/content/worktrunk.md#context-git-worktrees..worktrunk-makes-git-worktrees-as-easy-as-branches — edit source to update -->
+<!-- ⚠️ AUTO-GENERATED from docs/src/content/docs/worktrunk.md#context-git-worktrees..worktrunk-makes-git-worktrees-as-easy-as-branches — edit source to update -->
## Context: git worktrees
@@ -42,7 +42,7 @@ worktree requires typing the branch name three times: `git worktree add -b feat
Worktrees are addressed by branch name; paths are computed from a configurable template. Commands that take a branch also accept the path of the worktree it is checked out in.
-> Start with the core commands
+<p class="workflow-stage">Start with the core commands</p>
**Core commands:**
@@ -57,34 +57,34 @@ Worktrees are addressed by branch name; paths are computed from a configurable t
<tbody>
<tr>
<td>Switch worktrees</td>
- <td><pre>wt switch feat</pre></td>
- <td><pre>cd ../repo.feat</pre></td>
+ <td data-label="Worktrunk"><code>wt switch feat</code></td>
+ <td data-label="Plain git"><code>cd ../repo.feat</code></td>
</tr>
<tr>
<td>Create + start Claude</td>
- <td><pre>wt switch -c -x claude feat</pre></td>
- <td><pre>git worktree add -b feat ../repo.feat && \
+ <td data-label="Worktrunk"><code>wt switch -c -x claude feat</code></td>
+ <td data-label="Plain git"><pre><code>git worktree add -b feat ../repo.feat && \
cd ../repo.feat && \
-claude</pre></td>
+claude</code></pre></td>
</tr>
<tr>
<td>Clean up</td>
- <td><pre>wt remove</pre></td>
- <td><pre>cd ../repo && \
+ <td data-label="Worktrunk"><code>wt remove</code></td>
+ <td data-label="Plain git"><pre><code>cd ../repo && \
git worktree remove ../repo.feat && \
-git branch -d feat</pre></td>
+git branch -d feat</code></pre></td>
</tr>
<tr>
<td>List with status</td>
- <td><pre>wt list</pre></td>
- <td><pre>git worktree list</pre> (paths only)</td>
+ <td data-label="Worktrunk"><code>wt list</code></td>
+ <td data-label="Plain git"><span class="cmd-compare-value"><code>git worktree list</code> (paths only)</span></td>
</tr>
</tbody>
</table>
-> Expand into the more advanced commands as needed
+<p class="workflow-stage">Expand into the more advanced commands as needed</p>
-**Workflow automation:**
+<p class="workflow-heading"><strong>Workflow automation:</strong></p>
- **[Hooks](https://worktrunk.dev/hook/)** — run commands on create, pre-merge, post-merge, etc
- **[LLM commit messages](https://worktrunk.dev/llm-commits/)** — generate commit messages from diffs
@@ -103,7 +103,7 @@ Multiple parallel agents, same simple commands:
<!-- END AUTO-GENERATED -->
-<!-- ⚠️ AUTO-GENERATED from docs/content/worktrunk.md#install..further-reading — edit source to update -->
+<!-- ⚠️ AUTO-GENERATED from docs/src/content/docs/worktrunk.md#install..further-reading — edit source to update -->
## Install
@@ -158,7 +158,6 @@ Create a worktree for a new feature:
```console
$ wt switch --create feature-auth
✓ Created branch feature-auth from main and worktree @ ~/repo.feature-auth
-
```
This creates a new branch and worktree, then switches to it. Do your work, then check all worktrees with [`wt list`](https://worktrunk.dev/list/):
@@ -170,7 +169,6 @@ $ wt list
^ main ^⇡ ⇡1 0e631ad 1d Initial commit
○ Showing 2 worktrees, 1 with changes, 1 ahead, 1 column hidden
-
```
The `@` marks the current worktree. `+` means staged changes, `↑1` means 1 commit ahead of main, `⇡` means unpushed commits.
@@ -200,7 +198,6 @@ $ wt merge main
✓ Merged to main (1 commit, 2 files, +53)
◎ Removing feature-auth worktree & branch in background (same commit as main, _)
○ Switched to worktree for main @ ~/repo
-
```
For parallel agents, create multiple worktrees and launch an agent in each:
diff --git a/Taskfile.yaml b/Taskfile.yaml
index fc9e82200..89e452aa2 100644
--- a/Taskfile.yaml
+++ b/Taskfile.yaml
@@ -4,7 +4,7 @@ version: "3"
vars:
REPO_ROOT:
sh: pwd
- STATIC_DIR: "{{.REPO_ROOT}}/docs/static"
+ STATIC_DIR: "{{.REPO_ROOT}}/docs/public"
ASSETS_DIR: "{{.STATIC_DIR}}/assets"
tasks:
@@ -439,7 +439,7 @@ tasks:
echo ""
done
- echo "Commands used (from docs/content/llm-commits.md):"
+ echo "Commands used (from docs/src/content/docs/llm-commits.md):"
for tool in "${AVAILABLE[@]}"; do
echo " $tool: ${COMMANDS[$tool]}"
done
diff --git a/docs/.gitignore b/docs/.gitignore
index 96fee8079..f64c4f1a9 100644
--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -1,3 +1,4 @@
-public/
-static/assets/
-static/giallo*.css
+node_modules/
+.astro/
+dist/
+public/assets/
diff --git a/docs/CLAUDE.md b/docs/CLAUDE.md
index d61d813a4..68159fa6a 100644
--- a/docs/CLAUDE.md
+++ b/docs/CLAUDE.md
@@ -1,384 +1,274 @@
-# Docs Site
+# Documentation Site
-This is the Zola-based documentation site for Worktrunk, published at worktrunk.dev.
+The Worktrunk site is built with Astro and Starlight and published at
+https://worktrunk.dev.
-## Development workflow
+## Development
-The docs dev server starts automatically via the post-start hook. Find the port with `wt list statusline`.
+The project hook installs the site dependencies, fetches the demo assets, and
+starts the Astro dev server. Find this worktree's URL with `wt list`.
-For static builds with local URLs (e.g., testing with a simple HTTP server):
+To run it yourself:
```bash
-zola build --base-url "http://127.0.0.1:PORT"
+npm --prefix docs install
+npm --prefix docs run dev -- --host 127.0.0.1 --port 4321
```
-### Verifying changes
+The local production checks are:
-**Text-only changes** (prose edits, content rewrites): Run pre-commit and provide the dev server link. Playwright verification is not required.
+```bash
+npm --prefix docs run check
+npm --prefix docs test
+npm --prefix docs run build
+npm --prefix docs run test:site
+```
-**Visual changes** (CSS, layout, templates, responsive breakpoints): Use Playwright MCP to verify before returning. Visual bugs often hide in CSS specificity, template inheritance, and responsive behavior.
+`npm run build` clears Astro's content cache, writes `docs/dist/`, and builds
+the Pagefind search index. The forced content rebuild is intentional: renderer
+plugin changes affect generated asset hashes but are not part of Astro's
+content-cache key.
-Playwright workflow for visual changes:
-1. Navigate to affected page(s)
-2. Take a snapshot to verify rendered output
-3. Iterate if the result doesn't match expectations
+### Verifying changes
-Common visual issues to check:
-- Text positioning and visibility
-- Spacing and alignment
-- Regressions on nearby elements
-- Responsive behavior (use `browser_resize`)
+Text-only edits need the docs sync test and a production build. Visual changes
+also need browser verification with Playwright at desktop and mobile widths.
+Check the changed page, one command-reference page, search, the mobile menu,
+theme switching, anchor navigation, code copying, wide tables, and demo images.
-**Always include the dev server link** when returning after doc changes:
+Always include the local dev-server link when handing off a docs change:
-```
+```text
View changes: http://127.0.0.1:<port>
```
-## Theme architecture
-
-The docs use a standalone "warm workbench" theme. Key files:
-
-| File | Purpose |
-|------|---------|
-| `templates/_variables.html` | CSS custom properties (colors, layout, typography) |
-| `sass/custom.scss` | All styling, organized by section |
-| `templates/base.html` | Head overrides, iOS viewport polyfill |
-| `templates/index.html` | Homepage hero and animations |
-| `templates/page.html` | Doc page TOC rendering |
+## Site architecture
+
+| Path | Responsibility |
+|------|----------------|
+| `astro.config.mjs` | Starlight integration, navigation, metadata, and code rendering |
+| `src/content/docs/` | Canonical documentation Markdown |
+| `src/pages/index.astro` | Homepage route; renders the canonical `worktrunk.md` body |
+| `src/styles/custom.css` | Worktrunk's visual system and narrow Starlight adjustments |
+| `src/plugins/stable-heading-ids.mjs` | Stable public anchor IDs for Markdown headings |
+| `src/plugins/worktrunk-terminal.mjs` | Prompts, copy behavior, and state colors for `console` fences |
+| `src/components/Head.astro` | Social metadata, structured data, and analytics |
+| `tests/` | Renderer unit tests and built-site route/link checks |
+| `public/` | Files served unchanged at the site root |
+| `demos/` | VHS sources and scripts for the external demo assets |
+
+The site uses Starlight's own navigation, table of contents, responsive shell,
+search, code frames, copy controls, and theme selector. Keep overrides narrow.
+Before replacing a Starlight component, check whether configuration or CSS can
+express the change. Every full component override becomes an upstream merge
+surface.
+
+The visual direction is a warm technical field manual: ivory paper, dark ink,
+one orange accent, strong typography, and terminal output as the main visual
+material. Avoid generic product-site devices such as gradient headline text,
+glass cards, feature-card grids, decorative blobs, and animation without a
+clear navigational or explanatory purpose.
+
+## Content and route contract
+
+Public documentation routes are stable. Existing pages should keep their root
+paths, for example `src/content/docs/switch.md` is `/switch/`. The homepage
+renders `worktrunk.md`; `/worktrunk/` remains available for compatibility and
+has a canonical link to `/`.
+
+Use root-relative links in canonical Markdown:
-### Layout system
-
-The sticky header and TOC use **definitional CSS variables** so positions are always in sync:
-
-```
---wt-header-height: 60px (includes border via box-sizing: border-box)
---wt-main-padding-top: 40px
-
-TOC sticks at: calc(header + padding) = 100px
-Anchor scroll-margin: same calculation
+```markdown
+[hook templates](/hook/#template-variables)
```
-When either variable changes (including via media queries), all dependent values update automatically. This prevents the TOC from "jumping" when transitioning to sticky mode.
-
-### Key technical decisions
+The sync pipeline expands them to full `https://worktrunk.dev/...` URLs for
+README and agent-skill copies. Do not add framework-specific link syntax.
+`stable-heading-ids.mjs` preserves the site's established anchor scheme, and
+`test:site` verifies every built internal page link and fragment.
-1. **`box-sizing: border-box` on header** - Border is included in height, simplifying calculations
-2. **`scrollbar-gutter: stable`** - Reserves scrollbar space to prevent layout shift on navigation
-3. **IntersectionObserver intercept** - Ensures scroll-spy doesn't conflict with TOC styling
-4. **Logo preload** - Prevents flash when navigating between pages
-5. **WCAG AA colors** - `--wt-color-text-soft` is #78716a for 4.5:1 contrast
-6. **iOS viewport polyfill** - Sets stable `--vh-full` variable for Firefox iOS/Chrome iOS (see `templates/base.html` for details on the jank issue and what we tried)
+Images and demos use root-relative paths into `public/`:
-### Responsive breakpoints
-
-Variables are overridden in media queries to maintain definitional correctness:
-
-- **≤1024px**: `--wt-main-padding-top: 30px`
-- **≤768px**: `--wt-header-height: 50px`, `--wt-main-padding-top: 20px`, TOC hidden
-
-### Extending the theme
+```html
+<figure class="demo">
+<picture>
+ <source srcset="/assets/docs/dark/wt-switch.gif" media="(prefers-color-scheme: dark)">
+ <img src="/assets/docs/light/wt-switch.gif" alt="wt switch demo" width="1600" height="900">
+</picture>
+</figure>
+```
-When adding new positioned elements:
-- Use the layout variables rather than hardcoding pixel values
-- Test anchor navigation to verify no visual jumps
-- Check both with and without page scroll
+## Documentation sync taxonomy
-## Doc sync taxonomy
+`cargo test --test integration test_docs_are_in_sync` owns the complete sync
+pipeline. It updates generated files and then fails so the changes are visible.
+Run it again after reviewing those changes; the second run must pass.
-Three categories, kept in sync by `test_docs_are_in_sync` (run it after any doc change; it auto-updates out-of-sync pages):
+There are three source categories:
-1. **Command pages** (config, hook, list, merge, remove, step, switch): `dev/*.example.toml` (via `include_str!`) → `src/cli/mod.rs` *(PRIMARY SOURCE)* → `docs/content/{command}.md` → `skills/worktrunk/reference/{command}.md`. Within `src/cli/mod.rs`, `after_long_help` carries the conceptual prose; clap attributes (`about`, `long_about`, doc comments on args) carry usage, options, and examples. Mechanism details: "Command page generation" below.
-2. **Non-command docs** (claude-code, code-signing, extending, faq, llm-commits, tips-patterns, worktrunk): `docs/content/*.md` is PRIMARY; edit it directly, the skill reference auto-syncs.
-3. **Skill-only files** (shell-integration.md, troubleshooting.md): edit `skills/worktrunk/reference/` directly, no docs equivalent. When adding one, also add a `linguist-generated=false` line to `.gitattributes` — the broad `skills/worktrunk/reference/*.md linguist-generated=true` rule otherwise marks it generated, collapsing real edits in GitHub PR diffs.
+1. **Command pages**: `src/cli/mod.rs` is primary for `config`, `hook`, `list`,
+ `merge`, `remove`, `step`, and `switch`. The sync test writes the generated
+ region in `docs/src/content/docs/{command}.md`, then generates the matching
+ `skills/worktrunk/reference/` page.
+2. **Non-command pages**: files such as `claude-code.md`, `extending.md`,
+ `faq.md`, `llm-commits.md`, `tips-patterns.md`, and `worktrunk.md` are primary
+ in `docs/src/content/docs/`. The sync test derives the skill copy.
+3. **Skill-only pages**: files such as `shell-integration.md` and
+ `troubleshooting.md` are primary in `skills/worktrunk/reference/` and have no
+ site page. When adding one, add a `linguist-generated=false` entry to
+ `.gitattributes`.
Never hand-edit a generated mirror.
-### Help text authoring
-
-Help text renders in three contexts; check all three when editing:
-
-1. **Terminal** (`wt step X --help`): `about` and `subtitle` at the top, `after_long_help` below the Options block — separated by distance.
-2. **Web docs**: `combine_command_docs()` concatenates `about` + optional `subtitle` + `after_long_help` as consecutive paragraphs.
-3. **Skill reference**: mirrors web docs.
-
-Because web docs concatenate everything, the `after_long_help` opener must not restate `about`/`subtitle` — start with new information (see "Command documentation structure" below for opener patterns). Link text must stand alone when the URL is stripped (terminal help drops the URL, keeping only the text): use `` [`wt foo`](...) `` for commands (the backticks signal a `--help` lookup) or a descriptive phrase for doc sections; avoid bare labels that match the destination's heading.
+### Command-page generation
-After editing `after_long_help`, also refresh the help snapshots: `cargo insta test --accept --test integration -- test_help`.
-
-### Config doc TOML blocks
-
-Config docs (`USER_CONFIG_START` / `PROJECT_CONFIG_START` sections in `src/cli/mod.rs`) generate `dev/*.example.toml` files where every line is `#`-commented, so TOML comments inside code blocks become double-commented (`# # comment`). Use plain-text descriptions ending with a colon before each code block; inline end-of-line comments (`key = "value" # explanation`) are fine.
-
-## Command page generation
-
-Each command page in `docs/content/` is a frontmatter skeleton with an `AUTO-GENERATED` region populated from `wt <command> --help-page`:
+Each command page keeps YAML frontmatter outside one generated region:
```markdown
-+++
-title = "wt list"
-weight = 11
-
-[extra]
-group = "Commands"
-+++
-
+---
+title: "wt list"
+description: "List worktrees and their status."
+sidebar:
+ order: 11
+---
<!-- ⚠️ AUTO-GENERATED from `wt list --help-page` — edit src/cli/mod.rs to update -->
-[generated content here]
+[generated content]
<!-- END AUTO-GENERATED -->
```
-The bare close marker is paired with the open via non-greedy regex matching. `test_no_nested_auto_generated_markers` enforces that no `AUTO-GENERATED` open ever appears inside a region in `docs/content/*.md`, which is the precondition for non-greedy pairing to be safe.
-
-The frontmatter (title, weight, group) is preserved; everything between the markers is regenerated as `after_long_help` (conceptual prose) followed by a Command Reference section from `--help`.
-
-### Command documentation structure
+The bare close marker is paired with the open marker using a non-greedy match.
+`test_no_nested_auto_generated_markers` enforces the required invariant: an
+auto-generated region may not contain another auto-generated region.
-Each command has three documentation pieces in `src/cli/mod.rs`:
+Each command has three pieces in `src/cli/mod.rs`:
| Piece | Source | Purpose |
|-------|--------|---------|
-| **Definition** | First `///` line | Short identifier for command lists |
-| **Subdefinition** | Second `///` line (optional) | Adds context when relevant |
-| **after_long_help** | `#[command(after_long_help = "...")]` | Full documentation |
-
-**Where each appears:**
-
-| Context | What's shown |
-|---------|--------------|
-| Command list (`wt --help`) | Definition only |
-| Terminal `-h` | Definition in header |
-| Terminal `--help` | Definition (header) + Subdefinition (under header) + after_long_help (after options) |
-| Web docs | "Definition. Subdefinition." as lead paragraph, then after_long_help |
-
-**Content principles:**
+| Definition | First `///` line | Short text for command lists |
+| Subdefinition | Second `///` line, when useful | Context below the terminal help header |
+| Full guide | `after_long_help` | Mental model, workflow, examples, and reference links |
-1. **Definition must be short** — It appears in command lists; keep it to a noun phrase or brief imperative.
+Terminal help displays the full guide after the options. The web page combines
+the definition and subdefinition as its lead, followed by the full guide. Do
+not repeat the lead at the start of `after_long_help`.
-2. **Subdefinition adds context** — Only include if it provides information the definition doesn't. If the definition is complete, omit the subdefinition.
+Link text must still make sense when terminal help removes the URL. Prefer
+``[`wt merge`](/merge/)`` or a descriptive phrase over a bare destination
+heading.
-3. **after_long_help must not repeat** — Start with NEW information that expands on or provides context for the definition. Each piece should add information the previous pieces didn't provide.
+Config examples between `USER_CONFIG_START` / `USER_CONFIG_END` and
+`PROJECT_CONFIG_START` / `PROJECT_CONFIG_END` also generate commented TOML
+files. Put prose before a code block instead of adding standalone TOML comment
+lines that would become double-commented. End-of-line comments are fine.
-4. **after_long_help should mostly stand alone** — The opener should give context or purpose, not just continue with details that only make sense after reading the definition. Avoid non-sequiturs.
+After changing help text, refresh both generated pages and help snapshots:
-5. **Give a behavior the share of the docs that matches its share of the feature** — every paragraph is read by everyone who runs `--help`, so length is a claim on that attention. A guard or edge case that is a tiny share of the command usually gets zero words: its own error message states it at the moment it matters, and the help page leaves it implicit. Reserve prose for what most users of the command meet.
-
-**Good patterns for after_long_help openers:**
-
-- Explain the mental model: "Worktrees are addressed by branch name..."
-- Contrast with similar tools: "Unlike `git merge`, this merges current into target..."
-- State the use case: "Use when you're done with a feature branch."
-- Explain what something is: "Shell commands that run at key points..."
-- Describe relationship to other commands: "The building blocks of `wt merge`: commit, squash, rebase, push."
-
-**Patterns to avoid:**
-
-- Repeating the definition with different words
-- Starting with details that assume context ("The table shows..." when there's no prior mention of a table)
-- Leading with configuration defaults before establishing what the command does
-- Non-sequiturs that jump to side-effects without context
+```bash
+cargo test --test integration test_docs_are_in_sync
+cargo insta test --accept --test integration -- test_help
+```
-### Example output expansion (wt list)
+### Snapshot examples
-The `wt list` examples use **HTML comments + code blocks** that expand to full snapshot output. In `src/cli/mod.rs`, you write:
+A command placeholder in `src/cli/mod.rs` expands from an integration snapshot:
-`````
+````markdown
<!-- wt list -->
```console
-wt list
-```
-`````
-
-This renders differently in each context:
-- **Terminal help (`--help`)**: HTML comment skipped, code block shows as dimmed `wt list`
-- **Web docs (`--help-page`)**: Both are replaced with the standard template format:
-
-```
-<!-- ⚠️ AUTO-GENERATED from tests/snapshots/<snapshot_file> — edit source to update -->
-
-{% terminal() %}
-<span class="prompt">$</span> <span class="cmd">wt list</span>
-<output...>
-{% end %}
-
-<!-- END AUTO-GENERATED -->
+$ wt list
```
+````
-**The mapping** (in `tests/integration_tests/readme_sync.rs`):
-
-| Placeholder | Snapshot File |
-|-------------|---------------|
-| `<!-- wt list -->` | `readme_example_list.snap` |
-| `<!-- wt list --full -->` | `readme_example_list_full.snap` |
-| `<!-- wt list --branches --full -->` | `readme_example_list_branches.snap` |
-
-**To update example output:**
-
-1. Edit test setup in `tests/integration_tests/list.rs` → `setup_readme_example_repo()`
-2. Run tests to regenerate snapshots: `cargo test --test integration readme_example_list`
-3. Accept snapshots: `cargo insta accept`
-4. Sync docs: `cargo test --test integration test_docs_are_in_sync`
-
-The examples in `src/cli/mod.rs` are just command stubs — the actual output comes from snapshots generated by integration tests. This ensures docs always match real CLI behavior.
-
-### Code block convention
-
-All shell commands use `$ ` prefix in `` ```console `` blocks. `convert_dollar_console_to_terminal()` (`src/docs.rs`, shared library function) converts them to terminal shortcodes. The sync test also runs this on hand-written docs.
-
-| Detected pattern | Web output | Highlighting |
-|------------------|------------|--------------|
-| `$ ` commands | `cmd` parameter with `\|\|\|` delimiter | Full Syntect |
-| No `$ ` | `console` → `bash` conversion | Syntect (no `$ ` prompt) |
-
-All `$ ` commands go through the `cmd` parameter path for consistent Syntect highlighting. Multiple commands are joined by `|||`; the template splits and highlights each individually. Commands are wrapped in `<span class="cmd">` (CSS `::before` adds `$ `). Comment lines (`#`) are highlighted but not wrapped (no prompt).
-
-**Placeholders in cmd values:** Tera (Zola's template engine) would interpret `{{ }}` in the `cmd` parameter as template expressions, and `"` would close the parameter string. Since Tera has no backslash-escape mechanism for string literals, these characters are replaced with text placeholders (`__WT_OPEN__`, `__WT_CLOSE__`, `__WT_QUOT__`) in the Rust conversion function. The terminal shortcode template replaces them back before Syntect highlighting. The sync test also strips them when generating skill reference files.
-
-Hand-written docs can use either `console` fences with `$ ` (auto-converted by the sync test) or shortcodes directly.
-
-### CLI and web compatibility
-
-Content in `after_long_help` must work in **both** the terminal (`--help`) and the web docs:
+The mapping lives in `tests/integration_tests/readme_sync.rs`. The generated
+site page uses the real command plus ANSI-stripped output in one `console`
+fence. This keeps the Markdown readable on GitHub and lets the site renderer
+add prompts and command-only copy behavior without changing the source.
-- **Tables** — Work in both. Prefer tables over bullet lists for structured data.
-- **Markdown links** — Work in both (`[text](/path/)`)
-- **Code blocks** — Work in both
-- **Raw HTML** — Avoid. Renders as raw text in terminal help.
+To update an example:
-### Post-processing for web docs
+1. Change the test setup that owns the snapshot.
+2. Run the focused integration test.
+3. Accept the snapshot with `cargo insta accept`.
+4. Run `test_docs_are_in_sync` twice, reviewing the first run's edits.
-The `--help-page` generator in `src/help.rs` applies post-processing to transform CLI-friendly content into web-friendly HTML:
+### Code-block convention
-| CLI Source | Web Output |
-|------------|------------|
-| `` ```console `` with `$ ` | `terminal` shortcode with `cmd` parameter |
-| `` ```console `` (no `$ `) | `` ```bash `` |
-| `` `●` green `` | `<span style='color:#0a0'>●</span> green` |
-| `` `●` blue `` | `<span style='color:#00a'>●</span> blue` |
-| `` `●` red `` | `<span style='color:#a00'>●</span> red` |
-| `` `●` magenta `` | `<span style='color:#a0a'>●</span> magenta` |
-| `` `●` cyan `` | `<span style='color:#0aa'>●</span> cyan` |
-| `` `●` yellow `` | `<span style='color:#a60'>●</span> yellow` |
-| `` `●` gray `` | `<span style='color:#888'>●</span> gray` |
-| `[experimental]` | `<span class="badge-experimental"></span>` (text via CSS `::after`) |
+Use ordinary fenced Markdown. There are no template shortcodes or encoded
+command parameters.
-To add web-only styling for new content, edit `post_process_for_html()` in `src/help.rs` — not the markdown files.
+- Use `bash` for commands a reader can copy as a complete recipe.
+- Use `console` when commands and captured output share a block. Prefix command
+ lines with `$ `; leave output unprefixed.
+- Use the actual data language (`toml`, `json`, `yaml`, and so on) for files and
+ structured output.
-Similarly, `md_help::colorize_status_symbols()` applies ANSI colors for terminal `--help` output.
+Example:
-### Subdoc expansion
-
-Include subcommand documentation as H2 sections within a parent command's docs page using subdoc placeholders:
-
-```markdown
-<!-- subdoc: subcommand-name -->
+````markdown
+```console
+$ wt switch --create feature-auth
+✓ Created branch feature-auth from main
```
+````
-In `src/cli/mod.rs`, add the placeholder anywhere in the parent command's `after_long_help`:
+Starlight and Expressive Code create the terminal frame and copy button. The
+small Worktrunk plugin removes `$ ` from presentation data, renders it as a
+prompt, and makes mixed blocks copy only their commands. Comment lines and
+blank recipe separators remain copyable; captured output does not. The plugin
+also restores green/red/amber state markers from the portable text rather than
+putting ANSI escapes in Markdown. Committed Markdown must remain useful without
+the plugin.
-```rust
-after_long_help = r#"...main documentation...
+### Web-only post-processing
-<!-- subdoc: create -->
+`post_process_for_html()` in `src/help.rs` handles the few semantic differences
+between terminal and site output: experimental badges, CI color labels, demo
+figures, and a linked issue-report phrase. Do not route general Markdown
+through it and do not add pre-rendered ANSI HTML.
-...more documentation..."#
-```
+### Subdocument expansion
-This expands during `--help-page` generation to:
+Use a subdocument placeholder to include a subcommand as a section of its
+parent page:
```markdown
-## wt config create
-
-### User config
-[subcommand's after_long_help content with heading levels increased]
-
----
-
-### Command reference
-[subcommand's usage and options]
-```
-
-**How it works:**
-- The placeholder is invisible in terminal `--help` output (HTML comment)
-- Heading levels in the subcommand's `after_long_help` are increased by one (## → ###)
-- The subcommand's help reference is formatted as a nested `### Command reference`
-
-**Use cases:**
-- `wt list statusline` — Surfaces output formats that would otherwise be terminal-only
-- `wt config state marker` — Shows per-key examples not in the parent
-
-All AUTO-GENERATED markers use a consistent format with START and END tags:
-```html
-<!-- ⚠️ AUTO-GENERATED from <source> — edit <file> to update -->
-[content]
-<!-- END AUTO-GENERATED -->
-```
-
-All `AUTO-GENERATED` regions use the bare close — sync test
-`test_no_nested_auto_generated_markers` enforces that no region ever nests
-inside another in `docs/content/*.md`, which is the precondition for the
-outer-region regex to safely pair the open with the close via non-greedy
-matching. If you ever need nested regions, restore a disambiguating close
-form on the outer marker rather than relying on the regex.
-
-## Template examples in documentation
-
-**All template examples must have corresponding tests** in `tests/integration_tests/doc_templates.rs`. This catches issues like operator precedence bugs (PR #373).
-
-When adding template examples, add a test that verifies the template produces expected output. See existing tests for patterns.
-
-## Demo GIF workflow
-
-Demo GIFs (~2MB each) are stored in a separate `worktrunk-assets` repo to avoid bloating git history. Both build and fetch output to `docs/static/assets/` (gitignored), so local builds override fetched assets.
-
-**For local development:**
-```bash
-task fetch-assets # Download published assets
-```
-
-**To regenerate demos** (required after CLI output changes):
-
-```bash
-./docs/demos/build docs # Doc site demos (light + dark)
-./docs/demos/build social # Social media demos (light only)
-task publish-assets # Publish to assets repo
+<!-- subdoc: create -->
```
-Deploy runs `fetch-assets` before building.
+The generator raises the subcommand heading levels and appends its command
+reference. The comment is invisible in terminal help.
-For detailed demo development guidelines (timing, debugging, environment setup), see `docs/demos/CLAUDE.md`.
+## Template examples
-## Social card workflow
+Every Worktrunk template expression shown in documentation needs a matching
+test in `tests/integration_tests/doc_templates.rs`. This is what catches parser
+and operator-precedence changes before they make an example misleading.
-Social cards follow the same assets pattern as demos.
+## Demo assets
-**Source files:**
-- `social-card.svg` (1200×630) — Open Graph/Twitter link previews, referenced in `base.html`
-- `github-social-card.svg` (1280×640) — GitHub repository preview, uploaded manually in repo Settings → Social preview
+Large GIFs and rendered social cards live in the separate
+`max-sixty/worktrunk-assets` repository. `task fetch-assets` copies published
+assets to `docs/public/assets/`, which is gitignored. The publish workflow does
+the same before building.
-**To regenerate** (after changing tagline, logo, or layout):
+To regenerate and publish demos:
```bash
-task build-social-cards # SVG → PNG (downloads fonts if needed)
-task publish-assets # Publish to assets repo
+./docs/demos/build docs
+./docs/demos/build social
+task publish-assets
```
-The build script automatically downloads Inter and Plus Jakarta Sans fonts from GitHub if not installed locally. Requires `rsvg-convert` (from librsvg).
-
-**Referenced in:** `docs/templates/base.html` (og:image, twitter:image meta tags)
+See `docs/demos/CLAUDE.md` for timing, terminal setup, validation, and recording
+guidance.
-### Light/dark theme variants
+Social-card SVG sources remain in `docs/public/`:
-In markdown, use `<picture>` with media queries:
-```html
-<figure class="demo">
-<picture>
- <source srcset="/assets/docs/dark/wt-switch-picker.gif" media="(prefers-color-scheme: dark)">
- <img src="/assets/docs/light/wt-switch-picker.gif" alt="wt switch picker demo" width="1600" height="800">
-</picture>
-</figure>
-```
+- `social-card.svg` is the 1200 by 630 Open Graph source.
+- `github-social-card.svg` is the 1280 by 640 repository-preview source.
-The browser automatically shows the appropriate variant based on system preference.
+Build their PNG outputs with `task build-social-cards`, then publish them with
+`task publish-assets`. `src/components/Head.astro` points social metadata at
+`/assets/social/social-card.png`.
diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
new file mode 100644
index 000000000..50231b946
--- /dev/null
+++ b/docs/astro.config.mjs
@@ -0,0 +1,75 @@
+import { unified } from '@astrojs/markdown-remark';
+import sitemap from '@astrojs/sitemap';
+import starlight from '@astrojs/starlight';
+import { defineConfig } from 'astro/config';
+
+import { rehypePagefindCommandReferences } from './src/plugins/pagefind-command-references.mjs';
+import { rehypeResponsiveTables } from './src/plugins/responsive-tables.mjs';
+import { rehypeStableHeadingIds } from './src/plugins/stable-heading-ids.mjs';
+import { sidebar } from './src/site-navigation.mjs';
+import { sitemapCompatibility } from './src/plugins/sitemap-compatibility.mjs';
+import { pluginWorktrunkTerminal } from './src/plugins/worktrunk-terminal.mjs';
+
+const repository = 'https://github.com/max-sixty/worktrunk';
+const site = 'https://worktrunk.dev';
+
+export default defineConfig({
+ site,
+ devToolbar: {
+ enabled: false,
+ },
+ markdown: {
+ processor: unified({
+ rehypePlugins: [
+ rehypeStableHeadingIds,
+ rehypePagefindCommandReferences,
+ rehypeResponsiveTables,
+ ],
+ }),
+ },
+ integrations: [
+ starlight({
+ title: 'Worktrunk',
+ description: 'Git worktree management for parallel AI agent workflows.',
+ disable404Route: true,
+ favicon: '/favicon.png',
+ logo: {
+ src: './public/logo.png',
+ alt: 'Worktrunk',
+ },
+ social: [
+ { icon: 'github', label: 'GitHub', href: repository },
+ ],
+ tableOfContents: {
+ minHeadingLevel: 1,
+ maxHeadingLevel: 2,
+ },
+ editLink: {
+ baseUrl: `${repository}/edit/main/docs/`,
+ },
+ customCss: ['./src/styles/custom.css'],
+ components: {
+ Footer: './src/components/Footer.astro',
+ Head: './src/components/Head.astro',
+ PageTitle: './src/components/PageTitle.astro',
+ SocialIcons: './src/components/SocialIcons.astro',
+ ThemeSelect: './src/components/ThemeSelect.astro',
+ },
+ expressiveCode: {
+ plugins: [pluginWorktrunkTerminal()],
+ styleOverrides: {
+ borderRadius: '0',
+ codeFontFamily: 'var(--sl-font-mono)',
+ frames: {
+ frameBoxShadowCssValue: 'none',
+ },
+ },
+ },
+ sidebar,
+ }),
+ sitemap({
+ filter: (page) => ![`${site}/404/`, `${site}/worktrunk/`].includes(page),
+ }),
+ sitemapCompatibility(),
+ ],
+});
diff --git a/docs/config.toml b/docs/config.toml
deleted file mode 100644
index 5f5d1c151..000000000
--- a/docs/config.toml
+++ /dev/null
@@ -1,29 +0,0 @@
-# Zola configuration for Worktrunk documentation
-base_url = "https://worktrunk.dev/"
-
-compile_sass = true
-build_search_index = true
-
-title = "Worktrunk"
-
-[markdown]
-insert_anchor_links = "heading"
-
-[markdown.highlighting]
-style = "class"
-light_theme = "worktrunk-light"
-dark_theme = "base16-ocean-dark"
-extra_themes = ["themes/worktrunk-light.json", "themes/base16-ocean-dark.json"]
-error_on_missing_language = true
-
-[extra]
-logo_name = "Worktrunk"
-logo_path = "logo.png"
-rust_crate = "worktrunk"
-github_repo = "max-sixty/worktrunk"
-site_description = "CLI for Git worktree management, designed for parallel AI agent workflows."
-extra_menu = [
- { title = "Worktrunk", link = "/worktrunk/" },
- { title = "Tips", link = "/tips-patterns/" },
- { title = "GitHub", link = "https://github.com/max-sixty/worktrunk" },
-]
diff --git a/docs/content/_index.md b/docs/content/_index.md
deleted file mode 100644
index e965982e7..000000000
--- a/docs/content/_index.md
+++ /dev/null
@@ -1,4 +0,0 @@
-+++
-title = "Worktrunk"
-sort_by = "weight"
-+++
diff --git a/docs/content/worktrunk.md b/docs/content/worktrunk.md
deleted file mode 100644
index 0a5c14b0f..000000000
--- a/docs/content/worktrunk.md
+++ /dev/null
@@ -1,222 +0,0 @@
-+++
-title = "Worktrunk"
-description = "CLI for Git worktree management, designed for parallel AI agent workflows."
-weight = 1
-
-[extra]
-canonical = "/"
-+++
-
-Worktrunk is a CLI for git worktree management, designed for running AI agents
-in parallel.
-
-Worktrunk's three core commands make worktrees as easy as branches.
-Plus, Worktrunk has a bunch of quality-of-life features to simplify working
-with many parallel changes, including hooks to automate local workflows.
-
-A quick demo:
-
-<figure class="demo">
-<picture>
- <source srcset="/assets/docs/dark/wt-core.gif" media="(prefers-color-scheme: dark)">
- <img src="/assets/docs/light/wt-core.gif" alt="Worktrunk demo showing wt list, wt switch, and hooks" width="1600" height="900">
-</picture>
-<figcaption>Listing worktrees, switching, cleaning up</figcaption>
-</figure>
-
-## Context: git worktrees
-
-AI agents like Claude Code and Codex can handle longer tasks without
-supervision, such that it's possible to manage 5-10+ in parallel. Git's native
-worktree feature give each agent its own working directory, so they don't step
-on each other's changes.
-
-But the git worktree UX is clunky. Even a task as small as starting a new
-worktree requires typing the branch name three times: `git worktree add -b feat
-../repo.feat`, then `cd ../repo.feat`.
-
-## Worktrunk makes git worktrees as easy as branches
-
-Worktrees are addressed by branch name; paths are computed from a configurable template. Commands that take a branch also accept the path of the worktree it is checked out in.
-
-> Start with the core commands
-
-**Core commands:**
-
-<table class="cmd-compare">
- <thead>
- <tr>
- <th>Task</th>
- <th>Worktrunk</th>
- <th>Plain git</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>Switch worktrees</td>
- <td>{% rawcode() %}wt switch feat{% end %}</td>
- <td>{% rawcode() %}cd ../repo.feat{% end %}</td>
- </tr>
- <tr>
- <td>Create + start Claude</td>
- <td>{% rawcode() %}wt switch -c -x claude feat{% end %}</td>
- <td>{% rawcode() %}git worktree add -b feat ../repo.feat && \
-cd ../repo.feat && \
-claude{% end %}</td>
- </tr>
- <tr>
- <td>Clean up</td>
- <td>{% rawcode() %}wt remove{% end %}</td>
- <td>{% rawcode() %}cd ../repo && \
-git worktree remove ../repo.feat && \
-git branch -d feat{% end %}</td>
- </tr>
- <tr>
- <td>List with status</td>
- <td>{% rawcode() %}wt list{% end %}</td>
- <td>{% rawcode() %}git worktree list{% end %} (paths only)</td>
- </tr>
- </tbody>
-</table>
-
-> Expand into the more advanced commands as needed
-
-**Workflow automation:**
-
-- **[Hooks](@/hook.md)** — run commands on create, pre-merge, post-merge, etc
-- **[LLM commit messages](@/llm-commits.md)** — generate commit messages from diffs
-- **[Merge workflow](@/merge.md)** — squash, rebase, merge, clean up in one command
-- **[Interactive picker](@/switch.md#interactive-picker)** — browse worktrees with live diff and log previews
-- **[Copy build caches](@/step.md#wt-step-copy-ignored)** — skip cold starts by sharing `target/`, `node_modules/`, etc between worktrees
-- **[`wt list --full`](@/list.md#full-mode)** — [CI status](@/list.md#ci-status) and [AI-generated summaries](@/list.md#llm-summaries) per branch
-- **[PR checkout](@/switch.md#pull-requests-and-merge-requests)** — `wt switch pr:123` to jump straight to a PR's branch
-- **[Dev server per worktree](@/tips-patterns.md#dev-server-per-worktree)** — `hash_port` template filter gives each worktree a unique port
-- **[Aliases](@/extending.md#aliases) & [per-branch variables](@/config.md#wt-config-state-vars)** — custom `wt <name>` commands and branch-scoped state for hook templates
-- ...and **[lots more](#next-steps)**
-
-Multiple parallel agents, same simple commands:
-
-<figure class="demo">
-<picture>
- <source srcset="/assets/docs/dark/wt-zellij-omnibus.gif" media="(prefers-color-scheme: dark)">
- <img src="/assets/docs/light/wt-zellij-omnibus.gif" alt="Worktrunk omnibus demo: multiple Claude agents in Zellij tabs with hooks, LLM commits, and merge workflow" width="1600" height="900">
-</picture>
-<figcaption>Multiple Claude agents in parallel with interactive picker, hooks, LLM commits, and merge</figcaption>
-</figure>
-
-## Install
-
-**Homebrew (macOS & Linux):**
-
-{{ terminal(cmd="brew install worktrunk && wt config shell install") }}
-
-Shell integration allows commands to change directories.
-
-**Cargo:**
-
-{{ terminal(cmd="cargo install worktrunk && wt config shell install") }}
-
-<details>
-<summary><strong>Windows & other</strong></summary>
-
-**Windows.** `wt` defaults to Windows Terminal's command, so Winget additionally installs Worktrunk as `git-wt` to avoid the conflict:
-
-{{ terminal(cmd="winget install max-sixty.worktrunk|||git-wt config shell install") }}
-
-Alternatively, disable Windows Terminal's alias (Settings → Apps → Advanced app settings → App execution aliases → "Terminal"/"Terminal Preview") to use `wt` directly.
-
-> Free code signing provided by [SignPath.io](https://signpath.io/), certificate by [SignPath Foundation](https://signpath.org/) — [policy](@/code-signing.md).
-
-**Arch Linux:**
-
-{{ terminal(cmd="sudo pacman -S worktrunk && wt config shell install") }}
-
-**Conda / Pixi** (community-maintained [feedstock](https://github.com/conda-forge/worktrunk-feedstock)):
-
-{{ terminal(cmd="conda install -c conda-forge worktrunk && wt config shell install") }}
-
-Or with [Pixi](https://pixi.sh): `pixi global install worktrunk && wt config shell install`.
-
-</details>
-
-## Quick start
-
-Create a worktree for a new feature:
-
-<!-- ⚠️ AUTO-GENERATED from tests/snapshots/integration__integration_tests__list__quickstart_switch.snap — edit source to update -->
-
-{% terminal(cmd="wt switch --create feature-auth") %}
-<span class="cmd">wt switch --create feature-auth</span>
-<span class=g>✓</span> <span class=g>Created branch <b>feature-auth</b> from <b>main</b> and worktree @ <b>~/repo.feature-auth</b></span>
-{% end %}
-
-<!-- END AUTO-GENERATED -->
-
-This creates a new branch and worktree, then switches to it. Do your work, then check all worktrees with [`wt list`](@/list.md):
-
-<!-- ⚠️ AUTO-GENERATED from tests/snapshots/integration__integration_tests__list__quickstart_list.snap — edit source to update -->
-
-{% terminal(cmd="wt list") %}
-<span class="cmd">wt list</span>
- <b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Remote⇅</b> <b>Commit</b> <b>Age</b> <b>Message</b>
-@ feature-auth <span class=c>+</span> <span class=d>↑</span> <span class=g>+27</span> <span class=r>-8</span> <span class=g>↑1</span> <span class=g>+31</span> <span class=d>4bc72dc</span> <span class=d>2h</span> <span class=d>Add authenticati…</span>
-^ main <span class=d>^</span><span class=d>⇡</span> <span class=g>⇡1</span> <span class=d>0e631ad</span> <span class=d>1d</span> <span class=d>Initial commit</span>
-
-<span class=d>○</span> <span class=d>Showing 2 worktrees, 1 with changes, 1 ahead, 1 column hidden</span>
-{% end %}
-
-<!-- END AUTO-GENERATED -->
-
-The `@` marks the current worktree. `+` means staged changes, `↑1` means 1 commit ahead of main, `⇡` means unpushed commits.
-
-When done, either:
-
-**PR workflow** — commit, push, open a PR, merge via GitHub/GitLab, then clean up:
-
-{{ terminal(cmd="wt step commit # commit staged changes|||gh pr create # or glab mr create|||wt remove # after PR is merged") }}
-
-**Local merge** — squash, rebase onto main, fast-forward merge, clean up:
-
-<!-- ⚠️ AUTO-GENERATED from tests/snapshots/integration__integration_tests__list__quickstart_merge.snap — edit source to update -->
-
-{% terminal(cmd="wt merge main") %}
-<span class="cmd">wt merge main</span>
-<span class=c>◎</span> <span class=c>Generating commit message and committing changes... <span style='color:var(--bright-black,#555)'>(2 files, <span class=g>+53</span></span></span>, no squashing needed<span style='color:var(--bright-black,#555)'>)</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>Add authentication module</b>
-<span class=g>✓</span> <span class=g>Committed changes @ <span class=d>a1b2c3d</span></span>
-<span class=c>◎</span> <span class=c>Merging 1 commit to <b>main</b> @ <span class=d>a1b2c3d</span> (no rebase needed)</span>
-<span style='background:var(--bright-white,#fff)'> </span> * <span style='color:var(--yellow,#a60)'>a1b2c3d</span> Add authentication module
-<span style='background:var(--bright-white,#fff)'> </span> auth.rs | 51 <span class=g>+++++++++++++++++++++++++++++++++++++++++++++++++++</span>
-<span style='background:var(--bright-white,#fff)'> </span> lib.rs | 2 <span class=g>++</span>
-<span style='background:var(--bright-white,#fff)'> </span> 2 files changed, 53 insertions(+)
-<span class=g>✓</span> <span class=g>Merged to <b>main</b> <span style='color:var(--bright-black,#555)'>(1 commit, 2 files, <span class=g>+53</span></span></span><span style='color:var(--bright-black,#555)'>)</span>
-<span class=c>◎</span> <span class=c>Removing <b>feature-auth</b> worktree &amp; branch in background (same commit as <b>main</b>,</span> <span class=d>_</span><span class=c>)</span>
-<span class=d>○</span> Switched to worktree for <b>main</b> @ <b>~/repo</b>
-{% end %}
-
-<!-- END AUTO-GENERATED -->
-
-For parallel agents, create multiple worktrees and launch an agent in each:
-
-{{ terminal(cmd="wt switch -x claude -c feature-a -- 'Add user authentication'|||wt switch -x claude -c feature-b -- 'Fix the pagination bug'|||wt switch -x claude -c feature-c -- 'Write tests for the API'") }}
-
-The `-x` flag runs a command after switching; arguments after `--` are passed to it. Configure [post-start hooks](@/hook.md#hook-types) to automate setup (install deps, start dev servers).
-
-## Next steps
-
-- Learn the core commands: [`wt switch`](@/switch.md), [`wt list`](@/list.md), [`wt merge`](@/merge.md), [`wt remove`](@/remove.md)
-- Set up [hooks](@/hook.md) for automated setup
-- Explore [LLM commit messages](@/llm-commits.md), [interactive
- picker](@/switch.md#interactive-picker), [Claude Code integration](@/claude-code.md), [CI
- status & PR links](@/list.md#ci-status)
-- Browse [tips & patterns](@/tips-patterns.md) for recipes: aliases, dev servers, databases, agent handoffs, and more
-- [Extending Worktrunk](@/extending.md) — customize workflows with hooks & aliases
-- Run `wt --help` or `wt <command> --help` for quick CLI reference
-
-## Further reading
-
-- [Claude Code: Best practices for agentic coding](https://www.anthropic.com/engineering/claude-code-best-practices) — Anthropic's official guide, including the worktree pattern
-- [Shipping faster with Claude Code and Git Worktrees](https://incident.io/blog/shipping-faster-with-claude-code-and-git-worktrees) — incident.io's workflow for parallel agents
-- [Git worktree pattern discussion](https://github.com/anthropics/claude-code/issues/1052) — Community discussion in the Claude Code repo
-- [@DevOpsToolbox's video on Worktrunk](https://youtu.be/WBQiqr6LevQ?t=345)
-- [git-worktree documentation](https://git-scm.com/docs/git-worktree) — Official git reference
diff --git a/docs/demos/CLAUDE.md b/docs/demos/CLAUDE.md
index 19bfc651f..bd7a00b1a 100644
--- a/docs/demos/CLAUDE.md
+++ b/docs/demos/CLAUDE.md
@@ -9,8 +9,8 @@ docs/demos/
shared/ # Python library, themes, fixtures
vhs-keystrokes/ # Custom VHS binary (gitignored, built on demand)
-docs/static/assets/ # Output GIFs (gitignored, shared with fetch-assets)
- docs/ # Doc site demos (1600x900)
+docs/public/assets/ # Output GIFs (gitignored, shared with fetch-assets)
+ docs/ # Doc site demos (1600x900; wt-core-mobile is 576x432)
light/ # Light theme variants
dark/ # Dark theme variants
social/ # Social media demos (1200x700)
@@ -34,13 +34,14 @@ Regenerate a single demo:
```bash
./docs/demos/build social --only wt-switch
./docs/demos/build docs --only wt-merge
+./docs/demos/build docs --only wt-core-mobile
```
**Available demos:**
| Target | Demos |
|--------|-------|
-| docs | wt-core, wt-switch, wt-list, wt-commit, wt-statusline, wt-merge, wt-switch-picker, wt-zellij-omnibus |
+| docs | wt-core, wt-core-mobile, wt-switch, wt-list, wt-commit, wt-statusline, wt-merge, wt-switch-picker, wt-zellij-omnibus |
| social | wt-switch, wt-statusline, wt-list, wt-list-remove, wt-hooks, wt-devserver, wt-commit, wt-merge, wt-switch-picker, wt-core, wt-zellij-omnibus |
## Snapshot testing
@@ -122,7 +123,7 @@ After building, publish to the assets repo:
task publish-assets
```
-This copies `docs/static/assets/{docs,social}/` to the `worktrunk-assets` repo (sibling directory), commits, and pushes. The script clones the repo via `gh` if missing.
+This copies `docs/public/assets/{docs,social}/` to the `worktrunk-assets` repo (sibling directory), commits, and pushes. The script clones the repo via `gh` if missing.
To fetch published assets (without rebuilding):
@@ -130,7 +131,7 @@ To fetch published assets (without rebuilding):
task fetch-assets
```
-Both build and fetch output to the same location (`docs/static/assets/`), so local builds override fetched assets.
+Both build and fetch output to the same location (`docs/public/assets/`), so local builds override fetched assets.
## Modifying the VHS fork
@@ -199,6 +200,7 @@ Branch setup (from shared infrastructure):
The docs build generates both light and dark GIF variants in separate directories:
- `docs/light/wt-core.gif` / `docs/dark/wt-core.gif`
+- `docs/light/wt-core-mobile.gif` / `docs/dark/wt-core-mobile.gif` (576×432 responsive homepage source)
- `docs/light/wt-merge.gif` / `docs/dark/wt-merge.gif`
- `docs/light/wt-switch-picker.gif` / `docs/dark/wt-switch-picker.gif`
@@ -281,10 +283,10 @@ Key fields in `.claude.json` for suppressing notifications:
Inline viewing options:
```bash
# Quick Look (macOS)
-qlmanage -p docs/static/assets/docs/light/wt-switch-picker.gif
+qlmanage -p docs/public/assets/docs/light/wt-switch-picker.gif
# iTerm2 inline images
-imgcat docs/static/assets/docs/light/wt-switch-picker.gif
+imgcat docs/public/assets/docs/light/wt-switch-picker.gif
```
## Reviewing demo GIFs
diff --git a/docs/demos/build b/docs/demos/build
index 96eded34b..d20b74267 100755
--- a/docs/demos/build
+++ b/docs/demos/build
@@ -7,7 +7,7 @@ Usage:
./build docs --only wt-merge # Build specific demo for docs
./build social --only wt-zellij-omnibus --shell # Debug shell for social demo
-Output is written to docs/static/assets/{mode}/{theme}/, ensuring docs and social
+Output is written to docs/public/assets/{mode}/{theme}/, ensuring docs and social
builds don't overwrite each other. The assets repo mirrors this structure.
"""
@@ -45,6 +45,7 @@ from shared import ( # noqa: E402
setup_demo_output,
record_theme,
SIZE_DOCS,
+ SIZE_DOCS_MOBILE,
SIZE_SOCIAL,
record_text,
record_snapshot,
@@ -57,7 +58,7 @@ from shared.validation import ( # noqa: E402
)
REPO_ROOT = SCRIPT_DIR.parent.parent
-OUT_DIR = SCRIPT_DIR.parent / "static" / "assets"
+OUT_DIR = SCRIPT_DIR.parent / "public" / "assets"
TAPES_DIR = SCRIPT_DIR / "tapes"
SNAPSHOTS_DIR = SCRIPT_DIR / "snapshots"
@@ -308,11 +309,12 @@ url = "http://localhost:{{ branch | hash_port }}"
# =============================================================================
# Format: (tape_file, output_name, setup_func)
-# All demos in a mode use that mode's default size.
+# Demos use their mode's default size unless TARGETS provides a named override.
# Note: setup_func must be a named function (not lambda) for multiprocessing.
DOCS_DEMOS = [
("wt-core.tape", "wt-core", prepare_with_hooks),
+ ("wt-core-mobile.tape", "wt-core-mobile", prepare_with_hooks),
("wt-switch.tape", "wt-switch", prepare_switch),
("wt-list.tape", "wt-list", prepare_with_hooks),
("wt-commit.tape", "wt-commit", prepare_merge_demo),
@@ -344,6 +346,7 @@ TARGETS = {
"docs": {
"demos": DOCS_DEMOS,
"size": SIZE_DOCS,
+ "sizes": {"wt-core-mobile": SIZE_DOCS_MOBILE},
"themes": ["light", "dark"],
},
"social": {
@@ -612,6 +615,7 @@ def build_target(target: str, args, vhs_binary: str) -> list[str]:
target_config = TARGETS[target]
demos = target_config["demos"]
demo_size = target_config["size"]
+ demo_sizes = target_config.get("sizes", {})
themes = target_config["themes"]
# Filter demos if --only specified
@@ -658,7 +662,7 @@ def build_target(target: str, args, vhs_binary: str) -> list[str]:
setup_func,
mode_out_dir,
themes,
- demo_size,
+ demo_sizes.get(output_name, demo_size),
vhs_binary,
args.text,
args.snapshot,
@@ -687,7 +691,7 @@ def build_target(target: str, args, vhs_binary: str) -> list[str]:
setup_func,
mode_out_dir,
themes,
- demo_size,
+ demo_sizes.get(output_name, demo_size),
vhs_binary,
args.text,
args.snapshot,
diff --git a/docs/demos/shared/__init__.py b/docs/demos/shared/__init__.py
index 6bbe24425..ac662b729 100644
--- a/docs/demos/shared/__init__.py
+++ b/docs/demos/shared/__init__.py
@@ -8,6 +8,7 @@ from .lib import (
DemoSize,
SIZE_SOCIAL,
SIZE_DOCS,
+ SIZE_DOCS_MOBILE,
run,
git,
render_tape,
@@ -45,6 +46,7 @@ __all__ = [
"DemoSize",
"SIZE_SOCIAL",
"SIZE_DOCS",
+ "SIZE_DOCS_MOBILE",
"run",
"git",
"render_tape",
diff --git a/docs/demos/shared/lib.py b/docs/demos/shared/lib.py
index 6d86dfee7..b669acde1 100644
--- a/docs/demos/shared/lib.py
+++ b/docs/demos/shared/lib.py
@@ -1182,8 +1182,10 @@ def extract_commands_from_tape(
Parses the tape looking for Type "command" followed by Enter patterns,
filtering to commands that start with specified prefixes (default: wt, git).
- Only extracts commands after Show directive (visible part of demo).
- Skips commands in Hide blocks.
+ Only extracts commands executed after a Show directive (visible part of
+ demo). A command may be typed while hidden to make a complete command the
+ first frame, provided its Enter occurs after Show. Skips commands executed
+ in Hide blocks.
Args:
tape_path: Path to the .tape template file
@@ -1200,40 +1202,42 @@ def extract_commands_from_tape(
commands = []
in_visible_section = False
+ pending_command = None
lines = rendered.split("\n")
- i = 0
-
- while i < len(lines):
- line = lines[i].strip()
+ for raw_line in lines:
+ line = raw_line.strip()
# Track visibility
if line == "Show":
in_visible_section = True
+ continue
elif line == "Hide":
in_visible_section = False
+ continue
- # Look for Type "command" pattern
- if in_visible_section and line.startswith("Type "):
- # Extract command from Type "..." or Type '...'
+ if line.startswith("Type "):
match = re.match(r'Type\s+["\'](.+)["\']', line)
if match:
- cmd = match.group(1)
- # Check if Enter follows (possibly with Sleep in between)
- j = i + 1
- while j < len(lines):
- next_line = lines[j].strip()
- if not next_line:
- j += 1
- continue
- if next_line.startswith("Sleep "):
- j += 1
- continue
- if next_line == "Enter":
- # Only include commands with specified prefixes
- if any(cmd.startswith(prefix) for prefix in command_prefixes):
- commands.append(cmd)
- break
- i += 1
+ pending_command = match.group(1)
+ continue
+
+ if line == "Enter":
+ if (
+ in_visible_section
+ and pending_command
+ and any(
+ pending_command.startswith(prefix) for prefix in command_prefixes
+ )
+ ):
+ commands.append(pending_command)
+ pending_command = None
+ continue
+
+ if line and not line.startswith(("#", "Sleep ")):
+ # Interactive editing or completion means the literal Type text is
+ # not the command that Enter will execute. Snapshot mode cannot
+ # replay those terminal interactions faithfully.
+ pending_command = None
return commands
@@ -1342,6 +1346,7 @@ class DemoSize:
# Predefined sizes for different contexts
SIZE_SOCIAL = DemoSize(width=1200, height=700, fontsize=26) # Big text for mobile
SIZE_DOCS = DemoSize(width=1600, height=900, fontsize=24) # More content for docs
+SIZE_DOCS_MOBILE = DemoSize(width=576, height=432, fontsize=20)
def build_tape_replacements(demo_env: DemoEnv, repo_root: Path) -> dict:
@@ -1380,7 +1385,7 @@ def record_theme(
"""Record one demo GIF in a prepared environment.
Args:
- demo_env: Demo environment with repo and home paths
+ demo_env: Prepared demo environment for this theme
tape_template: Path to the .tape template file
theme_name: Name of the VHS theme to use
output_gif: Output GIF path
diff --git a/docs/demos/shared/themes.py b/docs/demos/shared/themes.py
index ad0978b6c..9cf3ed9b1 100644
--- a/docs/demos/shared/themes.py
+++ b/docs/demos/shared/themes.py
@@ -1,13 +1,12 @@
-"""VHS theme definitions matching the doc site color palette.
+"""VHS themes coordinated with the documentation site's color palette.
-These themes are designed to match the CSS variables in docs/templates/_variables.html
-so demos integrate seamlessly with light/dark mode switching.
+The base surfaces and accents follow ``docs/src/styles/custom.css``. ANSI hues
+are tuned separately for legible terminal captures in each theme.
"""
import json
-# Light theme - matches the "Warm Workbench" light mode
-# Terminal colors from docs/templates/_variables.html (light mode)
+# Light theme — based on the default ``--wt-*`` palette in custom.css.
LIGHT_THEME = {
"name": "Warm Gold Light",
"black": "#6b7280", # --bright-black
@@ -26,18 +25,13 @@ LIGHT_THEME = {
"brightMagenta": "#a855f7",
"brightCyan": "#5a9e9e",
"brightWhite": "#8c959f",
- "background": "#FFFBF0",
- "foreground": "#1f2328",
- "cursor": "#d97706",
- "selection": "#FFF0C8",
+ "background": "#f7f3eb", # --wt-paper
+ "foreground": "#27231f", # --wt-ink
+ "cursor": "#d85d22", # --wt-orange
+ "selection": "#f7d6c1", # --sl-color-accent-low
}
-# Dark theme - matches the "Warm Workbench" dark mode from _variables.html
-# Colors derived from the CSS custom properties in dark mode:
-# --wt-color-bg: #1c1b1a
-# --wt-color-text: #e8e6e3
-# --wt-color-accent: #f59e0b
-# Terminal colors: --cyan: #67d4d4, --green: #4ade80, --red: #f87171, etc.
+# Dark theme — based on the ``data-theme='dark'`` palette in custom.css.
DARK_THEME = {
"name": "Warm Workbench Dark",
"black": "#6b7280", # --bright-black from CSS
@@ -47,7 +41,7 @@ DARK_THEME = {
"blue": "#60a5fa", # --blue dark mode
"magenta": "#c084fc", # --magenta dark mode
"cyan": "#67d4d4", # --cyan dark mode
- "white": "#a8a29e", # --wt-color-text-muted
+ "white": "#a8a29e",
"brightBlack": "#6b7280", # same as black
"brightRed": "#fca5a5", # lighter red
"brightGreen": "#86efac", # lighter green
@@ -55,11 +49,11 @@ DARK_THEME = {
"brightBlue": "#93c5fd", # lighter blue
"brightMagenta": "#d8b4fe", # lighter magenta
"brightCyan": "#a5f3fc", # lighter cyan
- "brightWhite": "#e8e6e3", # --wt-color-text
- "background": "#1c1b1a", # --wt-color-bg dark mode
- "foreground": "#e8e6e3", # --wt-color-text dark mode
- "cursor": "#f59e0b", # --wt-color-accent dark mode
- "selection": "#422006", # --wt-color-accent-soft dark mode
+ "brightWhite": "#eee8de", # --wt-ink
+ "background": "#1d1a18", # --wt-paper
+ "foreground": "#eee8de", # --wt-ink
+ "cursor": "#ef8a50", # --wt-orange
+ "selection": "#49200f", # --sl-color-accent-low
}
THEMES = {
diff --git a/docs/demos/tapes/shared-commands.tape b/docs/demos/tapes/shared-commands.tape
index dd1012343..fd16a6fcb 100644
--- a/docs/demos/tapes/shared-commands.tape
+++ b/docs/demos/tapes/shared-commands.tape
@@ -1,4 +1,9 @@
# Common requirements and environment - Source after Output
+#
+# Hide must be the first executable directive. VHS only runs pre-roll before
+# starting its recorder when the first non-Set/Output/Require directive is Hide.
+Hide
+
Require wt
Require git
@@ -12,7 +17,6 @@ Env HOME "{{DEMO_HOME}}"
Env XDG_CONFIG_HOME "{{DEMO_HOME}}/.config"
Env STARSHIP_CONFIG "{{STARSHIP_CONFIG}}"
-Hide
Type "set -g fish_autosuggestion_enabled 0"
Enter
Type "source $HOME/.config/fish/colors.fish"
diff --git a/docs/demos/tapes/wt-commit.tape b/docs/demos/tapes/wt-commit.tape
index 09f5f2947..b14faf815 100644
--- a/docs/demos/tapes/wt-commit.tape
+++ b/docs/demos/tapes/wt-commit.tape
@@ -7,11 +7,11 @@ Source docs/demos/tapes/shared-commands.tape
Type "clear"
Enter
Sleep 1s
-Show
-Sleep 500ms
# Switch to branch with uncommitted changes
Type "wt switch hooks"
+Show
+Sleep 300ms
Enter
Sleep 1s
@@ -30,6 +30,6 @@ Type "git log -1"
Enter
Sleep 3s
+Hide
Type "exit"
Enter
-Sleep 500ms
diff --git a/docs/demos/tapes/wt-core-mobile.tape b/docs/demos/tapes/wt-core-mobile.tape
new file mode 100644
index 000000000..73ec1029c
--- /dev/null
+++ b/docs/demos/tapes/wt-core-mobile.tape
@@ -0,0 +1,35 @@
+Source docs/demos/tapes/shared-setup.tape
+
+Output "{{OUTPUT_GIF}}"
+
+Source docs/demos/tapes/shared-commands.tape
+
+Type "clear"
+Enter
+
+# Start with a complete command in the first recorded frame.
+Type "wt list"
+Show
+Sleep 300ms
+Enter
+Sleep 2.5s
+
+# Move into existing work, create fresh work, then confirm the result.
+Type "wt switch alpha"
+Enter
+Sleep 1.5s
+
+Type "wt switch --create api"
+Enter
+Sleep 2.5s
+
+Type "wt list"
+Enter
+Sleep 2.5s
+
+# Finish on Worktrunk's safe cleanup workflow.
+Type "wt remove"
+Enter
+Sleep 3.5s
+
+Hide
diff --git a/docs/demos/tapes/wt-core.tape b/docs/demos/tapes/wt-core.tape
index b21bd876c..6a71e7154 100644
--- a/docs/demos/tapes/wt-core.tape
+++ b/docs/demos/tapes/wt-core.tape
@@ -7,11 +7,11 @@ Source docs/demos/tapes/shared-commands.tape
Type "clear"
Enter
Sleep 1s
-Show
-Sleep 500ms
# 1. Show current worktrees
Type "wt list"
+Show
+Sleep 300ms
Enter
Sleep 2s
@@ -51,6 +51,6 @@ Type "wt remove"
Enter
Sleep 5s
+Hide
Type "exit"
Enter
-Sleep 500ms
diff --git a/docs/demos/tapes/wt-list.tape b/docs/demos/tapes/wt-list.tape
index 71d1cd075..316dd4104 100644
--- a/docs/demos/tapes/wt-list.tape
+++ b/docs/demos/tapes/wt-list.tape
@@ -7,11 +7,11 @@ Source docs/demos/tapes/shared-commands.tape
Type "clear"
Enter
Sleep 1s
-Show
-Sleep 500ms
# Basic list - progressive rendering
Type "wt list"
+Show
+Sleep 300ms
Enter
Sleep 2.5s
@@ -25,6 +25,6 @@ Type "wt list --branches"
Enter
Sleep 2.5s
+Hide
Type "exit"
Enter
-Sleep 500ms
diff --git a/docs/demos/tapes/wt-merge.tape b/docs/demos/tapes/wt-merge.tape
index 2687eb8de..35c1a5c0c 100644
--- a/docs/demos/tapes/wt-merge.tape
+++ b/docs/demos/tapes/wt-merge.tape
@@ -11,10 +11,10 @@ Env NEXTEST_NO_FAIL_FAST "1"
Type "clear"
Enter
Sleep 1s
-Show
-Sleep 500ms
Type "wt list"
+Show
+Sleep 300ms
Enter
Sleep 1.6s
@@ -37,6 +37,6 @@ Enter
Sleep 1.5s
Sleep 4.5s
+Hide
Type "exit"
Enter
-Sleep 700ms
diff --git a/docs/demos/tapes/wt-statusline.tape b/docs/demos/tapes/wt-statusline.tape
index d419f9c2e..b5cb9aa8c 100644
--- a/docs/demos/tapes/wt-statusline.tape
+++ b/docs/demos/tapes/wt-statusline.tape
@@ -10,11 +10,11 @@ Env CLAUDE_CODE_OAUTH_TOKEN "{{CLAUDE_CODE_OAUTH_TOKEN}}"
Type "clear"
Enter
Sleep 1s
-Show
-Sleep 500ms
# Switch to alpha worktree first (has uncommitted changes for diff stats)
Type "wt switch alpha"
+Show
+Sleep 300ms
Enter
Sleep 1.5s
@@ -26,3 +26,5 @@ Sleep 1s
Type "claude"
Enter
Sleep 8s
+
+Hide
diff --git a/docs/demos/tapes/wt-switch-picker.tape b/docs/demos/tapes/wt-switch-picker.tape
index 903e0a8ea..15a332e74 100644
--- a/docs/demos/tapes/wt-switch-picker.tape
+++ b/docs/demos/tapes/wt-switch-picker.tape
@@ -7,12 +7,12 @@ Source docs/demos/tapes/shared-commands.tape
Type "clear"
Enter
Sleep 1s
-Show
Set KeyStrokes Show
-Sleep 500ms
# Launch interactive picker (wt switch without args)
Type "wt switch"
+Show
+Sleep 300ms
Enter
Sleep 1.5s
@@ -38,6 +38,6 @@ Sleep 1s
Enter
Sleep 1.5s
+Hide
Type "exit"
Enter
-Sleep 500ms
diff --git a/docs/demos/tapes/wt-switch.tape b/docs/demos/tapes/wt-switch.tape
index ff3f60c7c..0f9327845 100644
--- a/docs/demos/tapes/wt-switch.tape
+++ b/docs/demos/tapes/wt-switch.tape
@@ -10,11 +10,11 @@ Env CLAUDE_CODE_OAUTH_TOKEN "{{CLAUDE_CODE_OAUTH_TOKEN}}"
Type "clear"
Enter
Sleep 1s
-Show
-Sleep 500ms
# Switch to existing worktree
Type "wt switch alpha"
+Show
+Sleep 300ms
Enter
Sleep 1.5s
@@ -28,3 +28,5 @@ Type "wt switch --execute claude --create dashboard -- 'Add settings page'"
Sleep 500ms
Enter
Sleep 6s
+
+Hide
diff --git a/docs/demos/tapes/wt-zellij-omnibus.tape b/docs/demos/tapes/wt-zellij-omnibus.tape
index cf4229a23..54c562905 100644
--- a/docs/demos/tapes/wt-zellij-omnibus.tape
+++ b/docs/demos/tapes/wt-zellij-omnibus.tape
@@ -49,12 +49,12 @@ Sleep 500ms
Type "clear"
Enter
Sleep 500ms
-Show
-Sleep 500ms
# ==== TAB 1: Interactive picker and Claude agent ====
# wt switch (no args) - opens interactive picker
Type "wt switch"
+Show
+Sleep 300ms
Enter
Sleep 1.5s
diff --git a/docs/demos/tests/test_recording.py b/docs/demos/tests/test_recording.py
new file mode 100644
index 000000000..8d8005052
--- /dev/null
+++ b/docs/demos/tests/test_recording.py
@@ -0,0 +1,141 @@
+import runpy
+import sys
+from pathlib import Path
+
+DEMOS_DIR = Path(__file__).parents[1]
+REPO_ROOT = DEMOS_DIR.parents[1]
+sys.path.insert(0, str(DEMOS_DIR))
+
+from shared import ( # noqa: E402
+ DemoSize,
+ extract_commands_from_tape,
+ render_tape,
+)
+
+
+def test_each_theme_records_from_a_fresh_environment(tmp_path: Path) -> None:
+ build = runpy.run_path(str(DEMOS_DIR / "build"))
+ fake_vhs = tmp_path / "fake-vhs"
+ fake_vhs.write_text(
+ """#!/usr/bin/env python3
+import re
+import sys
+from pathlib import Path
+
+tape = Path(sys.argv[1]).read_text()
+output = Path(re.search(r'^Output "([^"]+)"', tape, re.MULTILINE).group(1))
+output.parent.mkdir(parents=True, exist_ok=True)
+output.write_bytes(b'GIF89a')
+Path(f'{output}.tape').write_text(tape)
+"""
+ )
+ fake_vhs.chmod(0o755)
+
+ tape = tmp_path / "demo.tape"
+ tape.write_text(
+ """Set Width {{WIDTH}}
+Set Height {{HEIGHT}}
+Set FontSize {{FONTSIZE}}
+Set Theme {{THEME}}
+Output "{{OUTPUT_GIF}}"
+Env HOME "{{DEMO_HOME}}"
+"""
+ )
+ output_gifs = {
+ theme: tmp_path / theme / "recording.gif" for theme in ("light", "dark")
+ }
+ environments: list[Path] = []
+
+ def setup_environment(environment) -> None:
+ environments.append(environment.home.resolve())
+
+ build["record_demo"].__globals__["TAPES_DIR"] = tmp_path
+ build["record_demo"](
+ tape.name,
+ "recording",
+ setup_environment,
+ tmp_path,
+ list(output_gifs),
+ DemoSize(width=1600, height=900, fontsize=24),
+ vhs_binary=str(fake_vhs),
+ )
+
+ assert len(environments) == 2
+ light_tape = Path(f"{output_gifs['light']}.tape").read_text()
+ dark_tape = Path(f"{output_gifs['dark']}.tape").read_text()
+ assert str(environments[0]) in light_tape
+ assert str(environments[1]) not in light_tape
+ assert str(environments[1]) in dark_tape
+ assert str(environments[0]) not in dark_tape
+
+
+def test_docs_demos_open_on_a_complete_command_before_execution() -> None:
+ build = runpy.run_path(str(DEMOS_DIR / "build"))
+ first_commands = {
+ "wt-core.tape": "wt list",
+ "wt-core-mobile.tape": "wt list",
+ "wt-switch.tape": "wt switch alpha",
+ "wt-list.tape": "wt list",
+ "wt-commit.tape": "wt switch hooks",
+ "wt-statusline.tape": "wt switch alpha",
+ "wt-merge.tape": "wt list",
+ "wt-switch-picker.tape": "wt switch",
+ "wt-zellij-omnibus.tape": "wt switch",
+ }
+
+ assert {tape for tape, _, _ in build["DOCS_DEMOS"]} == set(first_commands)
+ for tape_file, expected_command in first_commands.items():
+ tape = DEMOS_DIR / "tapes" / tape_file
+ lines = [
+ line.strip()
+ for line in tape.read_text().splitlines()
+ if line.strip() and not line.lstrip().startswith("#")
+ ]
+ show = lines.index("Show")
+ assert lines[show - 1] == f'Type "{expected_command}"', tape_file
+ assert lines[show + 1 : show + 3] == ["Sleep 300ms", "Enter"], tape_file
+
+ if tape_file not in build["TUI_DEMOS"]:
+ commands = extract_commands_from_tape(tape, REPO_ROOT)
+ assert commands[0] == expected_command, tape_file
+ assert "wt switch b" not in commands, tape_file
+
+
+def test_docs_demos_hide_all_setup_and_cleanup_from_the_recording() -> None:
+ """VHS pre-roll only works when Hide is the first executable directive."""
+ build = runpy.run_path(str(DEMOS_DIR / "build"))
+ inert_directives = ("Set ", "Output ", "Require ")
+
+ for tape_file, _, _ in build["DOCS_DEMOS"]:
+ rendered = render_tape(DEMOS_DIR / "tapes" / tape_file, {}, REPO_ROOT)
+ assert rendered is not None
+ lines = [
+ line.strip()
+ for line in rendered.splitlines()
+ if line.strip() and not line.lstrip().startswith("#")
+ ]
+ first_executable = next(
+ line for line in lines if not line.startswith(inert_directives)
+ )
+ assert first_executable == "Hide", tape_file
+
+ show = lines.index("Show")
+ final_hide = len(lines) - 1 - lines[::-1].index("Hide")
+ assert final_hide > show, tape_file
+
+
+def test_mobile_core_demo_has_a_readable_dedicated_recording_contract() -> None:
+ build = runpy.run_path(str(DEMOS_DIR / "build"))
+ mobile_size = build["TARGETS"]["docs"]["sizes"]["wt-core-mobile"]
+ assert mobile_size == DemoSize(width=576, height=432, fontsize=20)
+
+ tape = DEMOS_DIR / "tapes" / "wt-core-mobile.tape"
+ commands = extract_commands_from_tape(tape, REPO_ROOT)
+ assert commands == [
+ "wt list",
+ "wt switch alpha",
+ "wt switch --create api",
+ "wt list",
+ "wt remove",
+ ]
+ assert all(len(command) <= 24 for command in commands)
diff --git a/docs/package-lock.json b/docs/package-lock.json
new file mode 100644
index 000000000..9a0636126
--- /dev/null
+++ b/docs/package-lock.json
@@ -0,0 +1,8246 @@
+{
+ "name": "worktrunk-docs",
+ "lockfileVersion": 3,
+ "requires": true,
+ "packages": {
+ "": {
+ "name": "worktrunk-docs",
+ "dependencies": {
+ "@astrojs/markdown-remark": "^7.2.4",
+ "@astrojs/sitemap": "^3.7.3",
+ "@astrojs/starlight": "^0.41.7",
+ "@expressive-code/core": "^0.44.1",
+ "astro": "^7.2.4"
+ },
+ "devDependencies": {
+ "@astrojs/check": "^0.9.10",
+ "playwright": "^1.62.1",
+ "typescript": "^6.0.3"
+ }
+ },
+ "node_modules/@astrojs/check": {
+ "version": "0.9.10",
+ "resolved": "https://registry.npmjs.org/@astrojs/check/-/check-0.9.10.tgz",
+ "integrity": "sha512-zgx/UQMozdjOa3bOxjgeCFdtpE3c9rRX6xHwa+2QXvy8z8Akifu2AtubHyv/zzC2znO8dl8fFWL4K+Ba9kS8HQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@astrojs/language-server": "^2.16.7",
+ "chokidar": "^4.0.3",
+ "kleur": "^4.1.5",
+ "yargs": "^18.0.0"
+ },
+ "bin": {
+ "astro-check": "bin/astro-check.js"
+ },
+ "peerDependencies": {
+ "typescript": "^5.0.0 || ^6.0.0"
+ }
+ },
+ "node_modules/@astrojs/compiler": {
+ "version": "2.13.1",
+ "resolved": "https://registry.npmjs.org/@astrojs/compiler/-/compiler-2.13.1.tgz",
+ "integrity": "sha512-f3FN83d2G/v32ipNClRKgYv30onQlMZX1vCeZMjPsMMPl1mDpmbl0+N5BYo4S/ofzqJyS5hvwacEo0CCVDn/Qg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@astrojs/compiler-binding": {
+ "version": "0.3.2",
+ "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding/-/compiler-binding-0.3.2.tgz",
+ "integrity": "sha512-8w/9CWmYrAJJ8N0SY3O43ws2BgxoW6u3QsD8u2mE140lMYAlwh+tlNoUeSBq22wVheFuiBbR212l6ixZ2IIgCQ==",
+ "license": "MIT",
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ },
+ "optionalDependencies": {
+ "@astrojs/compiler-binding-darwin-arm64": "0.3.2",
+ "@astrojs/compiler-binding-darwin-x64": "0.3.2",
+ "@astrojs/compiler-binding-linux-arm64-gnu": "0.3.2",
+ "@astrojs/compiler-binding-linux-arm64-musl": "0.3.2",
+ "@astrojs/compiler-binding-linux-x64-gnu": "0.3.2",
+ "@astrojs/compiler-binding-linux-x64-musl": "0.3.2",
+ "@astrojs/compiler-binding-wasm32-wasi": "0.3.2",
+ "@astrojs/compiler-binding-win32-arm64-msvc": "0.3.2",
+ "@astrojs/compiler-binding-win32-x64-msvc": "0.3.2"
+ }
+ },
+ "node_modules/@astrojs/compiler-binding-darwin-arm64": {
+ "version": "0.3.2",
+ "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-darwin-arm64/-/compiler-binding-darwin-arm64-0.3.2.tgz",
+ "integrity": "sha512-MM8tn8CSimcfytaOla4b6acN8mKWiL/rlAA1fpT3/Wl7dNGSE4y8FjTN/zJVNnb63CsLWG5zZwCt01TXtDKh9g==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@astrojs/compiler-binding-darwin-x64": {
+ "version": "0.3.2",
+ "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-darwin-x64/-/compiler-binding-darwin-x64-0.3.2.tgz",
+ "integrity": "sha512-2lXOlzf8xb7jLomRsf/aswh61/NnGusynB2OwFkK6k4pmOtpfXMYnG0PLfXrEvxXYj69NdCnmUYXtHDd+JOOag==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@astrojs/compiler-binding-linux-arm64-gnu": {
+ "version": "0.3.2",
+ "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-linux-arm64-gnu/-/compiler-binding-linux-arm64-gnu-0.3.2.tgz",
+ "integrity": "sha512-BmU3kWj7qnLrd4vzm49zFEPJ5oFnn1tCT4Vt9hZbqdU5Cmb8GZl7fn6VFsnNfe7B18a2gIFtVzbLINtYl5kBjQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@astrojs/compiler-binding-linux-arm64-musl": {
+ "version": "0.3.2",
+ "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-linux-arm64-musl/-/compiler-binding-linux-arm64-musl-0.3.2.tgz",
+ "integrity": "sha512-f0heT9ZZEseSu5bHCeb80eL2DH07ArE6U9xi1WT/PEusNjzPmEr3GJsjG1tRLo5VYUUYX7h3ScaqGmGrMOVGmw==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@astrojs/compiler-binding-linux-x64-gnu": {
+ "version": "0.3.2",
+ "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-linux-x64-gnu/-/compiler-binding-linux-x64-gnu-0.3.2.tgz",
+ "integrity": "sha512-M8fOUt0itRpqiGyoEA/ij184s8O+hqbCz3+YozRusOOM3osgGljpDThhbKAJjqh82wOo6FioQ4w8PBvU1XMD5Q==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@astrojs/compiler-binding-linux-x64-musl": {
+ "version": "0.3.2",
+ "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-linux-x64-musl/-/compiler-binding-linux-x64-musl-0.3.2.tgz",
+ "integrity": "sha512-/Kebk8sO6HnLeSd691JkaAPfN7CqR9/KEXmWvyNPkaKNGmj8rTZ/lf2uXtnPu92Lan84UrKdIKVPy1fSo2encQ==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@astrojs/compiler-binding-wasm32-wasi": {
+ "version": "0.3.2",
+ "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-wasm32-wasi/-/compiler-binding-wasm32-wasi-0.3.2.tgz",
+ "integrity": "sha512-pUA6xbcOSB7DhfzIArB8BCAkFfAIqriiR7zl5zOStd6oU2G0kIKj+GUdGnyXyhfiv881Hffyk5tC0mR18sDjDw==",
+ "cpu": [
+ "wasm32"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "@napi-rs/wasm-runtime": "^1.2.0"
+ },
+ "engines": {
+ "node": ">=14.0.0"
+ }
+ },
+ "node_modules/@astrojs/compiler-binding-win32-arm64-msvc": {
+ "version": "0.3.2",
+ "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-win32-arm64-msvc/-/compiler-binding-win32-arm64-msvc-0.3.2.tgz",
+ "integrity": "sha512-ESruf+6Qkl1trHUFxI6GSf6t52j8yN2kCNSzMWdzt7V/T09tFHrYzrVaJQohb2C9bJUH76pNvX6Zb51+xCQc9Q==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@astrojs/compiler-binding-win32-x64-msvc": {
+ "version": "0.3.2",
+ "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-win32-x64-msvc/-/compiler-binding-win32-x64-msvc-0.3.2.tgz",
+ "integrity": "sha512-wzzVrEbOwbsLWOdEbocskjMRx2aZPxJ7ZbmL+jnpBamFwmigm+2M/wzuM6JWncocgYwLic1csSpalBh96kQKXA==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@astrojs/compiler-rs": {
+ "version": "0.3.2",
+ "resolved": "https://registry.npmjs.org/@astrojs/compiler-rs/-/compiler-rs-0.3.2.tgz",
+ "integrity": "sha512-xlx/T7JovIKduu4ucbTQUxQ5+Q8wxkHxhLjnZk3VlJbhbQ9RLvvuDk1p2YYFYFQ5y14dVm3FGGO4isQXa4F+Tg==",
+ "license": "MIT",
+ "dependencies": {
+ "@astrojs/compiler-binding": "0.3.2"
+ },
+ "engines": {
+ "node": ">=22.12.0"
+ }
+ },
+ "node_modules/@astrojs/internal-helpers": {
+ "version": "0.10.4",
+ "resolved": "https://registry.npmjs.org/@astrojs/internal-helpers/-/internal-helpers-0.10.4.tgz",
+ "integrity": "sha512-nozZSy/mKYLqe4YrqbKtdOszedAfXYCtw3wZ0d+CAjz4GqQ4L9rl1ltIL5BlgwmYVinJg/RZ0MgGuWOdlyRZlA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.4",
+ "@types/mdast": "^4.0.4",
+ "js-yaml": "^4.3.0",
+ "picomatch": "^4.0.4",
+ "retext-smartypants": "^6.2.0",
+ "shiki": "^4.0.2",
+ "smol-toml": "^1.6.0",
+ "unified": "^11.0.5"
+ }
+ },
+ "node_modules/@astrojs/language-server": {
+ "version": "2.16.14",
+ "resolved": "https://registry.npmjs.org/@astrojs/language-server/-/language-server-2.16.14.tgz",
+ "integrity": "sha512-YPXkBu6N4d1sT09pvBmIDGZay+1MemV551FSgdEM3aZRDzbkxd2H7Cvf8MsVJLVB1mIEyTf1XbMN/30gp7s46w==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@astrojs/compiler": "^2.13.1",
+ "@astrojs/yaml2ts": "^0.2.4",
+ "@jridgewell/sourcemap-codec": "^1.5.5",
+ "@volar/kit": "~2.4.28",
+ "@volar/language-core": "~2.4.28",
+ "@volar/language-server": "~2.4.28",
+ "@volar/language-service": "~2.4.28",
+ "muggle-string": "^0.4.1",
+ "tinyglobby": "^0.2.16",
+ "volar-service-css": "0.0.71",
+ "volar-service-emmet": "0.0.71",
+ "volar-service-html": "0.0.71",
+ "volar-service-prettier": "0.0.71",
+ "volar-service-typescript": "0.0.71",
+ "volar-service-typescript-twoslash-queries": "0.0.71",
+ "volar-service-yaml": "0.0.71",
+ "vscode-html-languageservice": "^5.6.2",
+ "vscode-uri": "^3.1.0"
+ },
+ "bin": {
+ "astro-ls": "bin/nodeServer.js"
+ },
+ "peerDependencies": {
+ "prettier": "^3.0.0",
+ "prettier-plugin-astro": ">=0.11.0"
+ },
+ "peerDependenciesMeta": {
+ "prettier": {
+ "optional": true
+ },
+ "prettier-plugin-astro": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/@astrojs/markdown-remark": {
+ "version": "7.2.4",
+ "resolved": "https://registry.npmjs.org/@astrojs/markdown-remark/-/markdown-remark-7.2.4.tgz",
+ "integrity": "sha512-MvspGMynWKAjTe4/lTUdmBPHIFKNVLTCF6UlyWGogTGzNrTvjD+D4n48k7h8swxsEPKHK2TwxkZO7uoaCv1Pow==",
+ "license": "MIT",
+ "dependencies": {
+ "@astrojs/internal-helpers": "0.10.4",
+ "@astrojs/prism": "4.0.2",
+ "github-slugger": "^2.0.0",
+ "hast-util-from-html": "^2.0.3",
+ "hast-util-to-text": "^4.0.2",
+ "mdast-util-definitions": "^6.0.0",
+ "rehype-raw": "^7.0.0",
+ "rehype-stringify": "^10.0.1",
+ "remark-gfm": "^4.0.1",
+ "remark-parse": "^11.0.0",
+ "remark-rehype": "^11.1.2",
+ "remark-smartypants": "^3.0.2",
+ "unified": "^11.0.5",
+ "unist-util-remove-position": "^5.0.0",
+ "unist-util-visit": "^5.1.0",
+ "unist-util-visit-parents": "^6.0.2",
+ "vfile": "^6.0.3"
+ }
+ },
+ "node_modules/@astrojs/markdown-satteri": {
+ "version": "0.3.7",
+ "resolved": "https://registry.npmjs.org/@astrojs/markdown-satteri/-/markdown-satteri-0.3.7.tgz",
+ "integrity": "sha512-NHcHbrKW/opbZnTZQ5nH293BdcK2VV0tjuzI88CLnvy2njiEJVwUQ5KFnYd4NoWgHJCY/I1CyjGWCR4Vv3khXQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@astrojs/internal-helpers": "0.10.4",
+ "@astrojs/prism": "4.0.2",
+ "github-slugger": "^2.0.0",
+ "satteri": "^0.10.3"
+ }
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/@bruits/satteri-darwin-arm64": {
+ "version": "0.10.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-darwin-arm64/-/satteri-darwin-arm64-0.10.5.tgz",
+ "integrity": "sha512-27KTVl4TJkVahMy/ohyA7qd4938G5UNneFUz/PsScYfpIhj0IVAS23mpcJXdPF44sa6nva198lmV/cKIb2YPyA==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ]
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/@bruits/satteri-darwin-x64": {
+ "version": "0.10.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-darwin-x64/-/satteri-darwin-x64-0.10.5.tgz",
+ "integrity": "sha512-IjnLe3nKspq6qaeqGgjT7MT8VrTV74yWRlaag7ZdNsI8TDAYZ0iPxMCo+9KQZHUk5EyVB+reBI/PFWL5KuFw9Q==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ]
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/@bruits/satteri-linux-arm64-gnu": {
+ "version": "0.10.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-linux-arm64-gnu/-/satteri-linux-arm64-gnu-0.10.5.tgz",
+ "integrity": "sha512-glkYXZCJywjP13v67eAyAMSJdF+ncvEbYvgi/wOtffL9tQ27lr/zsyzUfgs+ovjJ9d8JNQKiXeiArJcX8PJL9w==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/@bruits/satteri-linux-arm64-musl": {
+ "version": "0.10.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-linux-arm64-musl/-/satteri-linux-arm64-musl-0.10.5.tgz",
+ "integrity": "sha512-yWdgG1g17Nh2QyGVlFUxGRa3FEFwiMcpZEyMNWkbM3deC94cmVc+/i9OuyFpdKuWo3GkgoCtYVOoxk1uCnCZIA==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/@bruits/satteri-linux-x64-gnu": {
+ "version": "0.10.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-linux-x64-gnu/-/satteri-linux-x64-gnu-0.10.5.tgz",
+ "integrity": "sha512-FVaLoPT1fBgGl0J+AYebyyXJYBachGl8Oyyrf1lye4RTqCB4S0Gwkj1uM9RJyThUOvx5VUmAT1CnNh1SFHA+kw==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/@bruits/satteri-linux-x64-musl": {
+ "version": "0.10.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-linux-x64-musl/-/satteri-linux-x64-musl-0.10.5.tgz",
+ "integrity": "sha512-EHpVAx2bqW3GINHTKkljtxVfQmVDGWIuwOYOP5YghTj+0PkBa2o8oKPRtQ9Kbsr1Fye8jtUcDjhwj2jMNugZKg==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/@bruits/satteri-wasm32-wasi": {
+ "version": "0.10.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-wasm32-wasi/-/satteri-wasm32-wasi-0.10.5.tgz",
+ "integrity": "sha512-ypz8c/Zmipxp4IoeDa228Gstv6TLzVmNs3yC6wKCoNSOjx1iwpgzu87Y3hTkXFdwChVGU85qeUDuOIarGUZQLw==",
+ "cpu": [
+ "wasm32"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "@emnapi/core": "1.11.1",
+ "@emnapi/runtime": "1.11.1",
+ "@napi-rs/wasm-runtime": "^1.2.3"
+ },
+ "engines": {
+ "node": ">=14.0.0"
+ }
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/@bruits/satteri-win32-arm64-msvc": {
+ "version": "0.10.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-win32-arm64-msvc/-/satteri-win32-arm64-msvc-0.10.5.tgz",
+ "integrity": "sha512-siTV88nb0LRqNpkL2gXboqCwVdq95sLtzMHS1/3eONV2gLbB3NAK46wmSMvCO/yquBvI2lvaFIfd8P12ecsxBw==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/@bruits/satteri-win32-x64-msvc": {
+ "version": "0.10.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-win32-x64-msvc/-/satteri-win32-x64-msvc-0.10.5.tgz",
+ "integrity": "sha512-C3IfPvfvMXmlzBxaMPKFS1XiuV9pu2mC7YqkPk7PSvTgPZ8gbdASIpHpztDLvTTQjqZ0z1Ol8tK5X+V6XXC0wQ==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/@emnapi/core": {
+ "version": "1.11.1",
+ "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.11.1.tgz",
+ "integrity": "sha512-RSvbQmHzdKzNsLYa/wHrbc3KN4sYLKAdPZxqiM2HATqv/SBk2/ENSHpvXGaLOMcsAyz0poEGqkmmKYG3OWiJEQ==",
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "@emnapi/wasi-threads": "1.2.2",
+ "tslib": "^2.4.0"
+ }
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/@emnapi/runtime": {
+ "version": "1.11.1",
+ "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.11.1.tgz",
+ "integrity": "sha512-vgj7R3y3Wgx24IQaGPA/R6YFXLHVMOZ0uVEyIQPaWs+rd1AzfEMXlAC22FYwO1XkKR6NPsq7mUandH8oIRdZFw==",
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "tslib": "^2.4.0"
+ }
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/@emnapi/wasi-threads": {
+ "version": "1.2.2",
+ "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.2.2.tgz",
+ "integrity": "sha512-c95qOXkHdydNKhscBTebqEC1CVAZpyqOfVfBzQ1qgzyl3gfeldUjIggDbIZgDKsHLgnsM+igH7TJ/eAasaVuMA==",
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "tslib": "^2.4.0"
+ }
+ },
+ "node_modules/@astrojs/markdown-satteri/node_modules/satteri": {
+ "version": "0.10.5",
+ "resolved": "https://registry.npmjs.org/satteri/-/satteri-0.10.5.tgz",
+ "integrity": "sha512-Ao1LKpAEa9Wdg0otgbVKViZHEq9ebdXe4DMrp3s9vQAU0HNIuHnFEuMuOcm0ZIXyV0Yzxj91NvhLpvXZJO/5ZQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree-jsx": "^1.0.5",
+ "@types/hast": "^3.0.5",
+ "@types/mdast": "^4.0.4",
+ "@types/unist": "^3.0.3"
+ },
+ "optionalDependencies": {
+ "@bruits/satteri-darwin-arm64": "0.10.5",
+ "@bruits/satteri-darwin-x64": "0.10.5",
+ "@bruits/satteri-linux-arm64-gnu": "0.10.5",
+ "@bruits/satteri-linux-arm64-musl": "0.10.5",
+ "@bruits/satteri-linux-x64-gnu": "0.10.5",
+ "@bruits/satteri-linux-x64-musl": "0.10.5",
+ "@bruits/satteri-wasm32-wasi": "0.10.5",
+ "@bruits/satteri-win32-arm64-msvc": "0.10.5",
+ "@bruits/satteri-win32-x64-msvc": "0.10.5"
+ }
+ },
+ "node_modules/@astrojs/mdx": {
+ "version": "7.0.7",
+ "resolved": "https://registry.npmjs.org/@astrojs/mdx/-/mdx-7.0.7.tgz",
+ "integrity": "sha512-hv+NJh2s+/KDrjXaYNOaS344e3M2ekMXHBR7x9EwBwE3VvE1y/9Ifh1rhR1H2zK2sMgXoUnakI9e9ZeCKPX9/Q==",
+ "license": "MIT",
+ "dependencies": {
+ "@astrojs/internal-helpers": "0.10.4",
+ "@astrojs/markdown-remark": "7.2.4",
+ "@mdx-js/mdx": "^3.1.1",
+ "acorn": "^8.16.0",
+ "es-module-lexer": "^2.0.0",
+ "estree-util-visit": "^2.0.0",
+ "hast-util-to-html": "^9.0.5",
+ "piccolore": "^0.1.3",
+ "rehype-raw": "^7.0.0",
+ "remark-gfm": "^4.0.1",
+ "remark-smartypants": "^3.0.2",
+ "source-map": "^0.7.6",
+ "unist-util-visit": "^5.1.0",
+ "vfile": "^6.0.3"
+ },
+ "engines": {
+ "node": ">=22.12.0"
+ },
+ "peerDependencies": {
+ "@astrojs/markdown-satteri": "^0.3.1",
+ "astro": "^7.0.0"
+ },
+ "peerDependenciesMeta": {
+ "@astrojs/markdown-satteri": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/@astrojs/prism": {
+ "version": "4.0.2",
+ "resolved": "https://registry.npmjs.org/@astrojs/prism/-/prism-4.0.2.tgz",
+ "integrity": "sha512-KTivpmnz6lDsC6o9H4+DNm2SrE/GHzw8cNAvEJwAvUT+eoaEnn/4NtbDNfRRaxaJHdp15gf+tfHAWiXR4wB3BA==",
+ "license": "MIT",
+ "dependencies": {
+ "prismjs": "^1.30.0"
+ },
+ "engines": {
+ "node": ">=22.12.0"
+ }
+ },
+ "node_modules/@astrojs/sitemap": {
+ "version": "3.7.3",
+ "resolved": "https://registry.npmjs.org/@astrojs/sitemap/-/sitemap-3.7.3.tgz",
+ "integrity": "sha512-f8euLVsyeAmAkSm/1M2Kb8sL8byQmfgbvBNaHFItCheTj/IpiJYSEWVcqDHZ/yEHxiS7+w87mQkzwZaPHmk5GA==",
+ "license": "MIT",
+ "dependencies": {
+ "sitemap": "^9.0.0",
+ "stream-replace-string": "^2.0.0",
+ "zod": "^4.3.6"
+ }
+ },
+ "node_modules/@astrojs/starlight": {
+ "version": "0.41.7",
+ "resolved": "https://registry.npmjs.org/@astrojs/starlight/-/starlight-0.41.7.tgz",
+ "integrity": "sha512-579VJuZgo20UpNQPm9EIez5W3DFSrD16uiV2YX6rUlpLtjgKSdnc69TxVTZXn4AtI2B731TI2qhW1O3K+vwtrQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@astrojs/markdown-satteri": "^0.3.5",
+ "@astrojs/mdx": "^7.0.5",
+ "@astrojs/sitemap": "^3.7.3",
+ "@pagefind/default-ui": "^1.3.0",
+ "@types/hast": "^3.0.4",
+ "@types/js-yaml": "^4.0.9",
+ "@types/mdast": "^4.0.4",
+ "astro-expressive-code": "^0.44.0",
+ "bcp-47": "^2.1.0",
+ "hast-util-from-html": "^2.0.3",
+ "hast-util-select": "^6.0.4",
+ "hast-util-to-string": "^3.0.1",
+ "hastscript": "^9.0.1",
+ "i18next": "^26.0.7",
+ "js-yaml": "^4.1.1",
+ "klona": "^2.0.6",
+ "magic-string": "^0.30.21",
+ "mdast-util-directive": "^3.1.0",
+ "mdast-util-to-markdown": "^2.1.2",
+ "mdast-util-to-string": "^4.0.0",
+ "pagefind": "^1.5.2",
+ "rehype": "^13.0.2",
+ "rehype-format": "^5.0.1",
+ "remark-directive": "^4.0.0",
+ "satteri": "^0.9.1",
+ "ultrahtml": "^1.6.0",
+ "unified": "^11.0.5",
+ "unist-util-visit": "^5.1.0",
+ "vfile": "^6.0.3"
+ },
+ "peerDependencies": {
+ "@astrojs/markdown-remark": "^7.2.0",
+ "astro": "^7.0.2"
+ },
+ "peerDependenciesMeta": {
+ "@astrojs/markdown-remark": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/@astrojs/telemetry": {
+ "version": "3.3.3",
+ "resolved": "https://registry.npmjs.org/@astrojs/telemetry/-/telemetry-3.3.3.tgz",
+ "integrity": "sha512-C1TLn5sPJr0x4vk56piHWKbnqlEB8BKyte5Y45V02U+D7BGO5eMqZDH5aPjnkXQWJggvmsTXxH03QMZ9NgWLzQ==",
+ "license": "MIT",
+ "dependencies": {
+ "ci-info": "^4.4.0",
+ "dset": "^3.1.4",
+ "is-docker": "^4.0.0",
+ "package-manager-detector": "^1.6.0"
+ },
+ "engines": {
+ "node": "18.20.8 || ^20.3.0 || >=22.0.0"
+ }
+ },
+ "node_modules/@astrojs/yaml2ts": {
+ "version": "0.2.4",
+ "resolved": "https://registry.npmjs.org/@astrojs/yaml2ts/-/yaml2ts-0.2.4.tgz",
+ "integrity": "sha512-8oddpOae35pJsXPQXhTkM0ypfKPskVsh2bCxRtbf7e+/Epw2nReakFYpLKjZMEr75CsoF203PMnCocpfz0s69A==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "yaml": "^2.8.3"
+ }
+ },
+ "node_modules/@babel/helper-string-parser": {
+ "version": "7.29.7",
+ "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz",
+ "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=6.9.0"
+ }
+ },
+ "node_modules/@babel/helper-validator-identifier": {
+ "version": "7.29.7",
+ "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz",
+ "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=6.9.0"
+ }
+ },
+ "node_modules/@babel/parser": {
+ "version": "7.29.8",
+ "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.8.tgz",
+ "integrity": "sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA==",
+ "license": "MIT",
+ "dependencies": {
+ "@babel/types": "^7.29.8"
+ },
+ "bin": {
+ "parser": "bin/babel-parser.js"
+ },
+ "engines": {
+ "node": ">=6.0.0"
+ }
+ },
+ "node_modules/@babel/types": {
+ "version": "7.29.8",
+ "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.8.tgz",
+ "integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==",
+ "license": "MIT",
+ "dependencies": {
+ "@babel/helper-string-parser": "^7.29.7",
+ "@babel/helper-validator-identifier": "^7.29.7"
+ },
+ "engines": {
+ "node": ">=6.9.0"
+ }
+ },
+ "node_modules/@bruits/satteri-darwin-arm64": {
+ "version": "0.9.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-darwin-arm64/-/satteri-darwin-arm64-0.9.5.tgz",
+ "integrity": "sha512-iw4nZgx9v30lWo/MTngQqi1pI78KI0DnkSm+lVJGYdmPLgAyDNJigVhpG42/Iq55A6c1Ll8q66ljyyRiQUxwow==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ]
+ },
+ "node_modules/@bruits/satteri-darwin-x64": {
+ "version": "0.9.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-darwin-x64/-/satteri-darwin-x64-0.9.5.tgz",
+ "integrity": "sha512-6T26Z5Kf3cFW2PSlk9p7zT7yVxvuBSiJvYyz9u8KjYwMTqZyIDOj2wDyNpxKV4+6yUVG7rddq2QwvG/8LJA2+Q==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ]
+ },
+ "node_modules/@bruits/satteri-linux-arm64-gnu": {
+ "version": "0.9.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-linux-arm64-gnu/-/satteri-linux-arm64-gnu-0.9.5.tgz",
+ "integrity": "sha512-u51id17uJwNEMK9nBlICsq6U31c+XVqQueVBkwRIzZG+gMpS8TOJctt5h5Wz33Z8xnMdTd+adtACVz0yHgGuOA==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@bruits/satteri-linux-arm64-musl": {
+ "version": "0.9.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-linux-arm64-musl/-/satteri-linux-arm64-musl-0.9.5.tgz",
+ "integrity": "sha512-v39HxiwGC5Rqm01HksP6+5Y+xKLPlsuVFgIgpEAo+SiQ22c+mJVhS3u7Z6ePAKdhL5NJoK1xq70kLz3L13AhpQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@bruits/satteri-linux-x64-gnu": {
+ "version": "0.9.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-linux-x64-gnu/-/satteri-linux-x64-gnu-0.9.5.tgz",
+ "integrity": "sha512-F3uO8uFp3pAP5ZGXttwvh57GS7s0lL953tnNdyI2gRyP4kOOkp6pyGojNJzCjkDvWI2Cvb9iNrKok3aqQPauAw==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@bruits/satteri-linux-x64-musl": {
+ "version": "0.9.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-linux-x64-musl/-/satteri-linux-x64-musl-0.9.5.tgz",
+ "integrity": "sha512-bicEqglLlz++mWyADaZoP0JY20s4vDfLjaPYgQqC+NI4zZLTOOg1T4GB8aqtc822Pqji8SQBmSrTb7CrP8i08Q==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@bruits/satteri-wasm32-wasi": {
+ "version": "0.9.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-wasm32-wasi/-/satteri-wasm32-wasi-0.9.5.tgz",
+ "integrity": "sha512-zauAuMwfPnKPUkd4AFixRFpXdgKwP2mKgxrIIo2gJzW0/ZneF9dbHnLkojSpaBnCCp7VUL1hIi5WWZvB1CqmAQ==",
+ "cpu": [
+ "wasm32"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "@emnapi/core": "1.11.1",
+ "@emnapi/runtime": "1.11.1",
+ "@napi-rs/wasm-runtime": "^1.1.6"
+ },
+ "engines": {
+ "node": ">=14.0.0"
+ }
+ },
+ "node_modules/@bruits/satteri-wasm32-wasi/node_modules/@emnapi/core": {
+ "version": "1.11.1",
+ "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.11.1.tgz",
+ "integrity": "sha512-RSvbQmHzdKzNsLYa/wHrbc3KN4sYLKAdPZxqiM2HATqv/SBk2/ENSHpvXGaLOMcsAyz0poEGqkmmKYG3OWiJEQ==",
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "@emnapi/wasi-threads": "1.2.2",
+ "tslib": "^2.4.0"
+ }
+ },
+ "node_modules/@bruits/satteri-wasm32-wasi/node_modules/@emnapi/runtime": {
+ "version": "1.11.1",
+ "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.11.1.tgz",
+ "integrity": "sha512-vgj7R3y3Wgx24IQaGPA/R6YFXLHVMOZ0uVEyIQPaWs+rd1AzfEMXlAC22FYwO1XkKR6NPsq7mUandH8oIRdZFw==",
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "tslib": "^2.4.0"
+ }
+ },
+ "node_modules/@bruits/satteri-wasm32-wasi/node_modules/@emnapi/wasi-threads": {
+ "version": "1.2.2",
+ "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.2.2.tgz",
+ "integrity": "sha512-c95qOXkHdydNKhscBTebqEC1CVAZpyqOfVfBzQ1qgzyl3gfeldUjIggDbIZgDKsHLgnsM+igH7TJ/eAasaVuMA==",
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "tslib": "^2.4.0"
+ }
+ },
+ "node_modules/@bruits/satteri-win32-arm64-msvc": {
+ "version": "0.9.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-win32-arm64-msvc/-/satteri-win32-arm64-msvc-0.9.5.tgz",
+ "integrity": "sha512-SrfE7NEsgZjBvU3c+RR6oQRu0ToXY5uVJEbieXEF0YTctIV2zAVlbaMjWLts074QCgh3a+XHWkR/lWh2VH2LUg==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
+ "node_modules/@bruits/satteri-win32-x64-msvc": {
+ "version": "0.9.5",
+ "resolved": "https://registry.npmjs.org/@bruits/satteri-win32-x64-msvc/-/satteri-win32-x64-msvc-0.9.5.tgz",
+ "integrity": "sha512-5Kw9ZAtTGS8WHizyn+CJhjjfIQrw+7jcZodpmpXJjefnO15M8UexIi6JR2E5thyvsmHyhL6ZDDMUNR4bKJPd4g==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
+ "node_modules/@capsizecss/unpack": {
+ "version": "4.0.1",
+ "resolved": "https://registry.npmjs.org/@capsizecss/unpack/-/unpack-4.0.1.tgz",
+ "integrity": "sha512-CuNiSqg7+e1cO/GjffyMOm5Tt2jUF9CWHHnvQ/UkqvtkGfHdgwEC0wpmq7fkN3gxwpRnrAN0WzO3vREKmNolMQ==",
+ "license": "MIT",
+ "dependencies": {
+ "fontkitten": "^1.0.3"
+ },
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@clack/core": {
+ "version": "1.4.3",
+ "resolved": "https://registry.npmjs.org/@clack/core/-/core-1.4.3.tgz",
+ "integrity": "sha512-/kr3UWNtdJfxZtPgDqUOmG2pvwlmcLGheex5yiZKdwbzZJxhV+HMNR9QNmyY5cGwTNV6LrR7Jtp+KjhUAP1qBQ==",
+ "license": "MIT",
+ "dependencies": {
+ "fast-wrap-ansi": "^0.2.0",
+ "sisteransi": "^1.0.5"
+ },
+ "engines": {
+ "node": ">= 20.12.0"
+ }
+ },
+ "node_modules/@clack/prompts": {
+ "version": "1.7.0",
+ "resolved": "https://registry.npmjs.org/@clack/prompts/-/prompts-1.7.0.tgz",
+ "integrity": "sha512-y7/yvZ2TPAnR9+jnc00klvNNLkJiXFFrQA/hlLCcxA9a2A4zQIOimyFQ9XfwYKiGD1fb5GY8vbKIIgO8d5Tb2A==",
+ "license": "MIT",
+ "dependencies": {
+ "@clack/core": "1.4.3",
+ "fast-string-width": "^3.0.2",
+ "fast-wrap-ansi": "^0.2.0",
+ "sisteransi": "^1.0.5"
+ },
+ "engines": {
+ "node": ">= 20.12.0"
+ }
+ },
+ "node_modules/@ctrl/tinycolor": {
+ "version": "4.2.0",
+ "resolved": "https://registry.npmjs.org/@ctrl/tinycolor/-/tinycolor-4.2.0.tgz",
+ "integrity": "sha512-kzyuwOAQnXJNLS9PSyrk0CWk35nWJW/zl/6KvnTBMFK65gm7U1/Z5BqjxeapjZCIhQcM/DsrEmcbRwDyXyXK4A==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=14"
+ }
+ },
+ "node_modules/@emmetio/abbreviation": {
+ "version": "2.3.3",
+ "resolved": "https://registry.npmjs.org/@emmetio/abbreviation/-/abbreviation-2.3.3.tgz",
+ "integrity": "sha512-mgv58UrU3rh4YgbE/TzgLQwJ3pFsHHhCLqY20aJq+9comytTXUDNGG/SMtSeMJdkpxgXSXunBGLD8Boka3JyVA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@emmetio/scanner": "^1.0.4"
+ }
+ },
+ "node_modules/@emmetio/css-abbreviation": {
+ "version": "2.1.8",
+ "resolved": "https://registry.npmjs.org/@emmetio/css-abbreviation/-/css-abbreviation-2.1.8.tgz",
+ "integrity": "sha512-s9yjhJ6saOO/uk1V74eifykk2CBYi01STTK3WlXWGOepyKa23ymJ053+DNQjpFcy1ingpaO7AxCcwLvHFY9tuw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@emmetio/scanner": "^1.0.4"
+ }
+ },
+ "node_modules/@emmetio/css-parser": {
+ "version": "0.4.1",
+ "resolved": "https://registry.npmjs.org/@emmetio/css-parser/-/css-parser-0.4.1.tgz",
+ "integrity": "sha512-2bC6m0MV/voF4CTZiAbG5MWKbq5EBmDPKu9Sb7s7nVcEzNQlrZP6mFFFlIaISM8X6514H9shWMme1fCm8cWAfQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@emmetio/stream-reader": "^2.2.0",
+ "@emmetio/stream-reader-utils": "^0.1.0"
+ }
+ },
+ "node_modules/@emmetio/html-matcher": {
+ "version": "1.3.0",
+ "resolved": "https://registry.npmjs.org/@emmetio/html-matcher/-/html-matcher-1.3.0.tgz",
+ "integrity": "sha512-NTbsvppE5eVyBMuyGfVu2CRrLvo7J4YHb6t9sBFLyY03WYhXET37qA4zOYUjBWFCRHO7pS1B9khERtY0f5JXPQ==",
+ "dev": true,
+ "license": "ISC",
+ "dependencies": {
+ "@emmetio/scanner": "^1.0.0"
+ }
+ },
+ "node_modules/@emmetio/scanner": {
+ "version": "1.0.4",
+ "resolved": "https://registry.npmjs.org/@emmetio/scanner/-/scanner-1.0.4.tgz",
+ "integrity": "sha512-IqRuJtQff7YHHBk4G8YZ45uB9BaAGcwQeVzgj/zj8/UdOhtQpEIupUhSk8dys6spFIWVZVeK20CzGEnqR5SbqA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@emmetio/stream-reader": {
+ "version": "2.2.0",
+ "resolved": "https://registry.npmjs.org/@emmetio/stream-reader/-/stream-reader-2.2.0.tgz",
+ "integrity": "sha512-fXVXEyFA5Yv3M3n8sUGT7+fvecGrZP4k6FnWWMSZVQf69kAq0LLpaBQLGcPR30m3zMmKYhECP4k/ZkzvhEW5kw==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@emmetio/stream-reader-utils": {
+ "version": "0.1.0",
+ "resolved": "https://registry.npmjs.org/@emmetio/stream-reader-utils/-/stream-reader-utils-0.1.0.tgz",
+ "integrity": "sha512-ZsZ2I9Vzso3Ho/pjZFsmmZ++FWeEd/txqybHTm4OgaZzdS8V9V/YYWQwg5TC38Z7uLWUV1vavpLLbjJtKubR1A==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@emnapi/core": {
+ "version": "1.11.3",
+ "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.11.3.tgz",
+ "integrity": "sha512-zLpS5asjEb7lq8jYLq37N6XKaE41DIexlY1rF/z4/tIl3wo13Sqm28fRyfIsKZD+NZ8mM5RoKkpW/rBcuoSZSg==",
+ "license": "MIT",
+ "optional": true,
+ "peer": true,
+ "dependencies": {
+ "@emnapi/wasi-threads": "1.2.3",
+ "tslib": "^2.4.0"
+ }
+ },
+ "node_modules/@emnapi/runtime": {
+ "version": "1.11.3",
+ "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.11.3.tgz",
+ "integrity": "sha512-Xz4Tpyki7XyrpbUK1jR1AhdAdaXyhhY4lZ3neLodmhpuWfy2PAQN5B46sAiU4liOXGLkHypn/qU+jvfWSCYYLA==",
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "tslib": "^2.4.0"
+ }
+ },
+ "node_modules/@emnapi/wasi-threads": {
+ "version": "1.2.3",
+ "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.2.3.tgz",
+ "integrity": "sha512-ELEBe8PsLvvJ6QMr0zLt8ffvOHW/dc1m3CEzNMg7aJUv3bMaoDtw2TXyDAwkYBuroxxuHEwhRTLJSe5sya547g==",
+ "license": "MIT",
+ "optional": true,
+ "peer": true,
+ "dependencies": {
+ "tslib": "^2.4.0"
+ }
+ },
+ "node_modules/@esbuild/aix-ppc64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz",
+ "integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==",
+ "cpu": [
+ "ppc64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "aix"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/android-arm": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.2.tgz",
+ "integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==",
+ "cpu": [
+ "arm"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "android"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/android-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz",
+ "integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "android"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/android-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.2.tgz",
+ "integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "android"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/darwin-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz",
+ "integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/darwin-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz",
+ "integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/freebsd-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz",
+ "integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/freebsd-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz",
+ "integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-arm": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz",
+ "integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==",
+ "cpu": [
+ "arm"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz",
+ "integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-ia32": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz",
+ "integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==",
+ "cpu": [
+ "ia32"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-loong64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz",
+ "integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==",
+ "cpu": [
+ "loong64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-mips64el": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz",
+ "integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==",
+ "cpu": [
+ "mips64el"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-ppc64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz",
+ "integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==",
+ "cpu": [
+ "ppc64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-riscv64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz",
+ "integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==",
+ "cpu": [
+ "riscv64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-s390x": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz",
+ "integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==",
+ "cpu": [
+ "s390x"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/linux-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz",
+ "integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/netbsd-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz",
+ "integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "netbsd"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/netbsd-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz",
+ "integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "netbsd"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/openbsd-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz",
+ "integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "openbsd"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/openbsd-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz",
+ "integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "openbsd"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/openharmony-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz",
+ "integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "openharmony"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/sunos-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz",
+ "integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "sunos"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/win32-arm64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz",
+ "integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/win32-ia32": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz",
+ "integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==",
+ "cpu": [
+ "ia32"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@esbuild/win32-x64": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz",
+ "integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@expressive-code/core": {
+ "version": "0.44.1",
+ "resolved": "https://registry.npmjs.org/@expressive-code/core/-/core-0.44.1.tgz",
+ "integrity": "sha512-3dDo9N8D7hYrLNNMMWFovg3+aDUtnQm7c7z0GZc1c0LEFVBc0Q6lKG+tVT28gDadOvsgOANfCn35fgpe97Pmgg==",
+ "license": "MIT",
+ "dependencies": {
+ "@ctrl/tinycolor": "^4.0.4",
+ "hast-util-select": "^6.0.2",
+ "hast-util-to-html": "^9.0.1",
+ "hast-util-to-text": "^4.0.1",
+ "hastscript": "^9.0.0",
+ "postcss": "^8.4.38",
+ "postcss-nested": "^6.0.1",
+ "unist-util-visit": "^5.0.0",
+ "unist-util-visit-parents": "^6.0.1"
+ }
+ },
+ "node_modules/@expressive-code/plugin-frames": {
+ "version": "0.44.1",
+ "resolved": "https://registry.npmjs.org/@expressive-code/plugin-frames/-/plugin-frames-0.44.1.tgz",
+ "integrity": "sha512-HC/bdRao9225ApcgO/e3jn8ZOhldKO7ob1O/Tcipvtv7Vb5nMphZhMtD9uuywpvxkPYBHJi3504WhrKg05Dwqg==",
+ "license": "MIT",
+ "dependencies": {
+ "@expressive-code/core": "^0.44.1"
+ }
+ },
+ "node_modules/@expressive-code/plugin-shiki": {
+ "version": "0.44.1",
+ "resolved": "https://registry.npmjs.org/@expressive-code/plugin-shiki/-/plugin-shiki-0.44.1.tgz",
+ "integrity": "sha512-YApiZt3buUzBwL5tqj8G+sYC5NjMjRCHgQwr9bmGl69rtcHy6fE9dooWUeKYB978fJT2BuxT5FeHcF47rA3SEg==",
+ "license": "MIT",
+ "dependencies": {
+ "@expressive-code/core": "^0.44.1",
+ "shiki": "^4.0.2"
+ }
+ },
+ "node_modules/@expressive-code/plugin-text-markers": {
+ "version": "0.44.1",
+ "resolved": "https://registry.npmjs.org/@expressive-code/plugin-text-markers/-/plugin-text-markers-0.44.1.tgz",
+ "integrity": "sha512-B3BsJoJ8CFMlcIX9f+X9tcI3C4zPDO601+YuLi9GheSTNro7ZfqSjLptMQKBHOWZvxnAtY5zvIX7iO/qtBhNBg==",
+ "license": "MIT",
+ "dependencies": {
+ "@expressive-code/core": "^0.44.1"
+ }
+ },
+ "node_modules/@img/colour": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.1.0.tgz",
+ "integrity": "sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==",
+ "license": "MIT",
+ "optional": true,
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@img/sharp-darwin-arm64": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.35.3.tgz",
+ "integrity": "sha512-RMnFX7YQsMoh7lWfcM4NEHHymBX/rLuKNPVM84XE9ONPcaSCDgE7CHIHpSgPcO2xcRthgBy1HfNO319mwhIAkg==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-darwin-arm64": "1.3.2"
+ }
+ },
+ "node_modules/@img/sharp-darwin-x64": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.35.3.tgz",
+ "integrity": "sha512-Xo+5uFBtLN0BKqieTxiFzFPQAUlBbbH5iBKyRX/z1JrbnYsHTfKJnUfL8+p2TPXr1pXqao4eeL4Rl144uDpK9w==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-darwin-x64": "1.3.2"
+ }
+ },
+ "node_modules/@img/sharp-freebsd-wasm32": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-freebsd-wasm32/-/sharp-freebsd-wasm32-0.35.3.tgz",
+ "integrity": "sha512-lUxcqWIj2wMQ9BrwNjngcr1gWUr5xgaGThBRqPPalIC2n67Cqj1uPh8NnA/ZhAg8hUbKl+kVHKwgUIwe6ZYPrg==",
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ],
+ "dependencies": {
+ "@img/sharp-wasm32": "0.35.3"
+ },
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-darwin-arm64": {
+ "version": "1.3.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.3.2.tgz",
+ "integrity": "sha512-9J6ypZFpQBj4YnePGoq/S38w6nz+vqg5WZLrLGY4YuSemdMq47GMLBPO42MzwdGwpg/agZ7xzZcFHa48xlywfg==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-darwin-x64": {
+ "version": "1.3.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.3.2.tgz",
+ "integrity": "sha512-m2pW1n6cns9VaubNwsZ+c3CRYjxNQWgJ5gPlnL1nbBcpkBvFm6SCFN5o0psFHI8w9n11NKhFkeEDns98tiqbEw==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linux-arm": {
+ "version": "1.3.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.3.2.tgz",
+ "integrity": "sha512-1eMLzy92I4J6rmi4mAT8yC3HxOtniyGELlzGbNMLLeqe052ahFQ0h6LFq+lh5DsDIdYViIDst08abvSbcEdLXQ==",
+ "cpu": [
+ "arm"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linux-arm64": {
+ "version": "1.3.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.3.2.tgz",
+ "integrity": "sha512-dqVSFynCox4C/J8kT16V7SIFAns0IjgLwkvYT7p8LQVmJ5OS5b6tI9IGflxTeuBS//zXeFIUbwt5dwxyZ17cnA==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linux-ppc64": {
+ "version": "1.3.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.3.2.tgz",
+ "integrity": "sha512-3z0NHDxD6n5I9gc05U1eW1AyRm+Gznzq3naMrthPNqE6oYykcogW0l/jfpJdjYnuNl8R7yI9pNbE1XiUeyq0Aw==",
+ "cpu": [
+ "ppc64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linux-riscv64": {
+ "version": "1.3.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-riscv64/-/sharp-libvips-linux-riscv64-1.3.2.tgz",
+ "integrity": "sha512-bsb4rI+NldGOsXuej2r8OdSS8+zXDVaCWxyWrcv6kneTOlgAHtZABRzBBCwdsPiD90J4myNJuHpg6kA20ImW/w==",
+ "cpu": [
+ "riscv64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linux-s390x": {
+ "version": "1.3.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.3.2.tgz",
+ "integrity": "sha512-/ABshyj8gCpyIrNXnHn4LorDJ0HHm1VhXPBlxZ8zAtfVPAaSafXPGn+sUSIRiwaSBy0mmFjSjiXI5mkcwdChKQ==",
+ "cpu": [
+ "s390x"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linux-x64": {
+ "version": "1.3.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.3.2.tgz",
+ "integrity": "sha512-ITPEtgffGJ0S6G9dRyw/366tJQqFRcHWPHhC+Stpg3Z8AEMrDrTr2lhdz4f/Y/HMbRh//7Z5mBzEpVdi62Oc3w==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linuxmusl-arm64": {
+ "version": "1.3.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.3.2.tgz",
+ "integrity": "sha512-zE9EdiUzUmg5mDT5a1rk5fYJ6GWPloTwWBYDS14naqHsL+EaMpDj1AWnpLgh3u0YCORv2Tt50wrcrpYqkP97Kw==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linuxmusl-x64": {
+ "version": "1.3.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.3.2.tgz",
+ "integrity": "sha512-m0lrLiUt+lBYnCFr8qV/65yMR4E/c7/wf78I5eKTdkEakFAlZ9QlzEM3QIhhAwVeUhLAHLcCq7a7Vszq/oFNZQ==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-linux-arm": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.35.3.tgz",
+ "integrity": "sha512-affVWCTLooy8TSxbDx2qkzuDeaWLNVBA+P//FNBirHsXpP2fuBhk5AuboYUnrDnzoXes8GFjpTx0SBFOCRg+FA==",
+ "cpu": [
+ "arm"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linux-arm": "1.3.2"
+ }
+ },
+ "node_modules/@img/sharp-linux-arm64": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.35.3.tgz",
+ "integrity": "sha512-QgKDspHPnrU+GQ55XPhGwyhC8acLVOOSyAvo1oVfFmrIXLkDNmGWzAfDZ4xK8oSA1qBQrALcHX0G5UZni/SuFQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linux-arm64": "1.3.2"
+ }
+ },
+ "node_modules/@img/sharp-linux-ppc64": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.35.3.tgz",
+ "integrity": "sha512-sMd8rDxmpLOwv/7N44klFjOD5DUO7FLdjiXDI0hoxYaf7Ar262dQIEkosE98bps+5HPLtp/EvNqeqQtOycP/IA==",
+ "cpu": [
+ "ppc64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linux-ppc64": "1.3.2"
+ }
+ },
+ "node_modules/@img/sharp-linux-riscv64": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-riscv64/-/sharp-linux-riscv64-0.35.3.tgz",
+ "integrity": "sha512-0Eob78yjlYPfL5vMNWAW55l3R9Y6BQS/gOfe0ZcP9mEz9ohhKSt4im1hayiknXgf8AWrFqMvJcKIdmLmEe7yeQ==",
+ "cpu": [
+ "riscv64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linux-riscv64": "1.3.2"
+ }
+ },
+ "node_modules/@img/sharp-linux-s390x": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.35.3.tgz",
+ "integrity": "sha512-KgAxQ0DxpNOq1rG2t5cgTgShJFGSuU7XO45cqC+1NVOuZnP6tlgZRuSYOfNupGkHID0o3cJOsw4DVeJpMovcGw==",
+ "cpu": [
+ "s390x"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linux-s390x": "1.3.2"
+ }
+ },
+ "node_modules/@img/sharp-linux-x64": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.35.3.tgz",
+ "integrity": "sha512-8pqvxubL2PGdhlPy6GLqzDYMUjyRmKAwKHYKixpdJYBUK7PJ0C029XdsnpFIdgRZG68fZiGdHVWcKPvtiPB4cA==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linux-x64": "1.3.2"
+ }
+ },
+ "node_modules/@img/sharp-linuxmusl-arm64": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.35.3.tgz",
+ "integrity": "sha512-Vz0iQjzzcSX3HCbfwFfCSG/9SCIqyO0mH2sXyiHaAYfBk0cRsCWXRyQYX0ovCK/PAQBbTzQ0dsPQHh5MAFL59w==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linuxmusl-arm64": "1.3.2"
+ }
+ },
+ "node_modules/@img/sharp-linuxmusl-x64": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.35.3.tgz",
+ "integrity": "sha512-6O1NPKcDVj9QEdg7Hx549EX8U0rp6yXQERqru6yRN7fGBn32UvIRJUlWnk+8xDCiG76hXVBbX82NZ/ZKr0euIg==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linuxmusl-x64": "1.3.2"
+ }
+ },
+ "node_modules/@img/sharp-wasm32": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.35.3.tgz",
+ "integrity": "sha512-cZ0XkcYGpHZkqW6iCkqTcmUC0CD9DhD5d/qeZlZkfRBn6GnHniZXLUo5+9xw8Iv76YE6LQFN9YNBlKREcCG76w==",
+ "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT",
+ "optional": true,
+ "dependencies": {
+ "@emnapi/runtime": "^1.11.1"
+ },
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-webcontainers-wasm32": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-webcontainers-wasm32/-/sharp-webcontainers-wasm32-0.35.3.tgz",
+ "integrity": "sha512-2rnq7bX3NzeR2T4YWgz8qiG4h3TSdMe+vN1iQXpJleSJ3SM5zQ8Fy2SyyXAWlbxpEZ2Y+Z4u1BePgJEYbSy80Q==",
+ "cpu": [
+ "wasm32"
+ ],
+ "license": "Apache-2.0",
+ "optional": true,
+ "dependencies": {
+ "@img/sharp-wasm32": "0.35.3"
+ },
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-win32-arm64": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.35.3.tgz",
+ "integrity": "sha512-4bPwFdMbeC4JQ8L8LOyWp6nsHcboP5fxkp6iPOXz2Vg49R42TuMs2whkJ5OAP4/Ul035qOzy0AecOF9VOscn4w==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "Apache-2.0 AND LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-win32-ia32": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.35.3.tgz",
+ "integrity": "sha512-r53mXsBN6lFUDiST764SvgwUdHAqM4rPAiDzAmf4fLoB6X/rkfyTrLCg6+g17wJJiCmB3JYgHuUldCWUIRFSXw==",
+ "cpu": [
+ "ia32"
+ ],
+ "license": "Apache-2.0 AND LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": "^20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-win32-x64": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.35.3.tgz",
+ "integrity": "sha512-D4y1vNeZrIIJCN+uHaWVtH86B+aCrdMYYjicy9pXHvbGZeGYLLSd3wdVuC37FxVXlU1ARsk84eKWfWMXGYEqvA==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "Apache-2.0 AND LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@jridgewell/sourcemap-codec": {
+ "version": "1.5.5",
+ "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+ "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
+ "license": "MIT"
+ },
+ "node_modules/@mdx-js/mdx": {
+ "version": "3.1.1",
+ "resolved": "https://registry.npmjs.org/@mdx-js/mdx/-/mdx-3.1.1.tgz",
+ "integrity": "sha512-f6ZO2ifpwAQIpzGWaBQT2TXxPv6z3RBzQKpVftEWN78Vl/YweF1uwussDx8ECAXVtr3Rs89fKyG9YlzUs9DyGQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "@types/estree-jsx": "^1.0.0",
+ "@types/hast": "^3.0.0",
+ "@types/mdx": "^2.0.0",
+ "acorn": "^8.0.0",
+ "collapse-white-space": "^2.0.0",
+ "devlop": "^1.0.0",
+ "estree-util-is-identifier-name": "^3.0.0",
+ "estree-util-scope": "^1.0.0",
+ "estree-walker": "^3.0.0",
+ "hast-util-to-jsx-runtime": "^2.0.0",
+ "markdown-extensions": "^2.0.0",
+ "recma-build-jsx": "^1.0.0",
+ "recma-jsx": "^1.0.0",
+ "recma-stringify": "^1.0.0",
+ "rehype-recma": "^1.0.0",
+ "remark-mdx": "^3.0.0",
+ "remark-parse": "^11.0.0",
+ "remark-rehype": "^11.0.0",
+ "source-map": "^0.7.0",
+ "unified": "^11.0.0",
+ "unist-util-position-from-estree": "^2.0.0",
+ "unist-util-stringify-position": "^4.0.0",
+ "unist-util-visit": "^5.0.0",
+ "vfile": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/@napi-rs/wasm-runtime": {
+ "version": "1.2.3",
+ "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-1.2.3.tgz",
+ "integrity": "sha512-UMduMbqO5s5zF2NkNacMT/yK5Y5QiKvWr2+50bzIIxFDwVJ2h49b+oyjaCGPhJxd2/gC2x39EHv/gHVuu36x2Q==",
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "@tybys/wasm-util": "^0.10.3"
+ },
+ "engines": {
+ "node": "^20.19.0 || ^22.13.0 || >=23.5.0"
+ },
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/Brooooooklyn"
+ },
+ "peerDependencies": {
+ "@emnapi/core": "^1.7.1 || ^2.0.0-alpha.4",
+ "@emnapi/runtime": "^1.7.1 || ^2.0.0-alpha.4"
+ }
+ },
+ "node_modules/@oslojs/encoding": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/@oslojs/encoding/-/encoding-1.1.0.tgz",
+ "integrity": "sha512-70wQhgYmndg4GCPxPPxPGevRKqTIJ2Nh4OkiMWmDAVYsTQ+Ta7Sq+rPevXyXGdzr30/qZBnyOalCszoMxlyldQ==",
+ "license": "MIT"
+ },
+ "node_modules/@oxc-project/types": {
+ "version": "0.146.0",
+ "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.146.0.tgz",
+ "integrity": "sha512-XC0QsnnhVe7sLIWmYmdPw7x5P0h4W8vUU3Nv1ySgWXtvCz8NizoAEpGXA0sOYoJQV2Rl13LgURAHQ5cI5ILCSA==",
+ "license": "MIT",
+ "funding": {
+ "url": "https://github.com/sponsors/Boshen"
+ }
+ },
+ "node_modules/@pagefind/darwin-arm64": {
+ "version": "1.5.2",
+ "resolved": "https://registry.npmjs.org/@pagefind/darwin-arm64/-/darwin-arm64-1.5.2.tgz",
+ "integrity": "sha512-MXpI+7HsAdPkvJ0gk9xj9g541BCqBZOBbdwj9g6lB5LCj6kSV6nqDSjzcAJwvOsfu0fjwvC8hQU+ecfhp+MpiQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ]
+ },
+ "node_modules/@pagefind/darwin-x64": {
+ "version": "1.5.2",
+ "resolved": "https://registry.npmjs.org/@pagefind/darwin-x64/-/darwin-x64-1.5.2.tgz",
+ "integrity": "sha512-IojxFWMEJe0RQ7PQ3KXQsPIImNsbpPYpoZ+QUDrL8fAl/O27IX+LVLs74/UzEZy5uA2LD8Nz1AiwKr72vrkZQw==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ]
+ },
+ "node_modules/@pagefind/default-ui": {
+ "version": "1.5.2",
+ "resolved": "https://registry.npmjs.org/@pagefind/default-ui/-/default-ui-1.5.2.tgz",
+ "integrity": "sha512-pm1LMnQg8N2B3n2TnjKlhaFihpz6zTiA4HiGQ6/slKO/+8K9CAU5kcjdSSPgpuk1PMuuN4hxLipUIifnrkl3Sg==",
+ "license": "MIT"
+ },
+ "node_modules/@pagefind/freebsd-x64": {
+ "version": "1.5.2",
+ "resolved": "https://registry.npmjs.org/@pagefind/freebsd-x64/-/freebsd-x64-1.5.2.tgz",
+ "integrity": "sha512-7EVzo9+0w+2cbe671BtMj10UlNo83I+HrLVLfRxO731svHRJKUfJ/mo05gU14pe9PCfpKNQT8FS3Xc/oDN6pOA==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ]
+ },
+ "node_modules/@pagefind/linux-arm64": {
+ "version": "1.5.2",
+ "resolved": "https://registry.npmjs.org/@pagefind/linux-arm64/-/linux-arm64-1.5.2.tgz",
+ "integrity": "sha512-Ovt9+K35sqzn8H3ZMXGwls4TD/wMJuvRtShHIsmUQREmaxjrDEX7gHckRCrwYJ4XE1H1p6HkLz3wukrAnsfXQw==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@pagefind/linux-x64": {
+ "version": "1.5.2",
+ "resolved": "https://registry.npmjs.org/@pagefind/linux-x64/-/linux-x64-1.5.2.tgz",
+ "integrity": "sha512-V+tFqHKXhQKq/WqPBD67AFy7scn1/aZID00ws4fSDd+1daSi5UHR9VVlRrOUYKxn3VuFQYRD7lYXdZK1WED1YA==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ]
+ },
+ "node_modules/@pagefind/windows-arm64": {
+ "version": "1.5.2",
+ "resolved": "https://registry.npmjs.org/@pagefind/windows-arm64/-/windows-arm64-1.5.2.tgz",
+ "integrity": "sha512-hN9Nh90fNW61nNRCW9ZyQrAj/mD0eRvmJ8NlTUzkbuW8kIzGJUi3cxjFkEcMZ5h/8FsKWD/VcouZl4yo1F7B6g==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
+ "node_modules/@pagefind/windows-x64": {
+ "version": "1.5.2",
+ "resolved": "https://registry.npmjs.org/@pagefind/windows-x64/-/windows-x64-1.5.2.tgz",
+ "integrity": "sha512-Fa2Iyw7kaDRzGMfNYNUXNW2zbL5FQVDgSOcbDHdzBrDEdpqOqg8TcZ68F22ol6NJ9IGzvUdmeyZypLW5dyhqsg==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ]
+ },
+ "node_modules/@rolldown/binding-android-arm-eabi": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm-eabi/-/binding-android-arm-eabi-1.2.5.tgz",
+ "integrity": "sha512-DLe/i+l8ynIBY7XEQ191TeZvCoowIGa18R+dIV30GW7DiOtp74i/xX8hs8GUjW5ARV7VZuie3d6AumSmCwbeRA==",
+ "cpu": [
+ "arm"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "android"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-android-arm64": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.2.5.tgz",
+ "integrity": "sha512-zXcwKlQApYAOELHd8PwKDFkagYF9Wy4e0RJ+0qnzl9Pjnpj75TEG8ufv40p2J7kCEfwZAsNiuzRIyNNMWT38ig==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "android"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-darwin-arm64": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.2.5.tgz",
+ "integrity": "sha512-dK4QakI42nzWgJT5sm4y4y/O//D4OxM75/cH28RLV+nzIN9AY+YsbuUVrUTjlLjXR6vpyxFbSsbmNuJ6BP9sww==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-darwin-x64": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.2.5.tgz",
+ "integrity": "sha512-fqSALaUu1Wjd1nK2uW2kJDWdLCc8lx1IcY+MTY26Aurfdx19anlzhqXOgCFbBFQnlFDTn4TC1/7Nz4Bl2mLP3A==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-freebsd-x64": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.2.5.tgz",
+ "integrity": "sha512-/vCnNxlkxs9tKxNDcyWUePpJ/PgTzxIaVhoM5SmG8UV+GR/IcPam4VYxi7GIMo7PSDuNqlJqvprqii9NqqVCMw==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-arm-gnueabihf": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.2.5.tgz",
+ "integrity": "sha512-abk0NLA519LxRCszmbE0jYKuQ9YPocOXTiOXOo6Yr+YAT95VH+PtqYAjOJvGKt3viEd/x4qzabAlwd5bHOOARg==",
+ "cpu": [
+ "arm"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-arm64-gnu": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.2.5.tgz",
+ "integrity": "sha512-Y7eALiJ8lr0M2HH103Js+g7V34wf6snlpZLAsHI90uLhr3PVlNsbFVAXJC9d/V6BnPyKtpSwI+NcB/RLxsQxuA==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-arm64-musl": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.2.5.tgz",
+ "integrity": "sha512-xMvZgnbZg4YVnR/AX2b3oOPDTFYJvUVaJg5FedA/LuvexAtXibZQej4cnTkw3rjsJ/ggUROB64TdtETiim+FYA==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-ppc64-gnu": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.2.5.tgz",
+ "integrity": "sha512-GRjeqTUDHTo5GwntsLaAMcBahG3nlpjftXWZLN73HiYQlhwEowvarFgQnRnQZtIp4keXX7quXFbG38uPZBa2EA==",
+ "cpu": [
+ "ppc64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-s390x-gnu": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.2.5.tgz",
+ "integrity": "sha512-vLNTR45F2Uwc8AufkNXPmB4VliaXs+FvcheEogIzOXzO4l+LzieXF5A/TWxLy5HtqpsRCHUfd0lPVrrdgXdLHQ==",
+ "cpu": [
+ "s390x"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-x64-gnu": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.2.5.tgz",
+ "integrity": "sha512-Mgj59/HTuYeK9Gz2MA+mBWKnHsAgkBSec15ZMb1st3oIfFbX7gCjOae7GydHhzcyQi9Z/7M1QuN9bR3oFqF0jQ==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-linux-x64-musl": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.2.5.tgz",
+ "integrity": "sha512-mY8AP0/ichsbhAxGnLa3d3+MwV0EfgrPND2bplI3Ym8T6R2pJ0N87bvrKVwNXmdy3jnr6eQBecdqx/HMknBmpA==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-openharmony-arm64": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.2.5.tgz",
+ "integrity": "sha512-8SLssA2oweAxyRgDp789ACfRb/3P+zNRJpzZxSizxF9m8NUDQ4+3xjo8ttjhVGGw6Qxb70oZiEtIjaKikCO7Yw==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "openharmony"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-win32-arm64-msvc": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.2.5.tgz",
+ "integrity": "sha512-vGbruD5zquhoc8D9SViXgN2FBJtNdTyQ4DtG+SWiEGlJiAzoKcZ2xp+xuXCffhubVdt0NJlTZqkeRuERy7g8Cw==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/binding-win32-x64-msvc": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.2.5.tgz",
+ "integrity": "sha512-e/SXpgISz+IoqVcSSI0rx/d/he8zqLex+/rCWpnHpmVfmPIUjag9H6P7zotf0gJHwPUhQxZ/mF8tr6acebT9yw==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ }
+ },
+ "node_modules/@rolldown/pluginutils": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.1.tgz",
+ "integrity": "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==",
+ "license": "MIT"
+ },
+ "node_modules/@shikijs/core": {
+ "version": "4.4.3",
+ "resolved": "https://registry.npmjs.org/@shikijs/core/-/core-4.4.3.tgz",
+ "integrity": "sha512-QCR4q2ZO/ILJEuwiBMel4wdcTDb1JGwfjKTxPDF6x8ixOaluPrVqIn06C99AcRPhmYlBR56d/Fb+GN58GzExpg==",
+ "license": "MIT",
+ "dependencies": {
+ "@shikijs/primitive": "4.4.3",
+ "@shikijs/types": "4.4.3",
+ "@shikijs/vscode-textmate": "^10.0.2",
+ "@types/hast": "^3.0.5",
+ "hast-util-to-html": "^9.0.5"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/@shikijs/engine-javascript": {
+ "version": "4.4.3",
+ "resolved": "https://registry.npmjs.org/@shikijs/engine-javascript/-/engine-javascript-4.4.3.tgz",
+ "integrity": "sha512-FbOjFJp9VLdo1Wevs10BBtVxiTWwNLqZh5Gkhjgda/ioL15YOgeSl9n+6XMa3qRlPQzfhFNe641SrynFHYG0nQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@shikijs/types": "4.4.3",
+ "@shikijs/vscode-textmate": "^10.0.2",
+ "oniguruma-to-es": "^4.3.6"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/@shikijs/engine-oniguruma": {
+ "version": "4.4.3",
+ "resolved": "https://registry.npmjs.org/@shikijs/engine-oniguruma/-/engine-oniguruma-4.4.3.tgz",
+ "integrity": "sha512-EcOQkxdxGQrc1Row/cC2c96/v1dbZqGnEVu1qTuT/MJmp6+cXCvQussowVmCv5Tqr3KuY3c7IbM6HTW3LJ1k9w==",
+ "license": "MIT",
+ "dependencies": {
+ "@shikijs/types": "4.4.3",
+ "@shikijs/vscode-textmate": "^10.0.2"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/@shikijs/langs": {
+ "version": "4.4.3",
+ "resolved": "https://registry.npmjs.org/@shikijs/langs/-/langs-4.4.3.tgz",
+ "integrity": "sha512-ePic0yfAJGOF83D5wBHK/00EjK65oahBYxFk5epgq33WRv7X9UuxLEV8PtR0szC0z8dl7INIpIodB99JRFlR+A==",
+ "license": "MIT",
+ "dependencies": {
+ "@shikijs/types": "4.4.3"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/@shikijs/primitive": {
+ "version": "4.4.3",
+ "resolved": "https://registry.npmjs.org/@shikijs/primitive/-/primitive-4.4.3.tgz",
+ "integrity": "sha512-m0wBeLDQDeIxRdUmrCPdQqfuUamDwRL5isCfYbguKD6NiaKpVbsv+3J81DyIKgNW5h4WAIIr8T4EkgQrBBxvaQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@shikijs/types": "4.4.3",
+ "@shikijs/vscode-textmate": "^10.0.2",
+ "@types/hast": "^3.0.5"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/@shikijs/themes": {
+ "version": "4.4.3",
+ "resolved": "https://registry.npmjs.org/@shikijs/themes/-/themes-4.4.3.tgz",
+ "integrity": "sha512-w8UHjeUnIR965KMWJHUPXOc2mNJUnK3vpVLYLvw5IYU2mnTTJ89E24OrJDBNiJDQ0qzb0tc4l7mrIXx5cFeIyw==",
+ "license": "MIT",
+ "dependencies": {
+ "@shikijs/types": "4.4.3"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/@shikijs/types": {
+ "version": "4.4.3",
+ "resolved": "https://registry.npmjs.org/@shikijs/types/-/types-4.4.3.tgz",
+ "integrity": "sha512-UEJxmRR++MAGR6hugn0vgVS2W/6lWAts84FFSrnlH9sP0LNol7E5+NQ792pH8liWUhyMyjhTgSUH3k7iD7tc5g==",
+ "license": "MIT",
+ "dependencies": {
+ "@shikijs/vscode-textmate": "^10.0.2",
+ "@types/hast": "^3.0.5"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/@shikijs/vscode-textmate": {
+ "version": "10.0.2",
+ "resolved": "https://registry.npmjs.org/@shikijs/vscode-textmate/-/vscode-textmate-10.0.2.tgz",
+ "integrity": "sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==",
+ "license": "MIT"
+ },
+ "node_modules/@tybys/wasm-util": {
+ "version": "0.10.3",
+ "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.3.tgz",
+ "integrity": "sha512-F3fo1MYrRJYL3zER0OUOmkutjr1Vp23m7OsSgp7nq4SP6OqX6C/56XFIPAl5bt3zaBRjmW7SGz3u/6LwFpYcOg==",
+ "license": "MIT",
+ "optional": true,
+ "dependencies": {
+ "tslib": "^2.4.0"
+ }
+ },
+ "node_modules/@types/debug": {
+ "version": "4.1.13",
+ "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.13.tgz",
+ "integrity": "sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/ms": "*"
+ }
+ },
+ "node_modules/@types/estree": {
+ "version": "1.0.9",
+ "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz",
+ "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==",
+ "license": "MIT"
+ },
+ "node_modules/@types/estree-jsx": {
+ "version": "1.0.5",
+ "resolved": "https://registry.npmjs.org/@types/estree-jsx/-/estree-jsx-1.0.5.tgz",
+ "integrity": "sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "*"
+ }
+ },
+ "node_modules/@types/hast": {
+ "version": "3.0.5",
+ "resolved": "https://registry.npmjs.org/@types/hast/-/hast-3.0.5.tgz",
+ "integrity": "sha512-rp/ezSWaD1m44dPKICGhiskI13nVr7qTloFwDa/IYkhhf5nzwP+zIQcIJh3WIFSBOy/H1PzB40jPjMDksN4F+g==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "*"
+ }
+ },
+ "node_modules/@types/js-yaml": {
+ "version": "4.0.9",
+ "resolved": "https://registry.npmjs.org/@types/js-yaml/-/js-yaml-4.0.9.tgz",
+ "integrity": "sha512-k4MGaQl5TGo/iipqb2UDG2UwjXziSWkh0uysQelTlJpX1qGlpUZYm8PnO4DxG1qBomtJUdYJ6qR6xdIah10JLg==",
+ "license": "MIT"
+ },
+ "node_modules/@types/mdast": {
+ "version": "4.0.4",
+ "resolved": "https://registry.npmjs.org/@types/mdast/-/mdast-4.0.4.tgz",
+ "integrity": "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "*"
+ }
+ },
+ "node_modules/@types/mdx": {
+ "version": "2.0.14",
+ "resolved": "https://registry.npmjs.org/@types/mdx/-/mdx-2.0.14.tgz",
+ "integrity": "sha512-T48PeuJtvLosNTPVhfnIp3i/n3a4g4Bad7YCq5k64D4u7NwDrAotikQ+5+sjtUvBmxCMlbo3dVL+C2dP0rWHzg==",
+ "license": "MIT"
+ },
+ "node_modules/@types/ms": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz",
+ "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==",
+ "license": "MIT"
+ },
+ "node_modules/@types/nlcst": {
+ "version": "2.0.3",
+ "resolved": "https://registry.npmjs.org/@types/nlcst/-/nlcst-2.0.3.tgz",
+ "integrity": "sha512-vSYNSDe6Ix3q+6Z7ri9lyWqgGhJTmzRjZRqyq15N0Z/1/UnVsno9G/N40NBijoYx2seFDIl0+B2mgAb9mezUCA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "*"
+ }
+ },
+ "node_modules/@types/node": {
+ "version": "24.13.3",
+ "resolved": "https://registry.npmjs.org/@types/node/-/node-24.13.3.tgz",
+ "integrity": "sha512-Dh8vAsV36ig5wa9OX4pXvMc9D3Veibfw2wix0CUwYODLD8nkj9UsLjASr49nPg+2eKzxhBV+v7L8pXvT4e639Q==",
+ "license": "MIT",
+ "dependencies": {
+ "undici-types": "~7.18.0"
+ }
+ },
+ "node_modules/@types/sax": {
+ "version": "1.2.7",
+ "resolved": "https://registry.npmjs.org/@types/sax/-/sax-1.2.7.tgz",
+ "integrity": "sha512-rO73L89PJxeYM3s3pPPjiPgVVcymqU490g0YO5n5By0k2Erzj6tay/4lr1CHAAU4JyOWd1rpQ8bCf6cZfHU96A==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/node": "*"
+ }
+ },
+ "node_modules/@types/unist": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/@types/unist/-/unist-3.0.3.tgz",
+ "integrity": "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==",
+ "license": "MIT"
+ },
+ "node_modules/@ungap/structured-clone": {
+ "version": "1.3.3",
+ "resolved": "https://registry.npmjs.org/@ungap/structured-clone/-/structured-clone-1.3.3.tgz",
+ "integrity": "sha512-60YRaenCQcVjYEKOcG824+DRGGIQ3VKErcBoAEDJZz5bKIs2ZG+X/H9Nk+Q6EVkwJk5QNApxbrc5QtBSwtrXAg==",
+ "license": "ISC"
+ },
+ "node_modules/@volar/kit": {
+ "version": "2.4.28",
+ "resolved": "https://registry.npmjs.org/@volar/kit/-/kit-2.4.28.tgz",
+ "integrity": "sha512-cKX4vK9dtZvDRaAzeoUdaAJEew6IdxHNCRrdp5Kvcl6zZOqb6jTOfk3kXkIkG3T7oTFXguEMt5+9ptyqYR84Pg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@volar/language-service": "2.4.28",
+ "@volar/typescript": "2.4.28",
+ "typesafe-path": "^0.2.2",
+ "vscode-languageserver-textdocument": "^1.0.11",
+ "vscode-uri": "^3.0.8"
+ },
+ "peerDependencies": {
+ "typescript": "*"
+ }
+ },
+ "node_modules/@volar/language-core": {
+ "version": "2.4.28",
+ "resolved": "https://registry.npmjs.org/@volar/language-core/-/language-core-2.4.28.tgz",
+ "integrity": "sha512-w4qhIJ8ZSitgLAkVay6AbcnC7gP3glYM3fYwKV3srj8m494E3xtrCv6E+bWviiK/8hs6e6t1ij1s2Endql7vzQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@volar/source-map": "2.4.28"
+ }
+ },
+ "node_modules/@volar/language-server": {
+ "version": "2.4.28",
+ "resolved": "https://registry.npmjs.org/@volar/language-server/-/language-server-2.4.28.tgz",
+ "integrity": "sha512-NqcLnE5gERKuS4PUFwlhMxf6vqYo7hXtbMFbViXcbVkbZ905AIVWhnSo0ZNBC2V127H1/2zP7RvVOVnyITFfBw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@volar/language-core": "2.4.28",
+ "@volar/language-service": "2.4.28",
+ "@volar/typescript": "2.4.28",
+ "path-browserify": "^1.0.1",
+ "request-light": "^0.7.0",
+ "vscode-languageserver": "^9.0.1",
+ "vscode-languageserver-protocol": "^3.17.5",
+ "vscode-languageserver-textdocument": "^1.0.11",
+ "vscode-uri": "^3.0.8"
+ }
+ },
+ "node_modules/@volar/language-service": {
+ "version": "2.4.28",
+ "resolved": "https://registry.npmjs.org/@volar/language-service/-/language-service-2.4.28.tgz",
+ "integrity": "sha512-Rh/wYCZJrI5vCwMk9xyw/Z+MsWxlJY1rmMZPsxUoJKfzIRjS/NF1NmnuEcrMbEVGja00aVpCsInJfixQTMdvLw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@volar/language-core": "2.4.28",
+ "vscode-languageserver-protocol": "^3.17.5",
+ "vscode-languageserver-textdocument": "^1.0.11",
+ "vscode-uri": "^3.0.8"
+ }
+ },
+ "node_modules/@volar/source-map": {
+ "version": "2.4.28",
+ "resolved": "https://registry.npmjs.org/@volar/source-map/-/source-map-2.4.28.tgz",
+ "integrity": "sha512-yX2BDBqJkRXfKw8my8VarTyjv48QwxdJtvRgUpNE5erCsgEUdI2DsLbpa+rOQVAJYshY99szEcRDmyHbF10ggQ==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@volar/typescript": {
+ "version": "2.4.28",
+ "resolved": "https://registry.npmjs.org/@volar/typescript/-/typescript-2.4.28.tgz",
+ "integrity": "sha512-Ja6yvWrbis2QtN4ClAKreeUZPVYMARDYZl9LMEv1iQ1QdepB6wn0jTRxA9MftYmYa4DQ4k/DaSZpFPUfxl8giw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@volar/language-core": "2.4.28",
+ "path-browserify": "^1.0.1",
+ "vscode-uri": "^3.0.8"
+ }
+ },
+ "node_modules/@vscode/emmet-helper": {
+ "version": "2.11.0",
+ "resolved": "https://registry.npmjs.org/@vscode/emmet-helper/-/emmet-helper-2.11.0.tgz",
+ "integrity": "sha512-QLxjQR3imPZPQltfbWRnHU6JecWTF1QSWhx3GAKQpslx7y3Dp6sIIXhKjiUJ/BR9FX8PVthjr9PD6pNwOJfAzw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "emmet": "^2.4.3",
+ "jsonc-parser": "^2.3.0",
+ "vscode-languageserver-textdocument": "^1.0.1",
+ "vscode-languageserver-types": "^3.15.1",
+ "vscode-uri": "^3.0.8"
+ }
+ },
+ "node_modules/@vscode/emmet-helper/node_modules/jsonc-parser": {
+ "version": "2.3.1",
+ "resolved": "https://registry.npmjs.org/jsonc-parser/-/jsonc-parser-2.3.1.tgz",
+ "integrity": "sha512-H8jvkz1O50L3dMZCsLqiuB2tA7muqbSg1AtGEkN0leAqGjsUzDJir3Zwr02BhqdcITPg3ei3mZ+HjMocAknhhg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/@vscode/l10n": {
+ "version": "0.0.18",
+ "resolved": "https://registry.npmjs.org/@vscode/l10n/-/l10n-0.0.18.tgz",
+ "integrity": "sha512-KYSIHVmslkaCDyw013pphY+d7x1qV8IZupYfeIfzNA+nsaWHbn5uPuQRvdRFsa9zFzGeudPuoGoZ1Op4jrJXIQ==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/acorn": {
+ "version": "8.18.0",
+ "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.18.0.tgz",
+ "integrity": "sha512-lGq+9yr1/GuAWaVYIHRjvvySG5/4VfKIvC8EWxStPdcDh/Ka7FG3twP6v4d5BkravUilhIAsG4Qj83t02LWUPQ==",
+ "license": "MIT",
+ "bin": {
+ "acorn": "bin/acorn"
+ },
+ "engines": {
+ "node": ">=0.4.0"
+ }
+ },
+ "node_modules/acorn-jsx": {
+ "version": "5.3.2",
+ "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz",
+ "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==",
+ "license": "MIT",
+ "peerDependencies": {
+ "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0"
+ }
+ },
+ "node_modules/ajv": {
+ "version": "8.20.0",
+ "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+ "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "fast-deep-equal": "^3.1.3",
+ "fast-uri": "^3.0.1",
+ "json-schema-traverse": "^1.0.0",
+ "require-from-string": "^2.0.2"
+ },
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/epoberezkin"
+ }
+ },
+ "node_modules/ajv-draft-04": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/ajv-draft-04/-/ajv-draft-04-1.0.0.tgz",
+ "integrity": "sha512-mv00Te6nmYbRp5DCwclxtt7yV/joXJPGS7nM+97GdxvuttCOfgI3K4U25zboyeX0O+myI8ERluxQe5wljMmVIw==",
+ "dev": true,
+ "license": "MIT",
+ "peerDependencies": {
+ "ajv": "^8.5.0"
+ },
+ "peerDependenciesMeta": {
+ "ajv": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/ajv-i18n": {
+ "version": "4.2.0",
+ "resolved": "https://registry.npmjs.org/ajv-i18n/-/ajv-i18n-4.2.0.tgz",
+ "integrity": "sha512-v/ei2UkCEeuKNXh8RToiFsUclmU+G57LO1Oo22OagNMENIw+Yb8eMwvHu7Vn9fmkjJyv6XclhJ8TbuigSglPkg==",
+ "dev": true,
+ "license": "MIT",
+ "peerDependencies": {
+ "ajv": "^8.0.0-beta.0"
+ }
+ },
+ "node_modules/am-i-vibing": {
+ "version": "0.4.0",
+ "resolved": "https://registry.npmjs.org/am-i-vibing/-/am-i-vibing-0.4.0.tgz",
+ "integrity": "sha512-MxT4XZL7pzLHpuvhDKdMaQHMGGkJDLluKBLsbstn+8wv9sWcFT6h+0ve9qkml95amVTZtZV83gQe2hY+ojgHLg==",
+ "license": "MIT",
+ "dependencies": {
+ "process-ancestry": "^0.1.0"
+ },
+ "bin": {
+ "am-i-vibing": "dist/cli.mjs"
+ }
+ },
+ "node_modules/ansi-regex": {
+ "version": "6.3.0",
+ "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.3.0.tgz",
+ "integrity": "sha512-WpDfL7NO6j7tH88IDBNVdUJxDh9nmCteAVW9dsep846XdwF4naCBK+/tGLX3KJgcpgMRXCFlTM2hKGoK9FsdrQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+ }
+ },
+ "node_modules/ansi-styles": {
+ "version": "4.3.0",
+ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+ "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+ "license": "MIT",
+ "dependencies": {
+ "color-convert": "^2.0.1"
+ },
+ "engines": {
+ "node": ">=8"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+ }
+ },
+ "node_modules/anymatch": {
+ "version": "3.1.3",
+ "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz",
+ "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==",
+ "license": "ISC",
+ "dependencies": {
+ "normalize-path": "^3.0.0",
+ "picomatch": "^2.0.4"
+ },
+ "engines": {
+ "node": ">= 8"
+ }
+ },
+ "node_modules/anymatch/node_modules/picomatch": {
+ "version": "2.3.2",
+ "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
+ "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=8.6"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/jonschlinkert"
+ }
+ },
+ "node_modules/arg": {
+ "version": "5.0.2",
+ "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz",
+ "integrity": "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==",
+ "license": "MIT"
+ },
+ "node_modules/argparse": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
+ "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
+ "license": "Python-2.0"
+ },
+ "node_modules/aria-query": {
+ "version": "5.3.2",
+ "resolved": "https://registry.npmjs.org/aria-query/-/aria-query-5.3.2.tgz",
+ "integrity": "sha512-COROpnaoap1E2F000S62r6A60uHZnmlvomhfyT2DlTcrY1OrBKn2UhH7qn5wTC9zMvD0AY7csdPSNwKP+7WiQw==",
+ "license": "Apache-2.0",
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/array-iterate": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/array-iterate/-/array-iterate-2.0.1.tgz",
+ "integrity": "sha512-I1jXZMjAgCMmxT4qxXfPXa6SthSoE8h6gkSI9BGGNv8mP8G/v0blc+qFnZu6K42vTOiuME596QaLO0TP3Lk0xg==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/astring": {
+ "version": "1.9.0",
+ "resolved": "https://registry.npmjs.org/astring/-/astring-1.9.0.tgz",
+ "integrity": "sha512-LElXdjswlqjWrPpJFg1Fx4wpkOCxj1TDHlSV4PlaRxHGWko024xICaa97ZkMfs6DRKlCguiAI+rbXv5GWwXIkg==",
+ "license": "MIT",
+ "bin": {
+ "astring": "bin/astring"
+ }
+ },
+ "node_modules/astro": {
+ "version": "7.2.4",
+ "resolved": "https://registry.npmjs.org/astro/-/astro-7.2.4.tgz",
+ "integrity": "sha512-+cuLsBns2wwUHI9a10xZMbjrF91m7+QNwqTVeljTx0B8Lf+8h0LgVGjdVIL2FALDKD2I565lczeeS3BFC+KdZg==",
+ "license": "MIT",
+ "dependencies": {
+ "@astrojs/compiler-rs": "^0.3.2",
+ "@astrojs/internal-helpers": "0.10.4",
+ "@astrojs/markdown-satteri": "0.3.7",
+ "@astrojs/telemetry": "3.3.3",
+ "@capsizecss/unpack": "^4.0.0",
+ "@clack/prompts": "^1.1.0",
+ "@oslojs/encoding": "^1.1.0",
+ "am-i-vibing": "^0.4.0",
+ "aria-query": "^5.3.2",
+ "axobject-query": "^4.1.0",
+ "ci-info": "^4.4.0",
+ "clsx": "^2.1.1",
+ "common-ancestor-path": "^2.0.0",
+ "cookie": "^2.0.1",
+ "devalue": "^5.8.1",
+ "diff": "^8.0.3",
+ "dset": "^3.1.4",
+ "es-module-lexer": "^2.0.0",
+ "esbuild": "^0.28.0",
+ "find-process": "^2.1.1",
+ "flattie": "^1.1.1",
+ "fontace": "~0.4.1",
+ "get-tsconfig": "5.0.0-beta.4",
+ "github-slugger": "^2.0.0",
+ "html-escaper": "3.0.3",
+ "http-cache-semantics": "^4.2.0",
+ "js-yaml": "^4.3.0",
+ "jsonc-parser": "^3.3.1",
+ "magic-string": "^1.0.0",
+ "magicast": "^0.5.2",
+ "mrmime": "^2.0.1",
+ "neotraverse": "^1.0.1",
+ "obug": "^2.1.1",
+ "p-limit": "^7.3.0",
+ "p-queue": "^9.1.0",
+ "package-manager-detector": "^1.6.0",
+ "piccolore": "^0.1.3",
+ "picomatch": "^4.0.4",
+ "semver": "^7.7.4",
+ "shiki": "^4.0.2",
+ "smol-toml": "^1.6.0",
+ "svgo": "^4.0.1",
+ "tinyclip": "^0.1.12",
+ "tinyexec": "^1.0.4",
+ "tinyglobby": "^0.2.15",
+ "ultrahtml": "^1.6.0",
+ "unifont": "~0.7.5",
+ "unstorage": "^1.17.5",
+ "vite": "^8.0.13",
+ "vitefu": "^1.1.2",
+ "xxhash-wasm": "^1.1.0",
+ "yargs-parser": "^22.0.0",
+ "zod": "^4.3.6"
+ },
+ "bin": {
+ "astro": "bin/astro.mjs"
+ },
+ "engines": {
+ "node": ">=22.12.0",
+ "npm": ">=9.6.5",
+ "pnpm": ">=7.1.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/astrodotbuild"
+ },
+ "optionalDependencies": {
+ "sharp": "^0.34.0 || ^0.35.0"
+ },
+ "peerDependencies": {
+ "@astrojs/markdown-remark": "7.2.4"
+ },
+ "peerDependenciesMeta": {
+ "@astrojs/markdown-remark": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/astro-expressive-code": {
+ "version": "0.44.1",
+ "resolved": "https://registry.npmjs.org/astro-expressive-code/-/astro-expressive-code-0.44.1.tgz",
+ "integrity": "sha512-DT1LnCqbHasBKlvzJ3m6LR4VI94wwx3W9EV/YbP1te4rqjOHsvsezHYuqb5MeLWLftXms/1FA9QBbwCo43DnJQ==",
+ "license": "MIT",
+ "dependencies": {
+ "rehype-expressive-code": "^0.44.1",
+ "url-extras": "^0.1.0"
+ },
+ "peerDependencies": {
+ "astro": "^4.0.0-beta || ^5.0.0-beta || ^3.3.0 || ^6.0.0-beta || ^7.0.0"
+ }
+ },
+ "node_modules/astro/node_modules/magic-string": {
+ "version": "1.2.2",
+ "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-1.2.2.tgz",
+ "integrity": "sha512-veT/+7iXrXzT39XnEN4lOxtNl72dMgJ8Lp+5Bd6YcMSWpb0n0MjBM8Uuooi6jgJr8dhUW2swQgBmoZVMni5SVg==",
+ "license": "MIT",
+ "dependencies": {
+ "@jridgewell/sourcemap-codec": "^1.5.5"
+ }
+ },
+ "node_modules/axobject-query": {
+ "version": "4.1.0",
+ "resolved": "https://registry.npmjs.org/axobject-query/-/axobject-query-4.1.0.tgz",
+ "integrity": "sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==",
+ "license": "Apache-2.0",
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/bail": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/bail/-/bail-2.0.2.tgz",
+ "integrity": "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/bcp-47": {
+ "version": "2.1.1",
+ "resolved": "https://registry.npmjs.org/bcp-47/-/bcp-47-2.1.1.tgz",
+ "integrity": "sha512-KLw+H/gd2p4zly1X7Yh/qziuyae5/w/QFnvTng9eZL5fvszL7Whl3MBoWF8yxL7ksUjBfOD+OxkytiqbBpG+Fw==",
+ "license": "MIT",
+ "dependencies": {
+ "is-alphabetical": "^2.0.0",
+ "is-alphanumerical": "^2.0.0",
+ "is-decimal": "^2.0.0"
+ },
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/bcp-47-match": {
+ "version": "2.0.3",
+ "resolved": "https://registry.npmjs.org/bcp-47-match/-/bcp-47-match-2.0.3.tgz",
+ "integrity": "sha512-JtTezzbAibu8G0R9op9zb3vcWZd9JF6M0xOYGPn0fNCd7wOpRB1mU2mH9T8gaBGbAAyIIVgB2G7xG0GP98zMAQ==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/boolbase": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz",
+ "integrity": "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==",
+ "license": "ISC"
+ },
+ "node_modules/ccount": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/ccount/-/ccount-2.0.1.tgz",
+ "integrity": "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/chalk": {
+ "version": "4.1.2",
+ "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+ "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
+ "license": "MIT",
+ "dependencies": {
+ "ansi-styles": "^4.1.0",
+ "supports-color": "^7.1.0"
+ },
+ "engines": {
+ "node": ">=10"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/chalk?sponsor=1"
+ }
+ },
+ "node_modules/character-entities": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/character-entities/-/character-entities-2.0.2.tgz",
+ "integrity": "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/character-entities-html4": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/character-entities-html4/-/character-entities-html4-2.1.0.tgz",
+ "integrity": "sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/character-entities-legacy": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/character-entities-legacy/-/character-entities-legacy-3.0.0.tgz",
+ "integrity": "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/character-reference-invalid": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/character-reference-invalid/-/character-reference-invalid-2.0.1.tgz",
+ "integrity": "sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/chokidar": {
+ "version": "4.0.3",
+ "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-4.0.3.tgz",
+ "integrity": "sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "readdirp": "^4.0.1"
+ },
+ "engines": {
+ "node": ">= 14.16.0"
+ },
+ "funding": {
+ "url": "https://paulmillr.com/funding/"
+ }
+ },
+ "node_modules/ci-info": {
+ "version": "4.4.0",
+ "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-4.4.0.tgz",
+ "integrity": "sha512-77PSwercCZU2Fc4sX94eF8k8Pxte6JAwL4/ICZLFjJLqegs7kCuAsqqj/70NQF6TvDpgFjkubQB2FW2ZZddvQg==",
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/sibiraj-s"
+ }
+ ],
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/cliui": {
+ "version": "9.0.1",
+ "resolved": "https://registry.npmjs.org/cliui/-/cliui-9.0.1.tgz",
+ "integrity": "sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==",
+ "dev": true,
+ "license": "ISC",
+ "dependencies": {
+ "string-width": "^7.2.0",
+ "strip-ansi": "^7.1.0",
+ "wrap-ansi": "^9.0.0"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/cliui/node_modules/string-width": {
+ "version": "7.2.0",
+ "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",
+ "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "emoji-regex": "^10.3.0",
+ "get-east-asian-width": "^1.0.0",
+ "strip-ansi": "^7.1.0"
+ },
+ "engines": {
+ "node": ">=18"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/clsx": {
+ "version": "2.1.1",
+ "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz",
+ "integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/collapse-white-space": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/collapse-white-space/-/collapse-white-space-2.1.0.tgz",
+ "integrity": "sha512-loKTxY1zCOuG4j9f6EPnuyyYkf58RnhhWTvRoZEokgB+WbdXehfjFviyOVYkqzEWz1Q5kRiZdBYS5SwxbQYwzw==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/color-convert": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+ "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+ "license": "MIT",
+ "dependencies": {
+ "color-name": "~1.1.4"
+ },
+ "engines": {
+ "node": ">=7.0.0"
+ }
+ },
+ "node_modules/color-name": {
+ "version": "1.1.4",
+ "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+ "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+ "license": "MIT"
+ },
+ "node_modules/comma-separated-tokens": {
+ "version": "2.0.3",
+ "resolved": "https://registry.npmjs.org/comma-separated-tokens/-/comma-separated-tokens-2.0.3.tgz",
+ "integrity": "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/commander": {
+ "version": "14.0.3",
+ "resolved": "https://registry.npmjs.org/commander/-/commander-14.0.3.tgz",
+ "integrity": "sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/common-ancestor-path": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/common-ancestor-path/-/common-ancestor-path-2.0.0.tgz",
+ "integrity": "sha512-dnN3ibLeoRf2HNC+OlCiNc5d2zxbLJXOtiZUudNFSXZrNSydxcCsSpRzXwfu7BBWCIfHPw+xTayeBvJCP/D8Ng==",
+ "license": "BlueOak-1.0.0",
+ "engines": {
+ "node": ">= 18"
+ }
+ },
+ "node_modules/cookie": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/cookie/-/cookie-2.0.1.tgz",
+ "integrity": "sha512-yuToqVvRrj6pfDXREyQAAv8SkAEk/8GS3jQRTiUMm66TVtBYmqQeoEjL2Lmq8Rpo6271vH76InTChTitEAm65w==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=22"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/express"
+ }
+ },
+ "node_modules/cookie-es": {
+ "version": "1.2.3",
+ "resolved": "https://registry.npmjs.org/cookie-es/-/cookie-es-1.2.3.tgz",
+ "integrity": "sha512-lXVyvUvrNXblMqzIRrxHb57UUVmqsSWlxqt3XIjCkUP0wDAf6uicO6KMbEgYrMNtEvWgWHwe42CKxPu9MYAnWw==",
+ "license": "MIT"
+ },
+ "node_modules/crossws": {
+ "version": "0.3.5",
+ "resolved": "https://registry.npmjs.org/crossws/-/crossws-0.3.5.tgz",
+ "integrity": "sha512-ojKiDvcmByhwa8YYqbQI/hg7MEU0NC03+pSdEq4ZUnZR9xXpwk7E43SMNGkn+JxJGPFtNvQ48+vV2p+P1ml5PA==",
+ "license": "MIT",
+ "dependencies": {
+ "uncrypto": "^0.1.3"
+ }
+ },
+ "node_modules/css-select": {
+ "version": "5.2.2",
+ "resolved": "https://registry.npmjs.org/css-select/-/css-select-5.2.2.tgz",
+ "integrity": "sha512-TizTzUddG/xYLA3NXodFM0fSbNizXjOKhqiQQwvhlspadZokn1KDy0NZFS0wuEubIYAV5/c1/lAr0TaaFXEXzw==",
+ "license": "BSD-2-Clause",
+ "dependencies": {
+ "boolbase": "^1.0.0",
+ "css-what": "^6.1.0",
+ "domhandler": "^5.0.2",
+ "domutils": "^3.0.1",
+ "nth-check": "^2.0.1"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/fb55"
+ }
+ },
+ "node_modules/css-selector-parser": {
+ "version": "3.3.0",
+ "resolved": "https://registry.npmjs.org/css-selector-parser/-/css-selector-parser-3.3.0.tgz",
+ "integrity": "sha512-Y2asgMGFqJKF4fq4xHDSlFYIkeVfRsm69lQC1q9kbEsH5XtnINTMrweLkjYMeaUgiXBy/uvKeO/a1JHTNnmB2g==",
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/mdevils"
+ },
+ {
+ "type": "patreon",
+ "url": "https://patreon.com/mdevils"
+ }
+ ],
+ "license": "MIT"
+ },
+ "node_modules/css-tree": {
+ "version": "3.2.1",
+ "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-3.2.1.tgz",
+ "integrity": "sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==",
+ "license": "MIT",
+ "dependencies": {
+ "mdn-data": "2.27.1",
+ "source-map-js": "^1.2.1"
+ },
+ "engines": {
+ "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0"
+ }
+ },
+ "node_modules/css-what": {
+ "version": "6.2.2",
+ "resolved": "https://registry.npmjs.org/css-what/-/css-what-6.2.2.tgz",
+ "integrity": "sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==",
+ "license": "BSD-2-Clause",
+ "engines": {
+ "node": ">= 6"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/fb55"
+ }
+ },
+ "node_modules/cssesc": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz",
+ "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==",
+ "license": "MIT",
+ "bin": {
+ "cssesc": "bin/cssesc"
+ },
+ "engines": {
+ "node": ">=4"
+ }
+ },
+ "node_modules/csso": {
+ "version": "5.0.5",
+ "resolved": "https://registry.npmjs.org/csso/-/csso-5.0.5.tgz",
+ "integrity": "sha512-0LrrStPOdJj+SPCCrGhzryycLjwcgUSHBtxNA8aIDxf0GLsRh1cKYhB00Gd1lDOS4yGH69+SNn13+TWbVHETFQ==",
+ "license": "MIT",
+ "dependencies": {
+ "css-tree": "~2.2.0"
+ },
+ "engines": {
+ "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0",
+ "npm": ">=7.0.0"
+ }
+ },
+ "node_modules/csso/node_modules/css-tree": {
+ "version": "2.2.1",
+ "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-2.2.1.tgz",
+ "integrity": "sha512-OA0mILzGc1kCOCSJerOeqDxDQ4HOh+G8NbOJFOTgOCzpw7fCBubk0fEyxp8AgOL/jvLgYA/uV0cMbe43ElF1JA==",
+ "license": "MIT",
+ "dependencies": {
+ "mdn-data": "2.0.28",
+ "source-map-js": "^1.0.1"
+ },
+ "engines": {
+ "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0",
+ "npm": ">=7.0.0"
+ }
+ },
+ "node_modules/csso/node_modules/mdn-data": {
+ "version": "2.0.28",
+ "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.0.28.tgz",
+ "integrity": "sha512-aylIc7Z9y4yzHYAJNuESG3hfhC+0Ibp/MAMiaOZgNv4pmEdFyfZhhhny4MNiAfWdBQ1RQ2mfDWmM1x8SvGyp8g==",
+ "license": "CC0-1.0"
+ },
+ "node_modules/debug": {
+ "version": "4.4.3",
+ "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+ "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+ "license": "MIT",
+ "dependencies": {
+ "ms": "^2.1.3"
+ },
+ "engines": {
+ "node": ">=6.0"
+ },
+ "peerDependenciesMeta": {
+ "supports-color": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/decode-named-character-reference": {
+ "version": "1.3.0",
+ "resolved": "https://registry.npmjs.org/decode-named-character-reference/-/decode-named-character-reference-1.3.0.tgz",
+ "integrity": "sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==",
+ "license": "MIT",
+ "dependencies": {
+ "character-entities": "^2.0.0"
+ },
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/defu": {
+ "version": "6.1.7",
+ "resolved": "https://registry.npmjs.org/defu/-/defu-6.1.7.tgz",
+ "integrity": "sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==",
+ "license": "MIT"
+ },
+ "node_modules/dequal": {
+ "version": "2.0.3",
+ "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz",
+ "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/destr": {
+ "version": "2.0.5",
+ "resolved": "https://registry.npmjs.org/destr/-/destr-2.0.5.tgz",
+ "integrity": "sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==",
+ "license": "MIT"
+ },
+ "node_modules/detect-libc": {
+ "version": "2.1.2",
+ "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+ "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
+ "license": "Apache-2.0",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/devalue": {
+ "version": "5.9.1",
+ "resolved": "https://registry.npmjs.org/devalue/-/devalue-5.9.1.tgz",
+ "integrity": "sha512-+17vil3EVQRzvtDJSFuTWEb8XJRvXqAiV3qZyQWD398QeXUa6CxsUyMdD1fxzEhUrd4FojitFz7lhIHBTlV4fw==",
+ "license": "MIT"
+ },
+ "node_modules/devlop": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/devlop/-/devlop-1.1.0.tgz",
+ "integrity": "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==",
+ "license": "MIT",
+ "dependencies": {
+ "dequal": "^2.0.0"
+ },
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/diff": {
+ "version": "8.0.4",
+ "resolved": "https://registry.npmjs.org/diff/-/diff-8.0.4.tgz",
+ "integrity": "sha512-DPi0FmjiSU5EvQV0++GFDOJ9ASQUVFh5kD+OzOnYdi7n3Wpm9hWWGfB/O2blfHcMVTL5WkQXSnRiK9makhrcnw==",
+ "license": "BSD-3-Clause",
+ "engines": {
+ "node": ">=0.3.1"
+ }
+ },
+ "node_modules/direction": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/direction/-/direction-2.0.1.tgz",
+ "integrity": "sha512-9S6m9Sukh1cZNknO1CWAr2QAWsbKLafQiyM5gZ7VgXHeuaoUwffKN4q6NC4A/Mf9iiPlOXQEKW/Mv/mh9/3YFA==",
+ "license": "MIT",
+ "bin": {
+ "direction": "cli.js"
+ },
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/dom-serializer": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-2.0.0.tgz",
+ "integrity": "sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==",
+ "license": "MIT",
+ "dependencies": {
+ "domelementtype": "^2.3.0",
+ "domhandler": "^5.0.2",
+ "entities": "^4.2.0"
+ },
+ "funding": {
+ "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1"
+ }
+ },
+ "node_modules/dom-serializer/node_modules/entities": {
+ "version": "4.5.0",
+ "resolved": "https://registry.npmjs.org/entities/-/entities-4.5.0.tgz",
+ "integrity": "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==",
+ "license": "BSD-2-Clause",
+ "engines": {
+ "node": ">=0.12"
+ },
+ "funding": {
+ "url": "https://github.com/fb55/entities?sponsor=1"
+ }
+ },
+ "node_modules/domelementtype": {
+ "version": "2.3.0",
+ "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz",
+ "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==",
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/fb55"
+ }
+ ],
+ "license": "BSD-2-Clause"
+ },
+ "node_modules/domhandler": {
+ "version": "5.0.3",
+ "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-5.0.3.tgz",
+ "integrity": "sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==",
+ "license": "BSD-2-Clause",
+ "dependencies": {
+ "domelementtype": "^2.3.0"
+ },
+ "engines": {
+ "node": ">= 4"
+ },
+ "funding": {
+ "url": "https://github.com/fb55/domhandler?sponsor=1"
+ }
+ },
+ "node_modules/domutils": {
+ "version": "3.2.2",
+ "resolved": "https://registry.npmjs.org/domutils/-/domutils-3.2.2.tgz",
+ "integrity": "sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==",
+ "license": "BSD-2-Clause",
+ "dependencies": {
+ "dom-serializer": "^2.0.0",
+ "domelementtype": "^2.3.0",
+ "domhandler": "^5.0.3"
+ },
+ "funding": {
+ "url": "https://github.com/fb55/domutils?sponsor=1"
+ }
+ },
+ "node_modules/dset": {
+ "version": "3.1.4",
+ "resolved": "https://registry.npmjs.org/dset/-/dset-3.1.4.tgz",
+ "integrity": "sha512-2QF/g9/zTaPDc3BjNcVTGoBbXBgYfMTTceLaYcFJ/W9kggFUkhxD/hMEeuLKbugyef9SqAx8cpgwlIP/jinUTA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=4"
+ }
+ },
+ "node_modules/emmet": {
+ "version": "2.4.11",
+ "resolved": "https://registry.npmjs.org/emmet/-/emmet-2.4.11.tgz",
+ "integrity": "sha512-23QPJB3moh/U9sT4rQzGgeyyGIrcM+GH5uVYg2C6wZIxAIJq7Ng3QLT79tl8FUwDXhyq9SusfknOrofAKqvgyQ==",
+ "dev": true,
+ "license": "MIT",
+ "workspaces": [
+ "./packages/scanner",
+ "./packages/abbreviation",
+ "./packages/css-abbreviation",
+ "./"
+ ],
+ "dependencies": {
+ "@emmetio/abbreviation": "^2.3.3",
+ "@emmetio/css-abbreviation": "^2.1.8"
+ }
+ },
+ "node_modules/emoji-regex": {
+ "version": "10.6.0",
+ "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz",
+ "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/entities": {
+ "version": "6.0.1",
+ "resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz",
+ "integrity": "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==",
+ "license": "BSD-2-Clause",
+ "engines": {
+ "node": ">=0.12"
+ },
+ "funding": {
+ "url": "https://github.com/fb55/entities?sponsor=1"
+ }
+ },
+ "node_modules/es-module-lexer": {
+ "version": "2.3.2",
+ "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-2.3.2.tgz",
+ "integrity": "sha512-poHGpORABojJJucnV9KbOavETW8lBVnphkW77ER5/BQ5Fz7oXSoCNek7IH3vR5nRjdsEz926ibFYX8KtLQmdyw==",
+ "license": "MIT"
+ },
+ "node_modules/esast-util-from-estree": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/esast-util-from-estree/-/esast-util-from-estree-2.0.0.tgz",
+ "integrity": "sha512-4CyanoAudUSBAn5K13H4JhsMH6L9ZP7XbLVe/dKybkxMO7eDyLsT8UHl9TRNrU2Gr9nz+FovfSIjuXWJ81uVwQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree-jsx": "^1.0.0",
+ "devlop": "^1.0.0",
+ "estree-util-visit": "^2.0.0",
+ "unist-util-position-from-estree": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/esast-util-from-js": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/esast-util-from-js/-/esast-util-from-js-2.0.1.tgz",
+ "integrity": "sha512-8Ja+rNJ0Lt56Pcf3TAmpBZjmx8ZcK5Ts4cAzIOjsjevg9oSXJnl6SUQ2EevU8tv3h6ZLWmoKL5H4fgWvdvfETw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree-jsx": "^1.0.0",
+ "acorn": "^8.0.0",
+ "esast-util-from-estree": "^2.0.0",
+ "vfile-message": "^4.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/esbuild": {
+ "version": "0.28.2",
+ "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.2.tgz",
+ "integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==",
+ "hasInstallScript": true,
+ "license": "MIT",
+ "bin": {
+ "esbuild": "bin/esbuild"
+ },
+ "engines": {
+ "node": ">=18"
+ },
+ "optionalDependencies": {
+ "@esbuild/aix-ppc64": "0.28.2",
+ "@esbuild/android-arm": "0.28.2",
+ "@esbuild/android-arm64": "0.28.2",
+ "@esbuild/android-x64": "0.28.2",
+ "@esbuild/darwin-arm64": "0.28.2",
+ "@esbuild/darwin-x64": "0.28.2",
+ "@esbuild/freebsd-arm64": "0.28.2",
+ "@esbuild/freebsd-x64": "0.28.2",
+ "@esbuild/linux-arm": "0.28.2",
+ "@esbuild/linux-arm64": "0.28.2",
+ "@esbuild/linux-ia32": "0.28.2",
+ "@esbuild/linux-loong64": "0.28.2",
+ "@esbuild/linux-mips64el": "0.28.2",
+ "@esbuild/linux-ppc64": "0.28.2",
+ "@esbuild/linux-riscv64": "0.28.2",
+ "@esbuild/linux-s390x": "0.28.2",
+ "@esbuild/linux-x64": "0.28.2",
+ "@esbuild/netbsd-arm64": "0.28.2",
+ "@esbuild/netbsd-x64": "0.28.2",
+ "@esbuild/openbsd-arm64": "0.28.2",
+ "@esbuild/openbsd-x64": "0.28.2",
+ "@esbuild/openharmony-arm64": "0.28.2",
+ "@esbuild/sunos-x64": "0.28.2",
+ "@esbuild/win32-arm64": "0.28.2",
+ "@esbuild/win32-ia32": "0.28.2",
+ "@esbuild/win32-x64": "0.28.2"
+ }
+ },
+ "node_modules/escalade": {
+ "version": "3.2.0",
+ "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+ "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/escape-string-regexp": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz",
+ "integrity": "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/estree-util-attach-comments": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/estree-util-attach-comments/-/estree-util-attach-comments-3.0.0.tgz",
+ "integrity": "sha512-cKUwm/HUcTDsYh/9FgnuFqpfquUbwIqwKM26BVCGDPVgvaCl/nDCCjUfiLlx6lsEZ3Z4RFxNbOQ60pkaEwFxGw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/estree-util-build-jsx": {
+ "version": "3.0.1",
+ "resolved": "https://registry.npmjs.org/estree-util-build-jsx/-/estree-util-build-jsx-3.0.1.tgz",
+ "integrity": "sha512-8U5eiL6BTrPxp/CHbs2yMgP8ftMhR5ww1eIKoWRMlqvltHF8fZn5LRDvTKuxD3DUn+shRbLGqXemcP51oFCsGQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree-jsx": "^1.0.0",
+ "devlop": "^1.0.0",
+ "estree-util-is-identifier-name": "^3.0.0",
+ "estree-walker": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/estree-util-is-identifier-name": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/estree-util-is-identifier-name/-/estree-util-is-identifier-name-3.0.0.tgz",
+ "integrity": "sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==",
+ "license": "MIT",
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/estree-util-scope": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/estree-util-scope/-/estree-util-scope-1.0.0.tgz",
+ "integrity": "sha512-2CAASclonf+JFWBNJPndcOpA8EMJwa0Q8LUFJEKqXLW6+qBvbFZuF5gItbQOs/umBUkjviCSDCbBwU2cXbmrhQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "devlop": "^1.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/estree-util-to-js": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/estree-util-to-js/-/estree-util-to-js-2.0.0.tgz",
+ "integrity": "sha512-WDF+xj5rRWmD5tj6bIqRi6CkLIXbbNQUcxQHzGysQzvHmdYG2G7p/Tf0J0gpxGgkeMZNTIjT/AoSvC9Xehcgdg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree-jsx": "^1.0.0",
+ "astring": "^1.8.0",
+ "source-map": "^0.7.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/estree-util-visit": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/estree-util-visit/-/estree-util-visit-2.0.0.tgz",
+ "integrity": "sha512-m5KgiH85xAhhW8Wta0vShLcUvOsh3LLPI2YVwcbio1l7E09NTLL1EyMZFM1OyWowoH0skScNbhOPl4kcBgzTww==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree-jsx": "^1.0.0",
+ "@types/unist": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/estree-walker": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
+ "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0"
+ }
+ },
+ "node_modules/eventemitter3": {
+ "version": "5.0.4",
+ "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz",
+ "integrity": "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==",
+ "license": "MIT"
+ },
+ "node_modules/expressive-code": {
+ "version": "0.44.1",
+ "resolved": "https://registry.npmjs.org/expressive-code/-/expressive-code-0.44.1.tgz",
+ "integrity": "sha512-GakidxhapWDzpKLqEaFQ8wGk6gAqEtPQibu8+yPBfnDLgev5Vdsh1pasTxnrXL/mzIknyqeTwhMHTghdaiUrTg==",
+ "license": "MIT",
+ "dependencies": {
+ "@expressive-code/core": "^0.44.1",
+ "@expressive-code/plugin-frames": "^0.44.1",
+ "@expressive-code/plugin-shiki": "^0.44.1",
+ "@expressive-code/plugin-text-markers": "^0.44.1"
+ }
+ },
+ "node_modules/extend": {
+ "version": "3.0.2",
+ "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz",
+ "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==",
+ "license": "MIT"
+ },
+ "node_modules/fast-deep-equal": {
+ "version": "3.1.3",
+ "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+ "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/fast-string-truncated-width": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/fast-string-truncated-width/-/fast-string-truncated-width-3.0.3.tgz",
+ "integrity": "sha512-0jjjIEL6+0jag3l2XWWizO64/aZVtpiGE3t0Zgqxv0DPuxiMjvB3M24fCyhZUO4KomJQPj3LTSUnDP3GpdwC0g==",
+ "license": "MIT"
+ },
+ "node_modules/fast-string-width": {
+ "version": "3.0.2",
+ "resolved": "https://registry.npmjs.org/fast-string-width/-/fast-string-width-3.0.2.tgz",
+ "integrity": "sha512-gX8LrtNEI5hq8DVUfRQMbr5lpaS4nMIWV+7XEbXk2b8kiQIizgnlr12B4dA3ZEx3308ze0O4Q1R+cHts8kyUJg==",
+ "license": "MIT",
+ "dependencies": {
+ "fast-string-truncated-width": "^3.0.2"
+ }
+ },
+ "node_modules/fast-uri": {
+ "version": "3.1.5",
+ "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.5.tgz",
+ "integrity": "sha512-gHwA1O9LDIcKunMKhObS/HimwtehO1nPUECKAu5TpKgaO19fcWEl4bliWe1jWxVFvIXztJjjQ4L8XQ1EU9f7Jw==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/fastify"
+ },
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/fastify"
+ }
+ ],
+ "license": "BSD-3-Clause"
+ },
+ "node_modules/fast-wrap-ansi": {
+ "version": "0.2.2",
+ "resolved": "https://registry.npmjs.org/fast-wrap-ansi/-/fast-wrap-ansi-0.2.2.tgz",
+ "integrity": "sha512-7F2Fl+TjRSenLqlU3UjSH0iyqopqoZIu7eZVpEirP2g1GtWa2G/ecEmBdgz31+Mxr+ELclgg6sokpSFIQiZ02Q==",
+ "license": "MIT",
+ "dependencies": {
+ "fast-string-width": "^3.0.2"
+ }
+ },
+ "node_modules/fdir": {
+ "version": "6.5.0",
+ "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+ "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=12.0.0"
+ },
+ "peerDependencies": {
+ "picomatch": "^3 || ^4"
+ },
+ "peerDependenciesMeta": {
+ "picomatch": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/find-process": {
+ "version": "2.1.1",
+ "resolved": "https://registry.npmjs.org/find-process/-/find-process-2.1.1.tgz",
+ "integrity": "sha512-SrQDx3QhlmHM90iqn9rdjCQcw/T+WlpOkHFsjoRgB+zTpDfltNA1VSNYeYELwhUTJy12UFxqjWhmhOrJc+o4sA==",
+ "license": "MIT",
+ "dependencies": {
+ "chalk": "~4.1.2",
+ "commander": "^14.0.3",
+ "loglevel": "^1.9.2"
+ },
+ "bin": {
+ "find-process": "dist/cjs/bin/find-process.js"
+ }
+ },
+ "node_modules/flattie": {
+ "version": "1.1.1",
+ "resolved": "https://registry.npmjs.org/flattie/-/flattie-1.1.1.tgz",
+ "integrity": "sha512-9UbaD6XdAL97+k/n+N7JwX46K/M6Zc6KcFYskrYL8wbBV/Uyk0CTAMY0VT+qiK5PM7AIc9aTWYtq65U7T+aCNQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/fontace": {
+ "version": "0.4.1",
+ "resolved": "https://registry.npmjs.org/fontace/-/fontace-0.4.1.tgz",
+ "integrity": "sha512-lDMvbAzSnHmbYMTEld5qdtvNH2/pWpICOqpean9IgC7vUbUJc3k+k5Dokp85CegamqQpFbXf0rAVkbzpyTA8aw==",
+ "license": "MIT",
+ "dependencies": {
+ "fontkitten": "^1.0.2"
+ }
+ },
+ "node_modules/fontkitten": {
+ "version": "1.0.3",
+ "resolved": "https://registry.npmjs.org/fontkitten/-/fontkitten-1.0.3.tgz",
+ "integrity": "sha512-Wp1zXWPVUPBmfoa3Cqc9ctaKuzKAV6uLstRqlR56kSjplf5uAce+qeyYym7F+PHbGTk+tCEdkCW6RD7DX/gBZw==",
+ "license": "MIT",
+ "dependencies": {
+ "tiny-inflate": "^1.0.3"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/fsevents": {
+ "version": "2.3.3",
+ "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+ "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+ "hasInstallScript": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+ }
+ },
+ "node_modules/get-caller-file": {
+ "version": "2.0.5",
+ "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
+ "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
+ "dev": true,
+ "license": "ISC",
+ "engines": {
+ "node": "6.* || 8.* || >= 10.*"
+ }
+ },
+ "node_modules/get-east-asian-width": {
+ "version": "1.6.0",
+ "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.6.0.tgz",
+ "integrity": "sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=18"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/get-tsconfig": {
+ "version": "5.0.0-beta.4",
+ "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-5.0.0-beta.4.tgz",
+ "integrity": "sha512-7nF7C9fIPFEMHgEMEfgIlO9wDdZ8CyHw27rWciFZfHvHDReIiPhsYuzPRXsfvBCqFy1l8RRyyWV7QLM+ZhUJsQ==",
+ "license": "MIT",
+ "dependencies": {
+ "resolve-pkg-maps": "^1.0.0"
+ },
+ "engines": {
+ "node": ">=20.20.0"
+ },
+ "funding": {
+ "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1"
+ }
+ },
+ "node_modules/github-slugger": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/github-slugger/-/github-slugger-2.0.0.tgz",
+ "integrity": "sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw==",
+ "license": "ISC"
+ },
+ "node_modules/h3": {
+ "version": "1.15.11",
+ "resolved": "https://registry.npmjs.org/h3/-/h3-1.15.11.tgz",
+ "integrity": "sha512-L3THSe2MPeBwgIZVSH5zLdBBU90TOxarvhK9d04IDY2AmVS8j2Jz2LIWtwsGOU3lu2I5jCN7FNvVfY2+XyF+mg==",
+ "license": "MIT",
+ "dependencies": {
+ "cookie-es": "^1.2.3",
+ "crossws": "^0.3.5",
+ "defu": "^6.1.6",
+ "destr": "^2.0.5",
+ "iron-webcrypto": "^1.2.1",
+ "node-mock-http": "^1.0.4",
+ "radix3": "^1.1.2",
+ "ufo": "^1.6.3",
+ "uncrypto": "^0.1.3"
+ }
+ },
+ "node_modules/has-flag": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+ "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/hast-util-embedded": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/hast-util-embedded/-/hast-util-embedded-3.0.0.tgz",
+ "integrity": "sha512-naH8sld4Pe2ep03qqULEtvYr7EjrLK2QHY8KJR6RJkTUjPGObe1vnx585uzem2hGra+s1q08DZZpfgDVYRbaXA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "hast-util-is-element": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-format": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/hast-util-format/-/hast-util-format-1.1.0.tgz",
+ "integrity": "sha512-yY1UDz6bC9rDvCWHpx12aIBGRG7krurX0p0Fm6pT547LwDIZZiNr8a+IHDogorAdreULSEzP82Nlv5SZkHZcjA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "hast-util-embedded": "^3.0.0",
+ "hast-util-minify-whitespace": "^1.0.0",
+ "hast-util-phrasing": "^3.0.0",
+ "hast-util-whitespace": "^3.0.0",
+ "html-whitespace-sensitive-tag-names": "^3.0.0",
+ "unist-util-visit-parents": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-from-html": {
+ "version": "2.0.3",
+ "resolved": "https://registry.npmjs.org/hast-util-from-html/-/hast-util-from-html-2.0.3.tgz",
+ "integrity": "sha512-CUSRHXyKjzHov8yKsQjGOElXy/3EKpyX56ELnkHH34vDVw1N1XSQ1ZcAvTyAPtGqLTuKP/uxM+aLkSPqF/EtMw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "devlop": "^1.1.0",
+ "hast-util-from-parse5": "^8.0.0",
+ "parse5": "^7.0.0",
+ "vfile": "^6.0.0",
+ "vfile-message": "^4.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-from-parse5": {
+ "version": "8.0.3",
+ "resolved": "https://registry.npmjs.org/hast-util-from-parse5/-/hast-util-from-parse5-8.0.3.tgz",
+ "integrity": "sha512-3kxEVkEKt0zvcZ3hCRYI8rqrgwtlIOFMWkbclACvjlDw8Li9S2hk/d51OI0nr/gIpdMHNepwgOKqZ/sy0Clpyg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "@types/unist": "^3.0.0",
+ "devlop": "^1.0.0",
+ "hastscript": "^9.0.0",
+ "property-information": "^7.0.0",
+ "vfile": "^6.0.0",
+ "vfile-location": "^5.0.0",
+ "web-namespaces": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-has-property": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/hast-util-has-property/-/hast-util-has-property-3.0.0.tgz",
+ "integrity": "sha512-MNilsvEKLFpV604hwfhVStK0usFY/QmM5zX16bo7EjnAEGofr5YyI37kzopBlZJkHD4t887i+q/C8/tr5Q94cA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-is-body-ok-link": {
+ "version": "3.0.1",
+ "resolved": "https://registry.npmjs.org/hast-util-is-body-ok-link/-/hast-util-is-body-ok-link-3.0.1.tgz",
+ "integrity": "sha512-0qpnzOBLztXHbHQenVB8uNuxTnm/QBFUOmdOSsEn7GnBtyY07+ENTWVFBAnXd/zEgd9/SUG3lRY7hSIBWRgGpQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-is-element": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/hast-util-is-element/-/hast-util-is-element-3.0.0.tgz",
+ "integrity": "sha512-Val9mnv2IWpLbNPqc/pUem+a7Ipj2aHacCwgNfTiK0vJKl0LF+4Ba4+v1oPHFpf3bLYmreq0/l3Gud9S5OH42g==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-minify-whitespace": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/hast-util-minify-whitespace/-/hast-util-minify-whitespace-1.0.1.tgz",
+ "integrity": "sha512-L96fPOVpnclQE0xzdWb/D12VT5FabA7SnZOUMtL1DbXmYiHJMXZvFkIZfiMmTCNJHUeO2K9UYNXoVyfz+QHuOw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "hast-util-embedded": "^3.0.0",
+ "hast-util-is-element": "^3.0.0",
+ "hast-util-whitespace": "^3.0.0",
+ "unist-util-is": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-parse-selector": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/hast-util-parse-selector/-/hast-util-parse-selector-4.0.0.tgz",
+ "integrity": "sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-phrasing": {
+ "version": "3.0.1",
+ "resolved": "https://registry.npmjs.org/hast-util-phrasing/-/hast-util-phrasing-3.0.1.tgz",
+ "integrity": "sha512-6h60VfI3uBQUxHqTyMymMZnEbNl1XmEGtOxxKYL7stY2o601COo62AWAYBQR9lZbYXYSBoxag8UpPRXK+9fqSQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "hast-util-embedded": "^3.0.0",
+ "hast-util-has-property": "^3.0.0",
+ "hast-util-is-body-ok-link": "^3.0.0",
+ "hast-util-is-element": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-raw": {
+ "version": "9.1.0",
+ "resolved": "https://registry.npmjs.org/hast-util-raw/-/hast-util-raw-9.1.0.tgz",
+ "integrity": "sha512-Y8/SBAHkZGoNkpzqqfCldijcuUKh7/su31kEBp67cFY09Wy0mTRgtsLYsiIxMJxlu0f6AA5SUTbDR8K0rxnbUw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "@types/unist": "^3.0.0",
+ "@ungap/structured-clone": "^1.0.0",
+ "hast-util-from-parse5": "^8.0.0",
+ "hast-util-to-parse5": "^8.0.0",
+ "html-void-elements": "^3.0.0",
+ "mdast-util-to-hast": "^13.0.0",
+ "parse5": "^7.0.0",
+ "unist-util-position": "^5.0.0",
+ "unist-util-visit": "^5.0.0",
+ "vfile": "^6.0.0",
+ "web-namespaces": "^2.0.0",
+ "zwitch": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-select": {
+ "version": "6.0.4",
+ "resolved": "https://registry.npmjs.org/hast-util-select/-/hast-util-select-6.0.4.tgz",
+ "integrity": "sha512-RqGS1ZgI0MwxLaKLDxjprynNzINEkRHY2i8ln4DDjgv9ZhcYVIHN9rlpiYsqtFwrgpYU361SyWDQcGNIBVu3lw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "@types/unist": "^3.0.0",
+ "bcp-47-match": "^2.0.0",
+ "comma-separated-tokens": "^2.0.0",
+ "css-selector-parser": "^3.0.0",
+ "devlop": "^1.0.0",
+ "direction": "^2.0.0",
+ "hast-util-has-property": "^3.0.0",
+ "hast-util-to-string": "^3.0.0",
+ "hast-util-whitespace": "^3.0.0",
+ "nth-check": "^2.0.0",
+ "property-information": "^7.0.0",
+ "space-separated-tokens": "^2.0.0",
+ "unist-util-visit": "^5.0.0",
+ "zwitch": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-to-estree": {
+ "version": "3.1.3",
+ "resolved": "https://registry.npmjs.org/hast-util-to-estree/-/hast-util-to-estree-3.1.3.tgz",
+ "integrity": "sha512-48+B/rJWAp0jamNbAAf9M7Uf//UVqAoMmgXhBdxTDJLGKY+LRnZ99qcG+Qjl5HfMpYNzS5v4EAwVEF34LeAj7w==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "@types/estree-jsx": "^1.0.0",
+ "@types/hast": "^3.0.0",
+ "comma-separated-tokens": "^2.0.0",
+ "devlop": "^1.0.0",
+ "estree-util-attach-comments": "^3.0.0",
+ "estree-util-is-identifier-name": "^3.0.0",
+ "hast-util-whitespace": "^3.0.0",
+ "mdast-util-mdx-expression": "^2.0.0",
+ "mdast-util-mdx-jsx": "^3.0.0",
+ "mdast-util-mdxjs-esm": "^2.0.0",
+ "property-information": "^7.0.0",
+ "space-separated-tokens": "^2.0.0",
+ "style-to-js": "^1.0.0",
+ "unist-util-position": "^5.0.0",
+ "zwitch": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-to-html": {
+ "version": "9.0.5",
+ "resolved": "https://registry.npmjs.org/hast-util-to-html/-/hast-util-to-html-9.0.5.tgz",
+ "integrity": "sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "@types/unist": "^3.0.0",
+ "ccount": "^2.0.0",
+ "comma-separated-tokens": "^2.0.0",
+ "hast-util-whitespace": "^3.0.0",
+ "html-void-elements": "^3.0.0",
+ "mdast-util-to-hast": "^13.0.0",
+ "property-information": "^7.0.0",
+ "space-separated-tokens": "^2.0.0",
+ "stringify-entities": "^4.0.0",
+ "zwitch": "^2.0.4"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-to-jsx-runtime": {
+ "version": "2.3.6",
+ "resolved": "https://registry.npmjs.org/hast-util-to-jsx-runtime/-/hast-util-to-jsx-runtime-2.3.6.tgz",
+ "integrity": "sha512-zl6s8LwNyo1P9uw+XJGvZtdFF1GdAkOg8ujOw+4Pyb76874fLps4ueHXDhXWdk6YHQ6OgUtinliG7RsYvCbbBg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "@types/hast": "^3.0.0",
+ "@types/unist": "^3.0.0",
+ "comma-separated-tokens": "^2.0.0",
+ "devlop": "^1.0.0",
+ "estree-util-is-identifier-name": "^3.0.0",
+ "hast-util-whitespace": "^3.0.0",
+ "mdast-util-mdx-expression": "^2.0.0",
+ "mdast-util-mdx-jsx": "^3.0.0",
+ "mdast-util-mdxjs-esm": "^2.0.0",
+ "property-information": "^7.0.0",
+ "space-separated-tokens": "^2.0.0",
+ "style-to-js": "^1.0.0",
+ "unist-util-position": "^5.0.0",
+ "vfile-message": "^4.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-to-parse5": {
+ "version": "8.0.1",
+ "resolved": "https://registry.npmjs.org/hast-util-to-parse5/-/hast-util-to-parse5-8.0.1.tgz",
+ "integrity": "sha512-MlWT6Pjt4CG9lFCjiz4BH7l9wmrMkfkJYCxFwKQic8+RTZgWPuWxwAfjJElsXkex7DJjfSJsQIt931ilUgmwdA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "comma-separated-tokens": "^2.0.0",
+ "devlop": "^1.0.0",
+ "property-information": "^7.0.0",
+ "space-separated-tokens": "^2.0.0",
+ "web-namespaces": "^2.0.0",
+ "zwitch": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-to-string": {
+ "version": "3.0.1",
+ "resolved": "https://registry.npmjs.org/hast-util-to-string/-/hast-util-to-string-3.0.1.tgz",
+ "integrity": "sha512-XelQVTDWvqcl3axRfI0xSeoVKzyIFPwsAGSLIsKdJKQMXDYJS4WYrBNF/8J7RdhIcFI2BOHgAifggsvsxp/3+A==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-to-text": {
+ "version": "4.0.2",
+ "resolved": "https://registry.npmjs.org/hast-util-to-text/-/hast-util-to-text-4.0.2.tgz",
+ "integrity": "sha512-KK6y/BN8lbaq654j7JgBydev7wuNMcID54lkRav1P0CaE1e47P72AWWPiGKXTJU271ooYzcvTAn/Zt0REnvc7A==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "@types/unist": "^3.0.0",
+ "hast-util-is-element": "^3.0.0",
+ "unist-util-find-after": "^5.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hast-util-whitespace": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/hast-util-whitespace/-/hast-util-whitespace-3.0.0.tgz",
+ "integrity": "sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/hastscript": {
+ "version": "9.0.1",
+ "resolved": "https://registry.npmjs.org/hastscript/-/hastscript-9.0.1.tgz",
+ "integrity": "sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "comma-separated-tokens": "^2.0.0",
+ "hast-util-parse-selector": "^4.0.0",
+ "property-information": "^7.0.0",
+ "space-separated-tokens": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/html-escaper": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-3.0.3.tgz",
+ "integrity": "sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ==",
+ "license": "MIT"
+ },
+ "node_modules/html-void-elements": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/html-void-elements/-/html-void-elements-3.0.0.tgz",
+ "integrity": "sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/html-whitespace-sensitive-tag-names": {
+ "version": "3.0.1",
+ "resolved": "https://registry.npmjs.org/html-whitespace-sensitive-tag-names/-/html-whitespace-sensitive-tag-names-3.0.1.tgz",
+ "integrity": "sha512-q+310vW8zmymYHALr1da4HyXUQ0zgiIwIicEfotYPWGN0OJVEN/58IJ3A4GBYcEq3LGAZqKb+ugvP0GNB9CEAA==",
+ "license": "MIT",
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/http-cache-semantics": {
+ "version": "4.2.0",
+ "resolved": "https://registry.npmjs.org/http-cache-semantics/-/http-cache-semantics-4.2.0.tgz",
+ "integrity": "sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ==",
+ "license": "BSD-2-Clause"
+ },
+ "node_modules/i18next": {
+ "version": "26.4.0",
+ "resolved": "https://registry.npmjs.org/i18next/-/i18next-26.4.0.tgz",
+ "integrity": "sha512-rsmK5bFqsD1AetSFSIa43wtNR4WpvvH4p0tLEsTxkC7QTrfdFm06nbQ95bh8Og4wwaCnUEcm9DVYL2cgxitiQg==",
+ "funding": [
+ {
+ "type": "individual",
+ "url": "https://www.locize.com/i18next"
+ },
+ {
+ "type": "individual",
+ "url": "https://www.i18next.com/how-to/faq#i18next-is-awesome.-how-can-i-support-the-project"
+ },
+ {
+ "type": "individual",
+ "url": "https://www.locize.com"
+ }
+ ],
+ "license": "MIT",
+ "peerDependencies": {
+ "typescript": "^5 || ^6 || ^7"
+ },
+ "peerDependenciesMeta": {
+ "typescript": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/inline-style-parser": {
+ "version": "0.2.7",
+ "resolved": "https://registry.npmjs.org/inline-style-parser/-/inline-style-parser-0.2.7.tgz",
+ "integrity": "sha512-Nb2ctOyNR8DqQoR0OwRG95uNWIC0C1lCgf5Naz5H6Ji72KZ8OcFZLz2P5sNgwlyoJ8Yif11oMuYs5pBQa86csA==",
+ "license": "MIT"
+ },
+ "node_modules/iron-webcrypto": {
+ "version": "1.2.1",
+ "resolved": "https://registry.npmjs.org/iron-webcrypto/-/iron-webcrypto-1.2.1.tgz",
+ "integrity": "sha512-feOM6FaSr6rEABp/eDfVseKyTMDt+KGpeB35SkVn9Tyn0CqvVsY3EwI0v5i8nMHyJnzCIQf7nsy3p41TPkJZhg==",
+ "license": "MIT",
+ "funding": {
+ "url": "https://github.com/sponsors/brc-dd"
+ }
+ },
+ "node_modules/is-alphabetical": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/is-alphabetical/-/is-alphabetical-2.0.1.tgz",
+ "integrity": "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/is-alphanumerical": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/is-alphanumerical/-/is-alphanumerical-2.0.1.tgz",
+ "integrity": "sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==",
+ "license": "MIT",
+ "dependencies": {
+ "is-alphabetical": "^2.0.0",
+ "is-decimal": "^2.0.0"
+ },
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/is-decimal": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/is-decimal/-/is-decimal-2.0.1.tgz",
+ "integrity": "sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/is-docker": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-4.0.0.tgz",
+ "integrity": "sha512-LHE+wROyG/Y/0ZnbktRCoTix2c1RhgWaZraMZ8o1Q7zCh0VSrICJQO5oqIIISrcSBtrXv0o233w1IYwsWCjTzA==",
+ "license": "MIT",
+ "bin": {
+ "is-docker": "cli.js"
+ },
+ "engines": {
+ "node": ">=20"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/is-hexadecimal": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/is-hexadecimal/-/is-hexadecimal-2.0.1.tgz",
+ "integrity": "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/is-plain-obj": {
+ "version": "4.1.0",
+ "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz",
+ "integrity": "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/js-yaml": {
+ "version": "4.3.1",
+ "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.1.tgz",
+ "integrity": "sha512-CY6crGq313MX8GkwvB7tzgp99vjQxY1++5y10/BKN/GUfHqWaOGQMNZkBvqSzsZKWk/ijwHlWzzkLulsGHhjWQ==",
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/puzrin"
+ },
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/nodeca"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "argparse": "^2.0.1"
+ },
+ "bin": {
+ "js-yaml": "bin/js-yaml.js"
+ }
+ },
+ "node_modules/json-schema-traverse": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+ "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/jsonc-parser": {
+ "version": "3.3.1",
+ "resolved": "https://registry.npmjs.org/jsonc-parser/-/jsonc-parser-3.3.1.tgz",
+ "integrity": "sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ==",
+ "license": "MIT"
+ },
+ "node_modules/kleur": {
+ "version": "4.1.5",
+ "resolved": "https://registry.npmjs.org/kleur/-/kleur-4.1.5.tgz",
+ "integrity": "sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/klona": {
+ "version": "2.0.6",
+ "resolved": "https://registry.npmjs.org/klona/-/klona-2.0.6.tgz",
+ "integrity": "sha512-dhG34DXATL5hSxJbIexCft8FChFXtmskoZYnoPWjXQuebWYCNkVeV3KkGegCK9CP1oswI/vQibS2GY7Em/sJJA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 8"
+ }
+ },
+ "node_modules/lightningcss": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.33.0.tgz",
+ "integrity": "sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==",
+ "license": "MPL-2.0",
+ "dependencies": {
+ "detect-libc": "^2.0.3"
+ },
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ },
+ "optionalDependencies": {
+ "lightningcss-android-arm64": "1.33.0",
+ "lightningcss-darwin-arm64": "1.33.0",
+ "lightningcss-darwin-x64": "1.33.0",
+ "lightningcss-freebsd-x64": "1.33.0",
+ "lightningcss-linux-arm-gnueabihf": "1.33.0",
+ "lightningcss-linux-arm64-gnu": "1.33.0",
+ "lightningcss-linux-arm64-musl": "1.33.0",
+ "lightningcss-linux-x64-gnu": "1.33.0",
+ "lightningcss-linux-x64-musl": "1.33.0",
+ "lightningcss-win32-arm64-msvc": "1.33.0",
+ "lightningcss-win32-x64-msvc": "1.33.0"
+ }
+ },
+ "node_modules/lightningcss-android-arm64": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.33.0.tgz",
+ "integrity": "sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "android"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-darwin-arm64": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.33.0.tgz",
+ "integrity": "sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-darwin-x64": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.33.0.tgz",
+ "integrity": "sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-freebsd-x64": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.33.0.tgz",
+ "integrity": "sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-linux-arm-gnueabihf": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.33.0.tgz",
+ "integrity": "sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==",
+ "cpu": [
+ "arm"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-linux-arm64-gnu": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.33.0.tgz",
+ "integrity": "sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-linux-arm64-musl": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.33.0.tgz",
+ "integrity": "sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-linux-x64-gnu": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.33.0.tgz",
+ "integrity": "sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "glibc"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-linux-x64-musl": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.33.0.tgz",
+ "integrity": "sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==",
+ "cpu": [
+ "x64"
+ ],
+ "libc": [
+ "musl"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-win32-arm64-msvc": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.33.0.tgz",
+ "integrity": "sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==",
+ "cpu": [
+ "arm64"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/lightningcss-win32-x64-msvc": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.33.0.tgz",
+ "integrity": "sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==",
+ "cpu": [
+ "x64"
+ ],
+ "license": "MPL-2.0",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">= 12.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/parcel"
+ }
+ },
+ "node_modules/loglevel": {
+ "version": "1.9.2",
+ "resolved": "https://registry.npmjs.org/loglevel/-/loglevel-1.9.2.tgz",
+ "integrity": "sha512-HgMmCqIJSAKqo68l0rS2AanEWfkxaZ5wNiEFb5ggm08lDs9Xl2KxBlX3PTcaD2chBM1gXAYf491/M2Rv8Jwayg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6.0"
+ },
+ "funding": {
+ "type": "tidelift",
+ "url": "https://tidelift.com/funding/github/npm/loglevel"
+ }
+ },
+ "node_modules/longest-streak": {
+ "version": "3.1.0",
+ "resolved": "https://registry.npmjs.org/longest-streak/-/longest-streak-3.1.0.tgz",
+ "integrity": "sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/lru-cache": {
+ "version": "11.5.2",
+ "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.5.2.tgz",
+ "integrity": "sha512-4pfM1Ff0x50o0tQwb5ucw/RzNyD0/YJME6IVcStalZuMWxdt3sR3huStTtxz4PUmvZfRguvDejasvQ2kifR11g==",
+ "license": "BlueOak-1.0.0",
+ "engines": {
+ "node": "20 || >=22"
+ }
+ },
+ "node_modules/magic-string": {
+ "version": "0.30.21",
+ "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
+ "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@jridgewell/sourcemap-codec": "^1.5.5"
+ }
+ },
+ "node_modules/magicast": {
+ "version": "0.5.4",
+ "resolved": "https://registry.npmjs.org/magicast/-/magicast-0.5.4.tgz",
+ "integrity": "sha512-llBEhWm1SacoRwgHUoQJYtwp4PBLF4faQi5TCpIGyGs9n4y5+juI0tDgyKIfpqxckRHaHzouUEph3THklWh03w==",
+ "license": "MIT",
+ "dependencies": {
+ "@babel/parser": "^7.29.7",
+ "@babel/types": "^7.29.7",
+ "source-map-js": "^1.2.1"
+ }
+ },
+ "node_modules/markdown-extensions": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/markdown-extensions/-/markdown-extensions-2.0.0.tgz",
+ "integrity": "sha512-o5vL7aDWatOTX8LzaS1WMoaoxIiLRQJuIKKe2wAw6IeULDHaqbiqiggmx+pKvZDb1Sj+pE46Sn1T7lCqfFtg1Q==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=16"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/markdown-table": {
+ "version": "3.0.4",
+ "resolved": "https://registry.npmjs.org/markdown-table/-/markdown-table-3.0.4.tgz",
+ "integrity": "sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/mdast-util-definitions": {
+ "version": "6.0.0",
+ "resolved": "https://registry.npmjs.org/mdast-util-definitions/-/mdast-util-definitions-6.0.0.tgz",
+ "integrity": "sha512-scTllyX6pnYNZH/AIp/0ePz6s4cZtARxImwoPJ7kS42n+MnVsI4XbnG6d4ibehRIldYMWM2LD7ImQblVhUejVQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "@types/unist": "^3.0.0",
+ "unist-util-visit": "^5.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-directive": {
+ "version": "3.1.0",
+ "resolved": "https://registry.npmjs.org/mdast-util-directive/-/mdast-util-directive-3.1.0.tgz",
+ "integrity": "sha512-I3fNFt+DHmpWCYAT7quoM6lHf9wuqtI+oCOfvILnoicNIqjh5E3dEJWiXuYME2gNe8vl1iMQwyUHa7bgFmak6Q==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "@types/unist": "^3.0.0",
+ "ccount": "^2.0.0",
+ "devlop": "^1.0.0",
+ "mdast-util-from-markdown": "^2.0.0",
+ "mdast-util-to-markdown": "^2.0.0",
+ "parse-entities": "^4.0.0",
+ "stringify-entities": "^4.0.0",
+ "unist-util-visit-parents": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-find-and-replace": {
+ "version": "3.0.2",
+ "resolved": "https://registry.npmjs.org/mdast-util-find-and-replace/-/mdast-util-find-and-replace-3.0.2.tgz",
+ "integrity": "sha512-Tmd1Vg/m3Xz43afeNxDIhWRtFZgM2VLyaf4vSTYwudTyeuTneoL3qtWMA5jeLyz/O1vDJmmV4QuScFCA2tBPwg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "escape-string-regexp": "^5.0.0",
+ "unist-util-is": "^6.0.0",
+ "unist-util-visit-parents": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-from-markdown": {
+ "version": "2.0.3",
+ "resolved": "https://registry.npmjs.org/mdast-util-from-markdown/-/mdast-util-from-markdown-2.0.3.tgz",
+ "integrity": "sha512-W4mAWTvSlKvf8L6J+VN9yLSqQ9AOAAvHuoDAmPkz4dHf553m5gVj2ejadHJhoJmcmxEnOv6Pa8XJhpxE93kb8Q==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "@types/unist": "^3.0.0",
+ "decode-named-character-reference": "^1.0.0",
+ "devlop": "^1.0.0",
+ "mdast-util-to-string": "^4.0.0",
+ "micromark": "^4.0.0",
+ "micromark-util-decode-numeric-character-reference": "^2.0.0",
+ "micromark-util-decode-string": "^2.0.0",
+ "micromark-util-normalize-identifier": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0",
+ "unist-util-stringify-position": "^4.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-gfm": {
+ "version": "3.1.0",
+ "resolved": "https://registry.npmjs.org/mdast-util-gfm/-/mdast-util-gfm-3.1.0.tgz",
+ "integrity": "sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ==",
+ "license": "MIT",
+ "dependencies": {
+ "mdast-util-from-markdown": "^2.0.0",
+ "mdast-util-gfm-autolink-literal": "^2.0.0",
+ "mdast-util-gfm-footnote": "^2.0.0",
+ "mdast-util-gfm-strikethrough": "^2.0.0",
+ "mdast-util-gfm-table": "^2.0.0",
+ "mdast-util-gfm-task-list-item": "^2.0.0",
+ "mdast-util-to-markdown": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-gfm-autolink-literal": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/mdast-util-gfm-autolink-literal/-/mdast-util-gfm-autolink-literal-2.0.1.tgz",
+ "integrity": "sha512-5HVP2MKaP6L+G6YaxPNjuL0BPrq9orG3TsrZ9YXbA3vDw/ACI4MEsnoDpn6ZNm7GnZgtAcONJyPhOP8tNJQavQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "ccount": "^2.0.0",
+ "devlop": "^1.0.0",
+ "mdast-util-find-and-replace": "^3.0.0",
+ "micromark-util-character": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-gfm-footnote": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/mdast-util-gfm-footnote/-/mdast-util-gfm-footnote-2.1.0.tgz",
+ "integrity": "sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "devlop": "^1.1.0",
+ "mdast-util-from-markdown": "^2.0.0",
+ "mdast-util-to-markdown": "^2.0.0",
+ "micromark-util-normalize-identifier": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-gfm-strikethrough": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/mdast-util-gfm-strikethrough/-/mdast-util-gfm-strikethrough-2.0.0.tgz",
+ "integrity": "sha512-mKKb915TF+OC5ptj5bJ7WFRPdYtuHv0yTRxK2tJvi+BDqbkiG7h7u/9SI89nRAYcmap2xHQL9D+QG/6wSrTtXg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "mdast-util-from-markdown": "^2.0.0",
+ "mdast-util-to-markdown": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-gfm-table": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/mdast-util-gfm-table/-/mdast-util-gfm-table-2.0.0.tgz",
+ "integrity": "sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "devlop": "^1.0.0",
+ "markdown-table": "^3.0.0",
+ "mdast-util-from-markdown": "^2.0.0",
+ "mdast-util-to-markdown": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-gfm-task-list-item": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/mdast-util-gfm-task-list-item/-/mdast-util-gfm-task-list-item-2.0.0.tgz",
+ "integrity": "sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "devlop": "^1.0.0",
+ "mdast-util-from-markdown": "^2.0.0",
+ "mdast-util-to-markdown": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-mdx": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/mdast-util-mdx/-/mdast-util-mdx-3.0.0.tgz",
+ "integrity": "sha512-JfbYLAW7XnYTTbUsmpu0kdBUVe+yKVJZBItEjwyYJiDJuZ9w4eeaqks4HQO+R7objWgS2ymV60GYpI14Ug554w==",
+ "license": "MIT",
+ "dependencies": {
+ "mdast-util-from-markdown": "^2.0.0",
+ "mdast-util-mdx-expression": "^2.0.0",
+ "mdast-util-mdx-jsx": "^3.0.0",
+ "mdast-util-mdxjs-esm": "^2.0.0",
+ "mdast-util-to-markdown": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-mdx-expression": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/mdast-util-mdx-expression/-/mdast-util-mdx-expression-2.0.1.tgz",
+ "integrity": "sha512-J6f+9hUp+ldTZqKRSg7Vw5V6MqjATc+3E4gf3CFNcuZNWD8XdyI6zQ8GqH7f8169MM6P7hMBRDVGnn7oHB9kXQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree-jsx": "^1.0.0",
+ "@types/hast": "^3.0.0",
+ "@types/mdast": "^4.0.0",
+ "devlop": "^1.0.0",
+ "mdast-util-from-markdown": "^2.0.0",
+ "mdast-util-to-markdown": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-mdx-jsx": {
+ "version": "3.2.0",
+ "resolved": "https://registry.npmjs.org/mdast-util-mdx-jsx/-/mdast-util-mdx-jsx-3.2.0.tgz",
+ "integrity": "sha512-lj/z8v0r6ZtsN/cGNNtemmmfoLAFZnjMbNyLzBafjzikOM+glrjNHPlf6lQDOTccj9n5b0PPihEBbhneMyGs1Q==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree-jsx": "^1.0.0",
+ "@types/hast": "^3.0.0",
+ "@types/mdast": "^4.0.0",
+ "@types/unist": "^3.0.0",
+ "ccount": "^2.0.0",
+ "devlop": "^1.1.0",
+ "mdast-util-from-markdown": "^2.0.0",
+ "mdast-util-to-markdown": "^2.0.0",
+ "parse-entities": "^4.0.0",
+ "stringify-entities": "^4.0.0",
+ "unist-util-stringify-position": "^4.0.0",
+ "vfile-message": "^4.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-mdxjs-esm": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/mdast-util-mdxjs-esm/-/mdast-util-mdxjs-esm-2.0.1.tgz",
+ "integrity": "sha512-EcmOpxsZ96CvlP03NghtH1EsLtr0n9Tm4lPUJUBccV9RwUOneqSycg19n5HGzCf+10LozMRSObtVr3ee1WoHtg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree-jsx": "^1.0.0",
+ "@types/hast": "^3.0.0",
+ "@types/mdast": "^4.0.0",
+ "devlop": "^1.0.0",
+ "mdast-util-from-markdown": "^2.0.0",
+ "mdast-util-to-markdown": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-phrasing": {
+ "version": "4.1.0",
+ "resolved": "https://registry.npmjs.org/mdast-util-phrasing/-/mdast-util-phrasing-4.1.0.tgz",
+ "integrity": "sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "unist-util-is": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-to-hast": {
+ "version": "13.2.1",
+ "resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.1.tgz",
+ "integrity": "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "@types/mdast": "^4.0.0",
+ "@ungap/structured-clone": "^1.0.0",
+ "devlop": "^1.0.0",
+ "micromark-util-sanitize-uri": "^2.0.0",
+ "trim-lines": "^3.0.0",
+ "unist-util-position": "^5.0.0",
+ "unist-util-visit": "^5.0.0",
+ "vfile": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-to-markdown": {
+ "version": "2.1.2",
+ "resolved": "https://registry.npmjs.org/mdast-util-to-markdown/-/mdast-util-to-markdown-2.1.2.tgz",
+ "integrity": "sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "@types/unist": "^3.0.0",
+ "longest-streak": "^3.0.0",
+ "mdast-util-phrasing": "^4.0.0",
+ "mdast-util-to-string": "^4.0.0",
+ "micromark-util-classify-character": "^2.0.0",
+ "micromark-util-decode-string": "^2.0.0",
+ "unist-util-visit": "^5.0.0",
+ "zwitch": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdast-util-to-string": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/mdast-util-to-string/-/mdast-util-to-string-4.0.0.tgz",
+ "integrity": "sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/mdn-data": {
+ "version": "2.27.1",
+ "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.27.1.tgz",
+ "integrity": "sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==",
+ "license": "CC0-1.0"
+ },
+ "node_modules/micromark": {
+ "version": "4.0.2",
+ "resolved": "https://registry.npmjs.org/micromark/-/micromark-4.0.2.tgz",
+ "integrity": "sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "@types/debug": "^4.0.0",
+ "debug": "^4.0.0",
+ "decode-named-character-reference": "^1.0.0",
+ "devlop": "^1.0.0",
+ "micromark-core-commonmark": "^2.0.0",
+ "micromark-factory-space": "^2.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-chunked": "^2.0.0",
+ "micromark-util-combine-extensions": "^2.0.0",
+ "micromark-util-decode-numeric-character-reference": "^2.0.0",
+ "micromark-util-encode": "^2.0.0",
+ "micromark-util-normalize-identifier": "^2.0.0",
+ "micromark-util-resolve-all": "^2.0.0",
+ "micromark-util-sanitize-uri": "^2.0.0",
+ "micromark-util-subtokenize": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-core-commonmark": {
+ "version": "2.0.3",
+ "resolved": "https://registry.npmjs.org/micromark-core-commonmark/-/micromark-core-commonmark-2.0.3.tgz",
+ "integrity": "sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "decode-named-character-reference": "^1.0.0",
+ "devlop": "^1.0.0",
+ "micromark-factory-destination": "^2.0.0",
+ "micromark-factory-label": "^2.0.0",
+ "micromark-factory-space": "^2.0.0",
+ "micromark-factory-title": "^2.0.0",
+ "micromark-factory-whitespace": "^2.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-chunked": "^2.0.0",
+ "micromark-util-classify-character": "^2.0.0",
+ "micromark-util-html-tag-name": "^2.0.0",
+ "micromark-util-normalize-identifier": "^2.0.0",
+ "micromark-util-resolve-all": "^2.0.0",
+ "micromark-util-subtokenize": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-extension-directive": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/micromark-extension-directive/-/micromark-extension-directive-4.0.0.tgz",
+ "integrity": "sha512-/C2nqVmXXmiseSSuCdItCMho7ybwwop6RrrRPk0KbOHW21JKoCldC+8rFOaundDoRBUWBnJJcxeA/Kvi34WQXg==",
+ "license": "MIT",
+ "dependencies": {
+ "devlop": "^1.0.0",
+ "micromark-factory-space": "^2.0.0",
+ "micromark-factory-whitespace": "^2.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0",
+ "parse-entities": "^4.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/micromark-extension-gfm": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm/-/micromark-extension-gfm-3.0.0.tgz",
+ "integrity": "sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==",
+ "license": "MIT",
+ "dependencies": {
+ "micromark-extension-gfm-autolink-literal": "^2.0.0",
+ "micromark-extension-gfm-footnote": "^2.0.0",
+ "micromark-extension-gfm-strikethrough": "^2.0.0",
+ "micromark-extension-gfm-table": "^2.0.0",
+ "micromark-extension-gfm-tagfilter": "^2.0.0",
+ "micromark-extension-gfm-task-list-item": "^2.0.0",
+ "micromark-util-combine-extensions": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/micromark-extension-gfm-autolink-literal": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm-autolink-literal/-/micromark-extension-gfm-autolink-literal-2.1.0.tgz",
+ "integrity": "sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==",
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-sanitize-uri": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/micromark-extension-gfm-footnote": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm-footnote/-/micromark-extension-gfm-footnote-2.1.0.tgz",
+ "integrity": "sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==",
+ "license": "MIT",
+ "dependencies": {
+ "devlop": "^1.0.0",
+ "micromark-core-commonmark": "^2.0.0",
+ "micromark-factory-space": "^2.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-normalize-identifier": "^2.0.0",
+ "micromark-util-sanitize-uri": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/micromark-extension-gfm-strikethrough": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm-strikethrough/-/micromark-extension-gfm-strikethrough-2.1.0.tgz",
+ "integrity": "sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==",
+ "license": "MIT",
+ "dependencies": {
+ "devlop": "^1.0.0",
+ "micromark-util-chunked": "^2.0.0",
+ "micromark-util-classify-character": "^2.0.0",
+ "micromark-util-resolve-all": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/micromark-extension-gfm-table": {
+ "version": "2.1.1",
+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm-table/-/micromark-extension-gfm-table-2.1.1.tgz",
+ "integrity": "sha512-t2OU/dXXioARrC6yWfJ4hqB7rct14e8f7m0cbI5hUmDyyIlwv5vEtooptH8INkbLzOatzKuVbQmAYcbWoyz6Dg==",
+ "license": "MIT",
+ "dependencies": {
+ "devlop": "^1.0.0",
+ "micromark-factory-space": "^2.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/micromark-extension-gfm-tagfilter": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm-tagfilter/-/micromark-extension-gfm-tagfilter-2.0.0.tgz",
+ "integrity": "sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg==",
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-types": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/micromark-extension-gfm-task-list-item": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm-task-list-item/-/micromark-extension-gfm-task-list-item-2.1.0.tgz",
+ "integrity": "sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==",
+ "license": "MIT",
+ "dependencies": {
+ "devlop": "^1.0.0",
+ "micromark-factory-space": "^2.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/micromark-extension-mdx-expression": {
+ "version": "3.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-extension-mdx-expression/-/micromark-extension-mdx-expression-3.0.1.tgz",
+ "integrity": "sha512-dD/ADLJ1AeMvSAKBwO22zG22N4ybhe7kFIZ3LsDI0GlsNr2A3KYxb0LdC1u5rj4Nw+CHKY0RVdnHX8vj8ejm4Q==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "devlop": "^1.0.0",
+ "micromark-factory-mdx-expression": "^2.0.0",
+ "micromark-factory-space": "^2.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-events-to-acorn": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-extension-mdx-jsx": {
+ "version": "3.0.2",
+ "resolved": "https://registry.npmjs.org/micromark-extension-mdx-jsx/-/micromark-extension-mdx-jsx-3.0.2.tgz",
+ "integrity": "sha512-e5+q1DjMh62LZAJOnDraSSbDMvGJ8x3cbjygy2qFEi7HCeUT4BDKCvMozPozcD6WmOt6sVvYDNBKhFSz3kjOVQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "devlop": "^1.0.0",
+ "estree-util-is-identifier-name": "^3.0.0",
+ "micromark-factory-mdx-expression": "^2.0.0",
+ "micromark-factory-space": "^2.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-events-to-acorn": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0",
+ "vfile-message": "^4.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/micromark-extension-mdx-md": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/micromark-extension-mdx-md/-/micromark-extension-mdx-md-2.0.0.tgz",
+ "integrity": "sha512-EpAiszsB3blw4Rpba7xTOUptcFeBFi+6PY8VnJ2hhimH+vCQDirWgsMpz7w1XcZE7LVrSAUGb9VJpG9ghlYvYQ==",
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-types": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/micromark-extension-mdxjs": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/micromark-extension-mdxjs/-/micromark-extension-mdxjs-3.0.0.tgz",
+ "integrity": "sha512-A873fJfhnJ2siZyUrJ31l34Uqwy4xIFmvPY1oj+Ean5PHcPBYzEsvqvWGaWcfEIr11O5Dlw3p2y0tZWpKHDejQ==",
+ "license": "MIT",
+ "dependencies": {
+ "acorn": "^8.0.0",
+ "acorn-jsx": "^5.0.0",
+ "micromark-extension-mdx-expression": "^3.0.0",
+ "micromark-extension-mdx-jsx": "^3.0.0",
+ "micromark-extension-mdx-md": "^2.0.0",
+ "micromark-extension-mdxjs-esm": "^3.0.0",
+ "micromark-util-combine-extensions": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/micromark-extension-mdxjs-esm": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/micromark-extension-mdxjs-esm/-/micromark-extension-mdxjs-esm-3.0.0.tgz",
+ "integrity": "sha512-DJFl4ZqkErRpq/dAPyeWp15tGrcrrJho1hKK5uBS70BCtfrIFg81sqcTVu3Ta+KD1Tk5vAtBNElWxtAa+m8K9A==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "devlop": "^1.0.0",
+ "micromark-core-commonmark": "^2.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-events-to-acorn": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0",
+ "unist-util-position-from-estree": "^2.0.0",
+ "vfile-message": "^4.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/micromark-factory-destination": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-factory-destination/-/micromark-factory-destination-2.0.1.tgz",
+ "integrity": "sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-factory-label": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-factory-label/-/micromark-factory-label-2.0.1.tgz",
+ "integrity": "sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "devlop": "^1.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-factory-mdx-expression": {
+ "version": "2.0.3",
+ "resolved": "https://registry.npmjs.org/micromark-factory-mdx-expression/-/micromark-factory-mdx-expression-2.0.3.tgz",
+ "integrity": "sha512-kQnEtA3vzucU2BkrIa8/VaSAsP+EJ3CKOvhMuJgOEGg9KDC6OAY6nSnNDVRiVNRqj7Y4SlSzcStaH/5jge8JdQ==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "devlop": "^1.0.0",
+ "micromark-factory-space": "^2.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-events-to-acorn": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0",
+ "unist-util-position-from-estree": "^2.0.0",
+ "vfile-message": "^4.0.0"
+ }
+ },
+ "node_modules/micromark-factory-space": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-factory-space/-/micromark-factory-space-2.0.1.tgz",
+ "integrity": "sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-factory-title": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-factory-title/-/micromark-factory-title-2.0.1.tgz",
+ "integrity": "sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "micromark-factory-space": "^2.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-factory-whitespace": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-factory-whitespace/-/micromark-factory-whitespace-2.0.1.tgz",
+ "integrity": "sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "micromark-factory-space": "^2.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-util-character": {
+ "version": "2.1.1",
+ "resolved": "https://registry.npmjs.org/micromark-util-character/-/micromark-util-character-2.1.1.tgz",
+ "integrity": "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-util-chunked": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-util-chunked/-/micromark-util-chunked-2.0.1.tgz",
+ "integrity": "sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-symbol": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-util-classify-character": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-util-classify-character/-/micromark-util-classify-character-2.0.1.tgz",
+ "integrity": "sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-util-combine-extensions": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-util-combine-extensions/-/micromark-util-combine-extensions-2.0.1.tgz",
+ "integrity": "sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-chunked": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-util-decode-numeric-character-reference": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/micromark-util-decode-numeric-character-reference/-/micromark-util-decode-numeric-character-reference-2.0.2.tgz",
+ "integrity": "sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-symbol": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-util-decode-string": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-util-decode-string/-/micromark-util-decode-string-2.0.1.tgz",
+ "integrity": "sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "decode-named-character-reference": "^1.0.0",
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-decode-numeric-character-reference": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-util-encode": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-util-encode/-/micromark-util-encode-2.0.1.tgz",
+ "integrity": "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT"
+ },
+ "node_modules/micromark-util-events-to-acorn": {
+ "version": "2.0.3",
+ "resolved": "https://registry.npmjs.org/micromark-util-events-to-acorn/-/micromark-util-events-to-acorn-2.0.3.tgz",
+ "integrity": "sha512-jmsiEIiZ1n7X1Rr5k8wVExBQCg5jy4UXVADItHmNk1zkwEVhBuIUKRu3fqv+hs4nxLISi2DQGlqIOGiFxgbfHg==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "@types/unist": "^3.0.0",
+ "devlop": "^1.0.0",
+ "estree-util-visit": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0",
+ "vfile-message": "^4.0.0"
+ }
+ },
+ "node_modules/micromark-util-html-tag-name": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-util-html-tag-name/-/micromark-util-html-tag-name-2.0.1.tgz",
+ "integrity": "sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT"
+ },
+ "node_modules/micromark-util-normalize-identifier": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-util-normalize-identifier/-/micromark-util-normalize-identifier-2.0.1.tgz",
+ "integrity": "sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-symbol": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-util-resolve-all": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-util-resolve-all/-/micromark-util-resolve-all-2.0.1.tgz",
+ "integrity": "sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-util-sanitize-uri": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-util-sanitize-uri/-/micromark-util-sanitize-uri-2.0.1.tgz",
+ "integrity": "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "micromark-util-character": "^2.0.0",
+ "micromark-util-encode": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-util-subtokenize": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/micromark-util-subtokenize/-/micromark-util-subtokenize-2.1.0.tgz",
+ "integrity": "sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "devlop": "^1.0.0",
+ "micromark-util-chunked": "^2.0.0",
+ "micromark-util-symbol": "^2.0.0",
+ "micromark-util-types": "^2.0.0"
+ }
+ },
+ "node_modules/micromark-util-symbol": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/micromark-util-symbol/-/micromark-util-symbol-2.0.1.tgz",
+ "integrity": "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT"
+ },
+ "node_modules/micromark-util-types": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/micromark-util-types/-/micromark-util-types-2.0.2.tgz",
+ "integrity": "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==",
+ "funding": [
+ {
+ "type": "GitHub Sponsors",
+ "url": "https://github.com/sponsors/unifiedjs"
+ },
+ {
+ "type": "OpenCollective",
+ "url": "https://opencollective.com/unified"
+ }
+ ],
+ "license": "MIT"
+ },
+ "node_modules/mrmime": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/mrmime/-/mrmime-2.0.1.tgz",
+ "integrity": "sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=10"
+ }
+ },
+ "node_modules/ms": {
+ "version": "2.1.3",
+ "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+ "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+ "license": "MIT"
+ },
+ "node_modules/muggle-string": {
+ "version": "0.4.1",
+ "resolved": "https://registry.npmjs.org/muggle-string/-/muggle-string-0.4.1.tgz",
+ "integrity": "sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/nanoid": {
+ "version": "3.3.18",
+ "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.18.tgz",
+ "integrity": "sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w==",
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/ai"
+ }
+ ],
+ "license": "MIT",
+ "bin": {
+ "nanoid": "bin/nanoid.cjs"
+ },
+ "engines": {
+ "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+ }
+ },
+ "node_modules/neotraverse": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/neotraverse/-/neotraverse-1.0.1.tgz",
+ "integrity": "sha512-WmmLty1YWwJl9yZi77v2dVIV6X2kuYV8YYBI/G3LWGKdGHmHUvL1z7FW0iDvEvGAwNEoc5x1tOOOyDnf5jJw/w==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 10"
+ }
+ },
+ "node_modules/nlcst-to-string": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/nlcst-to-string/-/nlcst-to-string-4.0.0.tgz",
+ "integrity": "sha512-YKLBCcUYKAg0FNlOBT6aI91qFmSiFKiluk655WzPF+DDMA02qIyy8uiRqI8QXtcFpEvll12LpL5MXqEmAZ+dcA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/nlcst": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/node-fetch-native": {
+ "version": "1.6.7",
+ "resolved": "https://registry.npmjs.org/node-fetch-native/-/node-fetch-native-1.6.7.tgz",
+ "integrity": "sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q==",
+ "license": "MIT"
+ },
+ "node_modules/node-mock-http": {
+ "version": "1.0.5",
+ "resolved": "https://registry.npmjs.org/node-mock-http/-/node-mock-http-1.0.5.tgz",
+ "integrity": "sha512-KQyt/wLjG3TAc7DOUhpqWzgd4ERxR80JOlTK5VE5R1S12IaPVN5qkj4klBce9HPG1Njuup4Sb5bljaT34lIyjw==",
+ "license": "MIT"
+ },
+ "node_modules/normalize-path": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
+ "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=0.10.0"
+ }
+ },
+ "node_modules/nth-check": {
+ "version": "2.1.1",
+ "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz",
+ "integrity": "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==",
+ "license": "BSD-2-Clause",
+ "dependencies": {
+ "boolbase": "^1.0.0"
+ },
+ "funding": {
+ "url": "https://github.com/fb55/nth-check?sponsor=1"
+ }
+ },
+ "node_modules/obug": {
+ "version": "2.1.4",
+ "resolved": "https://registry.npmjs.org/obug/-/obug-2.1.4.tgz",
+ "integrity": "sha512-4a+OsYv9UktOJKE+l1A4OufDgdRF9PifWj+tJnHURo/P+WOxpG4GzUFL9qCalmWauao6ogiG+QvnCovwPoyAWA==",
+ "funding": [
+ "https://github.com/sponsors/sxzz",
+ "https://opencollective.com/debug"
+ ],
+ "license": "MIT",
+ "engines": {
+ "node": ">=12.20.0"
+ }
+ },
+ "node_modules/ofetch": {
+ "version": "1.5.1",
+ "resolved": "https://registry.npmjs.org/ofetch/-/ofetch-1.5.1.tgz",
+ "integrity": "sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA==",
+ "license": "MIT",
+ "dependencies": {
+ "destr": "^2.0.5",
+ "node-fetch-native": "^1.6.7",
+ "ufo": "^1.6.1"
+ }
+ },
+ "node_modules/ohash": {
+ "version": "2.0.12",
+ "resolved": "https://registry.npmjs.org/ohash/-/ohash-2.0.12.tgz",
+ "integrity": "sha512-65S/5gk9YSsaRjcyf7Nfa6h/d3E8/1gslpXfI4W7Dxn/oap8IKRuNT5VXkLQ1YFKIEg4apRY4Pj6aiwFzrDdmw==",
+ "license": "MIT"
+ },
+ "node_modules/oniguruma-parser": {
+ "version": "0.12.2",
+ "resolved": "https://registry.npmjs.org/oniguruma-parser/-/oniguruma-parser-0.12.2.tgz",
+ "integrity": "sha512-6HVa5oIrgMC6aA6WF6XyyqbhRPJrKR02L20+2+zpDtO5QAzGHAUGw5TKQvwi5vctNnRHkJYmjAhRVQF2EKdTQw==",
+ "license": "MIT"
+ },
+ "node_modules/oniguruma-to-es": {
+ "version": "4.3.6",
+ "resolved": "https://registry.npmjs.org/oniguruma-to-es/-/oniguruma-to-es-4.3.6.tgz",
+ "integrity": "sha512-csuQ9x3Yr0cEIs/Zgx/OEt9iBw9vqIunAPQkx19R/fiMq2oGVTgcMqO/V3Ybqefr1TBvosI6jU539ksaBULJyA==",
+ "license": "MIT",
+ "dependencies": {
+ "oniguruma-parser": "^0.12.2",
+ "regex": "^6.1.0",
+ "regex-recursion": "^6.0.2"
+ }
+ },
+ "node_modules/p-limit": {
+ "version": "7.3.1",
+ "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-7.3.1.tgz",
+ "integrity": "sha512-0trZaiG7Y7kN/Egy9a8j47t9osC0Tch4PaIWd9yGF6bvmlk7muExRvGNYb8sXBwEKMoNKsbNN9P8EefuQekE4Q==",
+ "license": "MIT",
+ "dependencies": {
+ "yocto-queue": "^1.2.1"
+ },
+ "engines": {
+ "node": ">=20"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/p-queue": {
+ "version": "9.3.3",
+ "resolved": "https://registry.npmjs.org/p-queue/-/p-queue-9.3.3.tgz",
+ "integrity": "sha512-NXAOdnEe5FsZJfT4oK84lE1Y5cFFdWlRuOo5tww8DyNMxyRXwn39fIkUtNLKppcPC+UYU/bXujNCUGDv01y7CA==",
+ "license": "MIT",
+ "dependencies": {
+ "eventemitter3": "^5.0.4",
+ "p-timeout": "^7.0.0"
+ },
+ "engines": {
+ "node": ">=20"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/p-timeout": {
+ "version": "7.0.1",
+ "resolved": "https://registry.npmjs.org/p-timeout/-/p-timeout-7.0.1.tgz",
+ "integrity": "sha512-AxTM2wDGORHGEkPCt8yqxOTMgpfbEHqF51f/5fJCmwFC3C/zNcGT63SymH2ttOAaiIws2zVg4+izQCjrakcwHg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=20"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/package-manager-detector": {
+ "version": "1.8.0",
+ "resolved": "https://registry.npmjs.org/package-manager-detector/-/package-manager-detector-1.8.0.tgz",
+ "integrity": "sha512-yQA4H19AmPEoMUeavPMDIe1higySl/gH/yaQrkT/s07Qp+7pp2hYz30N3z2l5BkjVkF9Ow6o0wjJamm2y7Sn0A==",
+ "license": "MIT"
+ },
+ "node_modules/pagefind": {
+ "version": "1.5.2",
+ "resolved": "https://registry.npmjs.org/pagefind/-/pagefind-1.5.2.tgz",
+ "integrity": "sha512-XTUaK0hXMCu2jszWE584JGQT7y284TmMV9l/HX3rnG5uo3rHI/uHU56XTyyyPFjeWEBxECbAi0CaFDJOONtG0Q==",
+ "license": "MIT",
+ "bin": {
+ "pagefind": "lib/runner/bin.cjs"
+ },
+ "optionalDependencies": {
+ "@pagefind/darwin-arm64": "1.5.2",
+ "@pagefind/darwin-x64": "1.5.2",
+ "@pagefind/freebsd-x64": "1.5.2",
+ "@pagefind/linux-arm64": "1.5.2",
+ "@pagefind/linux-x64": "1.5.2",
+ "@pagefind/windows-arm64": "1.5.2",
+ "@pagefind/windows-x64": "1.5.2"
+ }
+ },
+ "node_modules/parse-entities": {
+ "version": "4.0.2",
+ "resolved": "https://registry.npmjs.org/parse-entities/-/parse-entities-4.0.2.tgz",
+ "integrity": "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^2.0.0",
+ "character-entities-legacy": "^3.0.0",
+ "character-reference-invalid": "^2.0.0",
+ "decode-named-character-reference": "^1.0.0",
+ "is-alphanumerical": "^2.0.0",
+ "is-decimal": "^2.0.0",
+ "is-hexadecimal": "^2.0.0"
+ },
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/parse-entities/node_modules/@types/unist": {
+ "version": "2.0.11",
+ "resolved": "https://registry.npmjs.org/@types/unist/-/unist-2.0.11.tgz",
+ "integrity": "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==",
+ "license": "MIT"
+ },
+ "node_modules/parse-latin": {
+ "version": "7.0.0",
+ "resolved": "https://registry.npmjs.org/parse-latin/-/parse-latin-7.0.0.tgz",
+ "integrity": "sha512-mhHgobPPua5kZ98EF4HWiH167JWBfl4pvAIXXdbaVohtK7a6YBOy56kvhCqduqyo/f3yrHFWmqmiMg/BkBkYYQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/nlcst": "^2.0.0",
+ "@types/unist": "^3.0.0",
+ "nlcst-to-string": "^4.0.0",
+ "unist-util-modify-children": "^4.0.0",
+ "unist-util-visit-children": "^3.0.0",
+ "vfile": "^6.0.0"
+ },
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/parse5": {
+ "version": "7.3.0",
+ "resolved": "https://registry.npmjs.org/parse5/-/parse5-7.3.0.tgz",
+ "integrity": "sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==",
+ "license": "MIT",
+ "dependencies": {
+ "entities": "^6.0.0"
+ },
+ "funding": {
+ "url": "https://github.com/inikulin/parse5?sponsor=1"
+ }
+ },
+ "node_modules/path-browserify": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-1.0.1.tgz",
+ "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/piccolore": {
+ "version": "0.1.3",
+ "resolved": "https://registry.npmjs.org/piccolore/-/piccolore-0.1.3.tgz",
+ "integrity": "sha512-o8bTeDWjE086iwKrROaDf31K0qC/BENdm15/uH9usSC/uZjJOKb2YGiVHfLY4GhwsERiPI1jmwI2XrA7ACOxVw==",
+ "license": "ISC"
+ },
+ "node_modules/picocolors": {
+ "version": "1.1.1",
+ "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+ "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+ "license": "ISC"
+ },
+ "node_modules/picomatch": {
+ "version": "4.0.5",
+ "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.5.tgz",
+ "integrity": "sha512-RvwwcruNjI1ncT5xRakeyS9Lf8lcItv34KD+aif+VH9kduAyfYBipGh12274xtenIPZ119/R9BdTBa8gAwSh0A==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/jonschlinkert"
+ }
+ },
+ "node_modules/playwright": {
+ "version": "1.62.1",
+ "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.62.1.tgz",
+ "integrity": "sha512-0M+L3LAD8/nm554LOla9Ayx0j0tmFZ0FBcoQ7F1VuVHpM/XpiC8RcDzBQB8W5+hA8L22THxELzeF+2WcUzvcLg==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "playwright-core": "1.62.1"
+ },
+ "bin": {
+ "playwright": "cli.js"
+ },
+ "engines": {
+ "node": ">=20"
+ },
+ "optionalDependencies": {
+ "fsevents": "2.3.2"
+ }
+ },
+ "node_modules/playwright-core": {
+ "version": "1.62.1",
+ "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.62.1.tgz",
+ "integrity": "sha512-wPYSwEBJY9GHraISXqyqtx0na0LpO3XEX7jNDhntbex7tzUS7kLnZsOlFruFJB4Hi/rhDMjXGqHewDZ68nYZVw==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "bin": {
+ "playwright-core": "cli.js"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/playwright/node_modules/fsevents": {
+ "version": "2.3.2",
+ "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.2.tgz",
+ "integrity": "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==",
+ "dev": true,
+ "hasInstallScript": true,
+ "license": "MIT",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+ }
+ },
+ "node_modules/postcss": {
+ "version": "8.5.26",
+ "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.26.tgz",
+ "integrity": "sha512-u82N74LFzG8ca+dD8puPnplTXoGH4fTPpVGuIbt36G3qvNlkvfD0lEAZSxaly3KX8TS/L1A1gsCEmvKmBcVbkQ==",
+ "funding": [
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/postcss/"
+ },
+ {
+ "type": "tidelift",
+ "url": "https://tidelift.com/funding/github/npm/postcss"
+ },
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/ai"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "nanoid": "^3.3.17",
+ "picocolors": "^1.1.1",
+ "source-map-js": "^1.2.1"
+ },
+ "engines": {
+ "node": "^10 || ^12 || >=14"
+ }
+ },
+ "node_modules/postcss-nested": {
+ "version": "6.2.0",
+ "resolved": "https://registry.npmjs.org/postcss-nested/-/postcss-nested-6.2.0.tgz",
+ "integrity": "sha512-HQbt28KulC5AJzG+cZtj9kvKB93CFCdLvog1WFLf1D+xmMvPGlBstkpTEZfK5+AN9hfJocyBFCNiqyS48bpgzQ==",
+ "funding": [
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/postcss/"
+ },
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/ai"
+ }
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "postcss-selector-parser": "^6.1.1"
+ },
+ "engines": {
+ "node": ">=12.0"
+ },
+ "peerDependencies": {
+ "postcss": "^8.2.14"
+ }
+ },
+ "node_modules/postcss-selector-parser": {
+ "version": "6.1.4",
+ "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.1.4.tgz",
+ "integrity": "sha512-bIoJLOmjCO1S9XdY/DcnR5hJxvrDir1PbGChrzXG3vw0/FOliy/fA3dmdhQ441kah4gKv+TwckGzex6wNS5cnQ==",
+ "license": "MIT",
+ "dependencies": {
+ "cssesc": "^3.0.0",
+ "util-deprecate": "^1.0.2"
+ },
+ "engines": {
+ "node": ">=4"
+ }
+ },
+ "node_modules/prettier": {
+ "version": "3.9.6",
+ "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.9.6.tgz",
+ "integrity": "sha512-OpN0zzVdiaiAhxpuuj5efpIS4sY9j7bY6uR5mnj5yPzGkdkjNKSJeUThPb60Jw29QuAZgA4o+/iB49kFiaBX6g==",
+ "dev": true,
+ "license": "MIT",
+ "bin": {
+ "prettier": "bin/prettier.cjs"
+ },
+ "engines": {
+ "node": ">=14"
+ },
+ "funding": {
+ "url": "https://github.com/prettier/prettier?sponsor=1"
+ }
+ },
+ "node_modules/prismjs": {
+ "version": "1.30.0",
+ "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.30.0.tgz",
+ "integrity": "sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/process-ancestry": {
+ "version": "0.1.0",
+ "resolved": "https://registry.npmjs.org/process-ancestry/-/process-ancestry-0.1.0.tgz",
+ "integrity": "sha512-tGqJW/UnclpYASFcM6Xh8D8l/BMtaQ9+CSG0vlJSJTcdMM4lDRv4c6H0Pdcsfted+bVczdYSfk2fdukg2gQkZg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=18.0.0"
+ }
+ },
+ "node_modules/property-information": {
+ "version": "7.2.0",
+ "resolved": "https://registry.npmjs.org/property-information/-/property-information-7.2.0.tgz",
+ "integrity": "sha512-IAtzIB6sUiWaJYrX9smp3V46pBGbBeLFRGdh25kg1334VcBlD8HzhPeNIWQH9zhGmo2itIe25EHt9dQP7G5hmg==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/radix3": {
+ "version": "1.1.2",
+ "resolved": "https://registry.npmjs.org/radix3/-/radix3-1.1.2.tgz",
+ "integrity": "sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA==",
+ "license": "MIT"
+ },
+ "node_modules/readdirp": {
+ "version": "4.1.2",
+ "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-4.1.2.tgz",
+ "integrity": "sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 14.18.0"
+ },
+ "funding": {
+ "type": "individual",
+ "url": "https://paulmillr.com/funding/"
+ }
+ },
+ "node_modules/recma-build-jsx": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/recma-build-jsx/-/recma-build-jsx-1.0.0.tgz",
+ "integrity": "sha512-8GtdyqaBcDfva+GUKDr3nev3VpKAhup1+RvkMvUxURHpW7QyIvk9F5wz7Vzo06CEMSilw6uArgRqhpiUcWp8ew==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "estree-util-build-jsx": "^3.0.0",
+ "vfile": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/recma-jsx": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/recma-jsx/-/recma-jsx-1.0.1.tgz",
+ "integrity": "sha512-huSIy7VU2Z5OLv6oFLosQGGDqPqdO1iq6bWNAdhzMxSJP7RAso4fCZ1cKu8j9YHCZf3TPrq4dw3okhrylgcd7w==",
+ "license": "MIT",
+ "dependencies": {
+ "acorn-jsx": "^5.0.0",
+ "estree-util-to-js": "^2.0.0",
+ "recma-parse": "^1.0.0",
+ "recma-stringify": "^1.0.0",
+ "unified": "^11.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ },
+ "peerDependencies": {
+ "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0"
+ }
+ },
+ "node_modules/recma-parse": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/recma-parse/-/recma-parse-1.0.0.tgz",
+ "integrity": "sha512-OYLsIGBB5Y5wjnSnQW6t3Xg7q3fQ7FWbw/vcXtORTnyaSFscOtABg+7Pnz6YZ6c27fG1/aN8CjfwoUEUIdwqWQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "esast-util-from-js": "^2.0.0",
+ "unified": "^11.0.0",
+ "vfile": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/recma-stringify": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/recma-stringify/-/recma-stringify-1.0.0.tgz",
+ "integrity": "sha512-cjwII1MdIIVloKvC9ErQ+OgAtwHBmcZ0Bg4ciz78FtbT8In39aAYbaA7zvxQ61xVMSPE8WxhLwLbhif4Js2C+g==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "estree-util-to-js": "^2.0.0",
+ "unified": "^11.0.0",
+ "vfile": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/regex": {
+ "version": "6.1.0",
+ "resolved": "https://registry.npmjs.org/regex/-/regex-6.1.0.tgz",
+ "integrity": "sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg==",
+ "license": "MIT",
+ "dependencies": {
+ "regex-utilities": "^2.3.0"
+ }
+ },
+ "node_modules/regex-recursion": {
+ "version": "6.0.2",
+ "resolved": "https://registry.npmjs.org/regex-recursion/-/regex-recursion-6.0.2.tgz",
+ "integrity": "sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg==",
+ "license": "MIT",
+ "dependencies": {
+ "regex-utilities": "^2.3.0"
+ }
+ },
+ "node_modules/regex-utilities": {
+ "version": "2.3.0",
+ "resolved": "https://registry.npmjs.org/regex-utilities/-/regex-utilities-2.3.0.tgz",
+ "integrity": "sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng==",
+ "license": "MIT"
+ },
+ "node_modules/rehype": {
+ "version": "13.0.2",
+ "resolved": "https://registry.npmjs.org/rehype/-/rehype-13.0.2.tgz",
+ "integrity": "sha512-j31mdaRFrwFRUIlxGeuPXXKWQxet52RBQRvCmzl5eCefn/KGbomK5GMHNMsOJf55fgo3qw5tST5neDuarDYR2A==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "rehype-parse": "^9.0.0",
+ "rehype-stringify": "^10.0.0",
+ "unified": "^11.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/rehype-expressive-code": {
+ "version": "0.44.1",
+ "resolved": "https://registry.npmjs.org/rehype-expressive-code/-/rehype-expressive-code-0.44.1.tgz",
+ "integrity": "sha512-+VZgs7Evw4LXRN3owpoBNSTpYuW6GeOdjqcUT1TuY8o/4MGPtbd0EU7Bgrju7X8KrQ6SslOBAuGWJ5fV5TriJQ==",
+ "license": "MIT",
+ "dependencies": {
+ "expressive-code": "^0.44.1"
+ }
+ },
+ "node_modules/rehype-format": {
+ "version": "5.0.1",
+ "resolved": "https://registry.npmjs.org/rehype-format/-/rehype-format-5.0.1.tgz",
+ "integrity": "sha512-zvmVru9uB0josBVpr946OR8ui7nJEdzZobwLOOqHb/OOD88W0Vk2SqLwoVOj0fM6IPCCO6TaV9CvQvJMWwukFQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "hast-util-format": "^1.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/rehype-parse": {
+ "version": "9.0.1",
+ "resolved": "https://registry.npmjs.org/rehype-parse/-/rehype-parse-9.0.1.tgz",
+ "integrity": "sha512-ksCzCD0Fgfh7trPDxr2rSylbwq9iYDkSn8TCDmEJ49ljEUBxDVCzCHv7QNzZOfODanX4+bWQ4WZqLCRWYLfhag==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "hast-util-from-html": "^2.0.0",
+ "unified": "^11.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/rehype-raw": {
+ "version": "7.0.0",
+ "resolved": "https://registry.npmjs.org/rehype-raw/-/rehype-raw-7.0.0.tgz",
+ "integrity": "sha512-/aE8hCfKlQeA8LmyeyQvQF3eBiLRGNlfBJEvWH7ivp9sBqs7TNqBL5X3v157rM4IFETqDnIOO+z5M/biZbo9Ww==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "hast-util-raw": "^9.0.0",
+ "vfile": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/rehype-recma": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/rehype-recma/-/rehype-recma-1.0.0.tgz",
+ "integrity": "sha512-lqA4rGUf1JmacCNWWZx0Wv1dHqMwxzsDWYMTowuplHF3xH0N/MmrZ/G3BDZnzAkRmxDadujCjaKM2hqYdCBOGw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree": "^1.0.0",
+ "@types/hast": "^3.0.0",
+ "hast-util-to-estree": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/rehype-stringify": {
+ "version": "10.0.1",
+ "resolved": "https://registry.npmjs.org/rehype-stringify/-/rehype-stringify-10.0.1.tgz",
+ "integrity": "sha512-k9ecfXHmIPuFVI61B9DeLPN0qFHfawM6RsuX48hoqlaKSF61RskNjSm1lI8PhBEM0MRdLxVVm4WmTqJQccH9mA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "hast-util-to-html": "^9.0.0",
+ "unified": "^11.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/remark-directive": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/remark-directive/-/remark-directive-4.0.0.tgz",
+ "integrity": "sha512-7sxn4RfF1o3izevPV1DheyGDD6X4c9hrGpfdUpm7uC++dqrnJxIZVkk7CoKqcLm0VUMAuOol7Mno3m6g8cfMuA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "mdast-util-directive": "^3.0.0",
+ "micromark-extension-directive": "^4.0.0",
+ "unified": "^11.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/remark-gfm": {
+ "version": "4.0.1",
+ "resolved": "https://registry.npmjs.org/remark-gfm/-/remark-gfm-4.0.1.tgz",
+ "integrity": "sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "mdast-util-gfm": "^3.0.0",
+ "micromark-extension-gfm": "^3.0.0",
+ "remark-parse": "^11.0.0",
+ "remark-stringify": "^11.0.0",
+ "unified": "^11.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/remark-mdx": {
+ "version": "3.1.1",
+ "resolved": "https://registry.npmjs.org/remark-mdx/-/remark-mdx-3.1.1.tgz",
+ "integrity": "sha512-Pjj2IYlUY3+D8x00UJsIOg5BEvfMyeI+2uLPn9VO9Wg4MEtN/VTIq2NEJQfde9PnX15KgtHyl9S0BcTnWrIuWg==",
+ "license": "MIT",
+ "dependencies": {
+ "mdast-util-mdx": "^3.0.0",
+ "micromark-extension-mdxjs": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/remark-parse": {
+ "version": "11.0.0",
+ "resolved": "https://registry.npmjs.org/remark-parse/-/remark-parse-11.0.0.tgz",
+ "integrity": "sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "mdast-util-from-markdown": "^2.0.0",
+ "micromark-util-types": "^2.0.0",
+ "unified": "^11.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/remark-rehype": {
+ "version": "11.1.2",
+ "resolved": "https://registry.npmjs.org/remark-rehype/-/remark-rehype-11.1.2.tgz",
+ "integrity": "sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/hast": "^3.0.0",
+ "@types/mdast": "^4.0.0",
+ "mdast-util-to-hast": "^13.0.0",
+ "unified": "^11.0.0",
+ "vfile": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/remark-smartypants": {
+ "version": "3.0.3",
+ "resolved": "https://registry.npmjs.org/remark-smartypants/-/remark-smartypants-3.0.3.tgz",
+ "integrity": "sha512-gCaK+ndZ0hYezlqFegHFCVh2CQemsi0Npdh1qVM9bxlUFknjkbP6VmojWhddOCrbK0PbbacmYLWfTULRiT1eWA==",
+ "license": "MIT",
+ "dependencies": {
+ "retext": "^9.0.0",
+ "retext-smartypants": "^6.0.0",
+ "unified": "^11.0.4",
+ "unist-util-visit": "^5.0.0"
+ },
+ "engines": {
+ "node": ">=16.0.0"
+ }
+ },
+ "node_modules/remark-stringify": {
+ "version": "11.0.0",
+ "resolved": "https://registry.npmjs.org/remark-stringify/-/remark-stringify-11.0.0.tgz",
+ "integrity": "sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/mdast": "^4.0.0",
+ "mdast-util-to-markdown": "^2.0.0",
+ "unified": "^11.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/request-light": {
+ "version": "0.7.0",
+ "resolved": "https://registry.npmjs.org/request-light/-/request-light-0.7.0.tgz",
+ "integrity": "sha512-lMbBMrDoxgsyO+yB3sDcrDuX85yYt7sS8BfQd11jtbW/z5ZWgLZRcEGLsLoYw7I0WSUGQBs8CC8ScIxkTX1+6Q==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/require-from-string": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+ "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=0.10.0"
+ }
+ },
+ "node_modules/resolve-pkg-maps": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz",
+ "integrity": "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==",
+ "license": "MIT",
+ "funding": {
+ "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1"
+ }
+ },
+ "node_modules/retext": {
+ "version": "9.0.0",
+ "resolved": "https://registry.npmjs.org/retext/-/retext-9.0.0.tgz",
+ "integrity": "sha512-sbMDcpHCNjvlheSgMfEcVrZko3cDzdbe1x/e7G66dFp0Ff7Mldvi2uv6JkJQzdRcvLYE8CA8Oe8siQx8ZOgTcA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/nlcst": "^2.0.0",
+ "retext-latin": "^4.0.0",
+ "retext-stringify": "^4.0.0",
+ "unified": "^11.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/retext-latin": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/retext-latin/-/retext-latin-4.0.0.tgz",
+ "integrity": "sha512-hv9woG7Fy0M9IlRQloq/N6atV82NxLGveq+3H2WOi79dtIYWN8OaxogDm77f8YnVXJL2VD3bbqowu5E3EMhBYA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/nlcst": "^2.0.0",
+ "parse-latin": "^7.0.0",
+ "unified": "^11.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/retext-smartypants": {
+ "version": "6.2.0",
+ "resolved": "https://registry.npmjs.org/retext-smartypants/-/retext-smartypants-6.2.0.tgz",
+ "integrity": "sha512-kk0jOU7+zGv//kfjXEBjdIryL1Acl4i9XNkHxtM7Tm5lFiCog576fjNC9hjoR7LTKQ0DsPWy09JummSsH1uqfQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/nlcst": "^2.0.0",
+ "nlcst-to-string": "^4.0.0",
+ "unist-util-visit": "^5.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/retext-stringify": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/retext-stringify/-/retext-stringify-4.0.0.tgz",
+ "integrity": "sha512-rtfN/0o8kL1e+78+uxPTqu1Klt0yPzKuQ2BfWwwfgIUSayyzxpM1PJzkKt4V8803uB9qSy32MvI7Xep9khTpiA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/nlcst": "^2.0.0",
+ "nlcst-to-string": "^4.0.0",
+ "unified": "^11.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/rolldown": {
+ "version": "1.2.5",
+ "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.2.5.tgz",
+ "integrity": "sha512-VD2IE5PUG4Oj8zz2VGykiYd5wbnjdIiSsNQb8Qu5B+noEp+A78mu2iVvpp27g8es14Tk9rofNs5Tku9iQCS4fA==",
+ "license": "MIT",
+ "dependencies": {
+ "@oxc-project/types": "=0.146.0",
+ "@rolldown/pluginutils": "^1.0.0"
+ },
+ "bin": {
+ "rolldown": "bin/cli.mjs"
+ },
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ },
+ "optionalDependencies": {
+ "@rolldown/binding-android-arm-eabi": "1.2.5",
+ "@rolldown/binding-android-arm64": "1.2.5",
+ "@rolldown/binding-darwin-arm64": "1.2.5",
+ "@rolldown/binding-darwin-x64": "1.2.5",
+ "@rolldown/binding-freebsd-x64": "1.2.5",
+ "@rolldown/binding-linux-arm-gnueabihf": "1.2.5",
+ "@rolldown/binding-linux-arm64-gnu": "1.2.5",
+ "@rolldown/binding-linux-arm64-musl": "1.2.5",
+ "@rolldown/binding-linux-ppc64-gnu": "1.2.5",
+ "@rolldown/binding-linux-s390x-gnu": "1.2.5",
+ "@rolldown/binding-linux-x64-gnu": "1.2.5",
+ "@rolldown/binding-linux-x64-musl": "1.2.5",
+ "@rolldown/binding-openharmony-arm64": "1.2.5",
+ "@rolldown/binding-win32-arm64-msvc": "1.2.5",
+ "@rolldown/binding-win32-x64-msvc": "1.2.5"
+ }
+ },
+ "node_modules/satteri": {
+ "version": "0.9.5",
+ "resolved": "https://registry.npmjs.org/satteri/-/satteri-0.9.5.tgz",
+ "integrity": "sha512-ZuWVl+vnM64y+/TtX8Kosv2c00W+hLQiiwnEL6H0UKVVrxFqMw4D2CJHHQaouVd89OAhtBBfjWLqhKi3TVUV4w==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/estree-jsx": "^1.0.5",
+ "@types/hast": "^3.0.4",
+ "@types/mdast": "^4.0.4",
+ "@types/unist": "^3.0.3"
+ },
+ "optionalDependencies": {
+ "@bruits/satteri-darwin-arm64": "0.9.5",
+ "@bruits/satteri-darwin-x64": "0.9.5",
+ "@bruits/satteri-linux-arm64-gnu": "0.9.5",
+ "@bruits/satteri-linux-arm64-musl": "0.9.5",
+ "@bruits/satteri-linux-x64-gnu": "0.9.5",
+ "@bruits/satteri-linux-x64-musl": "0.9.5",
+ "@bruits/satteri-wasm32-wasi": "0.9.5",
+ "@bruits/satteri-win32-arm64-msvc": "0.9.5",
+ "@bruits/satteri-win32-x64-msvc": "0.9.5"
+ }
+ },
+ "node_modules/sax": {
+ "version": "1.6.1",
+ "resolved": "https://registry.npmjs.org/sax/-/sax-1.6.1.tgz",
+ "integrity": "sha512-42tBVwLWnaQvW5zc4HbZrTuWccECCZfBi92FDuwtqxasH+JbPB3/FOKb1m222K42R4WxuxzzMsTswfzgtSu64Q==",
+ "license": "BlueOak-1.0.0",
+ "engines": {
+ "node": ">=11.0.0"
+ }
+ },
+ "node_modules/semver": {
+ "version": "7.8.5",
+ "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
+ "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
+ "license": "ISC",
+ "bin": {
+ "semver": "bin/semver.js"
+ },
+ "engines": {
+ "node": ">=10"
+ }
+ },
+ "node_modules/sharp": {
+ "version": "0.35.3",
+ "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.35.3.tgz",
+ "integrity": "sha512-ej0zVHuZGHCiABXcNxeYhpRnPNPAcvbG8RMdBAhDAxLKkCRVSpK3Iyu7qbqw3JMzoj0REeM6f3tJLtVwl0023Q==",
+ "license": "Apache-2.0",
+ "optional": true,
+ "dependencies": {
+ "@img/colour": "^1.1.0",
+ "detect-libc": "^2.1.2",
+ "semver": "^7.8.5"
+ },
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-darwin-arm64": "0.35.3",
+ "@img/sharp-darwin-x64": "0.35.3",
+ "@img/sharp-freebsd-wasm32": "0.35.3",
+ "@img/sharp-libvips-darwin-arm64": "1.3.2",
+ "@img/sharp-libvips-darwin-x64": "1.3.2",
+ "@img/sharp-libvips-linux-arm": "1.3.2",
+ "@img/sharp-libvips-linux-arm64": "1.3.2",
+ "@img/sharp-libvips-linux-ppc64": "1.3.2",
+ "@img/sharp-libvips-linux-riscv64": "1.3.2",
+ "@img/sharp-libvips-linux-s390x": "1.3.2",
+ "@img/sharp-libvips-linux-x64": "1.3.2",
+ "@img/sharp-libvips-linuxmusl-arm64": "1.3.2",
+ "@img/sharp-libvips-linuxmusl-x64": "1.3.2",
+ "@img/sharp-linux-arm": "0.35.3",
+ "@img/sharp-linux-arm64": "0.35.3",
+ "@img/sharp-linux-ppc64": "0.35.3",
+ "@img/sharp-linux-riscv64": "0.35.3",
+ "@img/sharp-linux-s390x": "0.35.3",
+ "@img/sharp-linux-x64": "0.35.3",
+ "@img/sharp-linuxmusl-arm64": "0.35.3",
+ "@img/sharp-linuxmusl-x64": "0.35.3",
+ "@img/sharp-webcontainers-wasm32": "0.35.3",
+ "@img/sharp-win32-arm64": "0.35.3",
+ "@img/sharp-win32-ia32": "0.35.3",
+ "@img/sharp-win32-x64": "0.35.3"
+ },
+ "peerDependenciesMeta": {
+ "@types/node": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/shiki": {
+ "version": "4.4.3",
+ "resolved": "https://registry.npmjs.org/shiki/-/shiki-4.4.3.tgz",
+ "integrity": "sha512-Mb/GvXPHBAXdgGIcnfU5L3ldpn1XcxrGkPHwqgRx17/I2XRfqlFKk2vGkHWINn1kdXvzJZeuO3is6I9KLPFm0g==",
+ "license": "MIT",
+ "dependencies": {
+ "@shikijs/core": "4.4.3",
+ "@shikijs/engine-javascript": "4.4.3",
+ "@shikijs/engine-oniguruma": "4.4.3",
+ "@shikijs/langs": "4.4.3",
+ "@shikijs/themes": "4.4.3",
+ "@shikijs/types": "4.4.3",
+ "@shikijs/vscode-textmate": "^10.0.2",
+ "@types/hast": "^3.0.5"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/sisteransi": {
+ "version": "1.0.5",
+ "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz",
+ "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==",
+ "license": "MIT"
+ },
+ "node_modules/sitemap": {
+ "version": "9.0.1",
+ "resolved": "https://registry.npmjs.org/sitemap/-/sitemap-9.0.1.tgz",
+ "integrity": "sha512-S6hzjGJSG3d6if0YoF5kTyeRJvia6FSTBroE5fQ0bu1QNxyJqhhinfUsXi9fH3MgtXODWvwo2BDyQSnhPQ88uQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/node": "^24.9.2",
+ "@types/sax": "^1.2.1",
+ "arg": "^5.0.0",
+ "sax": "^1.4.1"
+ },
+ "bin": {
+ "sitemap": "dist/esm/cli.js"
+ },
+ "engines": {
+ "node": ">=20.19.5",
+ "npm": ">=10.8.2"
+ }
+ },
+ "node_modules/smol-toml": {
+ "version": "1.8.0",
+ "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.8.0.tgz",
+ "integrity": "sha512-kCZr2V3ch9i00x8zXRhjUNVcjG9ijES5dDudkXvUVCT5QlJNQWElSJdZqyPemffHoLNUYwOcou0Fy+ojN0uHSQ==",
+ "license": "BSD-3-Clause",
+ "engines": {
+ "node": ">= 18"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/cyyynthia"
+ }
+ },
+ "node_modules/source-map": {
+ "version": "0.7.6",
+ "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.7.6.tgz",
+ "integrity": "sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==",
+ "license": "BSD-3-Clause",
+ "engines": {
+ "node": ">= 12"
+ }
+ },
+ "node_modules/source-map-js": {
+ "version": "1.2.1",
+ "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+ "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+ "license": "BSD-3-Clause",
+ "engines": {
+ "node": ">=0.10.0"
+ }
+ },
+ "node_modules/space-separated-tokens": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/space-separated-tokens/-/space-separated-tokens-2.0.2.tgz",
+ "integrity": "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/stream-replace-string": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/stream-replace-string/-/stream-replace-string-2.0.0.tgz",
+ "integrity": "sha512-TlnjJ1C0QrmxRNrON00JvaFFlNh5TTG00APw23j74ET7gkQpTASi6/L2fuiav8pzK715HXtUeClpBTw2NPSn6w==",
+ "license": "MIT"
+ },
+ "node_modules/string-width": {
+ "version": "8.2.2",
+ "resolved": "https://registry.npmjs.org/string-width/-/string-width-8.2.2.tgz",
+ "integrity": "sha512-GaPUh5gfdrYzqeVNZvUfT23vYYxXzKYidUcnMtJg/3rxRV63EFZy3k6xfKlmfeJD0176lnUV/Usr3XcwSvFzpg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "get-east-asian-width": "^1.5.0",
+ "strip-ansi": "^7.1.2"
+ },
+ "engines": {
+ "node": ">=20"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/stringify-entities": {
+ "version": "4.0.4",
+ "resolved": "https://registry.npmjs.org/stringify-entities/-/stringify-entities-4.0.4.tgz",
+ "integrity": "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==",
+ "license": "MIT",
+ "dependencies": {
+ "character-entities-html4": "^2.0.0",
+ "character-entities-legacy": "^3.0.0"
+ },
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/strip-ansi": {
+ "version": "7.2.0",
+ "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz",
+ "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ansi-regex": "^6.2.2"
+ },
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+ }
+ },
+ "node_modules/style-to-js": {
+ "version": "1.1.21",
+ "resolved": "https://registry.npmjs.org/style-to-js/-/style-to-js-1.1.21.tgz",
+ "integrity": "sha512-RjQetxJrrUJLQPHbLku6U/ocGtzyjbJMP9lCNK7Ag0CNh690nSH8woqWH9u16nMjYBAok+i7JO1NP2pOy8IsPQ==",
+ "license": "MIT",
+ "dependencies": {
+ "style-to-object": "1.0.14"
+ }
+ },
+ "node_modules/style-to-object": {
+ "version": "1.0.14",
+ "resolved": "https://registry.npmjs.org/style-to-object/-/style-to-object-1.0.14.tgz",
+ "integrity": "sha512-LIN7rULI0jBscWQYaSswptyderlarFkjQ+t79nzty8tcIAceVomEVlLzH5VP4Cmsv6MtKhs7qaAiwlcp+Mgaxw==",
+ "license": "MIT",
+ "dependencies": {
+ "inline-style-parser": "0.2.7"
+ }
+ },
+ "node_modules/supports-color": {
+ "version": "7.2.0",
+ "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+ "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+ "license": "MIT",
+ "dependencies": {
+ "has-flag": "^4.0.0"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/svgo": {
+ "version": "4.0.2",
+ "resolved": "https://registry.npmjs.org/svgo/-/svgo-4.0.2.tgz",
+ "integrity": "sha512-ekx94z1rRc5LDi6oSUaeRnYhd0UOJxdtQCL2rF8xpWxD3TPAsISWOrxezqGovqS38GRZOdpDfvQe3ts6F7nsng==",
+ "license": "MIT",
+ "dependencies": {
+ "commander": "^11.1.0",
+ "css-select": "^5.1.0",
+ "css-tree": "^3.0.1",
+ "css-what": "^6.1.0",
+ "csso": "^5.0.5",
+ "picocolors": "^1.1.1",
+ "sax": "^1.5.0"
+ },
+ "bin": {
+ "svgo": "bin/svgo.js"
+ },
+ "engines": {
+ "node": ">=16"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/svgo"
+ }
+ },
+ "node_modules/svgo/node_modules/commander": {
+ "version": "11.1.0",
+ "resolved": "https://registry.npmjs.org/commander/-/commander-11.1.0.tgz",
+ "integrity": "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=16"
+ }
+ },
+ "node_modules/tiny-inflate": {
+ "version": "1.0.3",
+ "resolved": "https://registry.npmjs.org/tiny-inflate/-/tiny-inflate-1.0.3.tgz",
+ "integrity": "sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw==",
+ "license": "MIT"
+ },
+ "node_modules/tinyclip": {
+ "version": "0.1.15",
+ "resolved": "https://registry.npmjs.org/tinyclip/-/tinyclip-0.1.15.tgz",
+ "integrity": "sha512-uo33abH+Ays0xYaDysoBt494Hb3hsEczMpcC0MwFl773pazORx4fmvKhclhR1wonUbB6vvpRsvVMwnhfqeMc+A==",
+ "license": "MIT",
+ "engines": {
+ "node": "^16.14.0 || >= 17.3.0"
+ }
+ },
+ "node_modules/tinyexec": {
+ "version": "1.3.0",
+ "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.3.0.tgz",
+ "integrity": "sha512-QKAl9m8gWWGHV8jZcPeym6j+XULi6tOf1mT83WYJ4Lk2ytW/uwAWkrP0uFsdoYMdueVJ0qs26wZ+23xeB4ibNQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/tinyglobby": {
+ "version": "0.2.17",
+ "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz",
+ "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==",
+ "license": "MIT",
+ "dependencies": {
+ "fdir": "^6.5.0",
+ "picomatch": "^4.0.4"
+ },
+ "engines": {
+ "node": ">=12.0.0"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/SuperchupuDev"
+ }
+ },
+ "node_modules/trim-lines": {
+ "version": "3.0.1",
+ "resolved": "https://registry.npmjs.org/trim-lines/-/trim-lines-3.0.1.tgz",
+ "integrity": "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/trough": {
+ "version": "2.2.0",
+ "resolved": "https://registry.npmjs.org/trough/-/trough-2.2.0.tgz",
+ "integrity": "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/tslib": {
+ "version": "2.8.1",
+ "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+ "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+ "license": "0BSD",
+ "optional": true
+ },
+ "node_modules/typesafe-path": {
+ "version": "0.2.2",
+ "resolved": "https://registry.npmjs.org/typesafe-path/-/typesafe-path-0.2.2.tgz",
+ "integrity": "sha512-OJabfkAg1WLZSqJAJ0Z6Sdt3utnbzr/jh+NAHoyWHJe8CMSy79Gm085094M9nvTPy22KzTVn5Zq5mbapCI/hPA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/typescript": {
+ "version": "6.0.3",
+ "resolved": "https://registry.npmjs.org/typescript/-/typescript-6.0.3.tgz",
+ "integrity": "sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==",
+ "devOptional": true,
+ "license": "Apache-2.0",
+ "bin": {
+ "tsc": "bin/tsc",
+ "tsserver": "bin/tsserver"
+ },
+ "engines": {
+ "node": ">=14.17"
+ }
+ },
+ "node_modules/typescript-auto-import-cache": {
+ "version": "0.3.6",
+ "resolved": "https://registry.npmjs.org/typescript-auto-import-cache/-/typescript-auto-import-cache-0.3.6.tgz",
+ "integrity": "sha512-RpuHXrknHdVdK7wv/8ug3Fr0WNsNi5l5aB8MYYuXhq2UH5lnEB1htJ1smhtD5VeCsGr2p8mUDtd83LCQDFVgjQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "semver": "^7.3.8"
+ }
+ },
+ "node_modules/ufo": {
+ "version": "1.6.4",
+ "resolved": "https://registry.npmjs.org/ufo/-/ufo-1.6.4.tgz",
+ "integrity": "sha512-JFNbkD1Svwe0KvGi8GOeLcP4kAWQ609twvCdcHxq1oSL8svv39ZuSvajcD8B+5D0eL4+s1Is2D/O6KN3qcTeRA==",
+ "license": "MIT"
+ },
+ "node_modules/ultrahtml": {
+ "version": "1.7.0",
+ "resolved": "https://registry.npmjs.org/ultrahtml/-/ultrahtml-1.7.0.tgz",
+ "integrity": "sha512-2xRd0VHoAQE4M+vF/DvFFB7pUV0ZxTW1TLi7lHQWnF/Sb5TPeEUV/l+hxcNnGO00ZXGnR0voCMmYRKQf+rvJ2g==",
+ "license": "MIT"
+ },
+ "node_modules/uncrypto": {
+ "version": "0.1.3",
+ "resolved": "https://registry.npmjs.org/uncrypto/-/uncrypto-0.1.3.tgz",
+ "integrity": "sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q==",
+ "license": "MIT"
+ },
+ "node_modules/undici": {
+ "version": "8.10.0",
+ "resolved": "https://registry.npmjs.org/undici/-/undici-8.10.0.tgz",
+ "integrity": "sha512-HvltHd7avK13QIw/oLe4qoOLyoVSoafqJ2jYOrtMRBkbYT31eiBQ8O0ehRKZiEZCMEyLFQNIADpgCWC5fALvYQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=22.19.0"
+ }
+ },
+ "node_modules/undici-types": {
+ "version": "7.18.2",
+ "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz",
+ "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==",
+ "license": "MIT"
+ },
+ "node_modules/unified": {
+ "version": "11.0.5",
+ "resolved": "https://registry.npmjs.org/unified/-/unified-11.0.5.tgz",
+ "integrity": "sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0",
+ "bail": "^2.0.0",
+ "devlop": "^1.0.0",
+ "extend": "^3.0.0",
+ "is-plain-obj": "^4.0.0",
+ "trough": "^2.0.0",
+ "vfile": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/unifont": {
+ "version": "0.7.5",
+ "resolved": "https://registry.npmjs.org/unifont/-/unifont-0.7.5.tgz",
+ "integrity": "sha512-ULe/Cs+ZIsq+dcFofNkhqielCrUJnb5mr+Yc4EBM2VlL+6OZR6+cjtI2mT1bJvRBrVncqHAbLURxmPLcCXzWMg==",
+ "license": "MIT",
+ "dependencies": {
+ "css-tree": "^3.1.0",
+ "ohash": "^2.0.11",
+ "undici": "^8.0.0"
+ }
+ },
+ "node_modules/unist-util-find-after": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/unist-util-find-after/-/unist-util-find-after-5.0.0.tgz",
+ "integrity": "sha512-amQa0Ep2m6hE2g72AugUItjbuM8X8cGQnFoHk0pGfrFeT9GZhzN5SW8nRsiGKK7Aif4CrACPENkA6P/Lw6fHGQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0",
+ "unist-util-is": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/unist-util-is": {
+ "version": "6.0.1",
+ "resolved": "https://registry.npmjs.org/unist-util-is/-/unist-util-is-6.0.1.tgz",
+ "integrity": "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/unist-util-modify-children": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/unist-util-modify-children/-/unist-util-modify-children-4.0.0.tgz",
+ "integrity": "sha512-+tdN5fGNddvsQdIzUF3Xx82CU9sMM+fA0dLgR9vOmT0oPT2jH+P1nd5lSqfCfXAw+93NhcXNY2qqvTUtE4cQkw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0",
+ "array-iterate": "^2.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/unist-util-position": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/unist-util-position/-/unist-util-position-5.0.0.tgz",
+ "integrity": "sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/unist-util-position-from-estree": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/unist-util-position-from-estree/-/unist-util-position-from-estree-2.0.0.tgz",
+ "integrity": "sha512-KaFVRjoqLyF6YXCbVLNad/eS4+OfPQQn2yOd7zF/h5T/CSL2v8NpN6a5TPvtbXthAGw5nG+PuTtq+DdIZr+cRQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/unist-util-remove-position": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/unist-util-remove-position/-/unist-util-remove-position-5.0.0.tgz",
+ "integrity": "sha512-Hp5Kh3wLxv0PHj9m2yZhhLt58KzPtEYKQQ4yxfYFEO7EvHwzyDYnduhHnY1mDxoqr7VUwVuHXk9RXKIiYS1N8Q==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0",
+ "unist-util-visit": "^5.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/unist-util-stringify-position": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/unist-util-stringify-position/-/unist-util-stringify-position-4.0.0.tgz",
+ "integrity": "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/unist-util-visit": {
+ "version": "5.1.0",
+ "resolved": "https://registry.npmjs.org/unist-util-visit/-/unist-util-visit-5.1.0.tgz",
+ "integrity": "sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0",
+ "unist-util-is": "^6.0.0",
+ "unist-util-visit-parents": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/unist-util-visit-children": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/unist-util-visit-children/-/unist-util-visit-children-3.0.0.tgz",
+ "integrity": "sha512-RgmdTfSBOg04sdPcpTSD1jzoNBjt9a80/ZCzp5cI9n1qPzLZWF9YdvWGN2zmTumP1HWhXKdUWexjy/Wy/lJ7tA==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/unist-util-visit-parents": {
+ "version": "6.0.2",
+ "resolved": "https://registry.npmjs.org/unist-util-visit-parents/-/unist-util-visit-parents-6.0.2.tgz",
+ "integrity": "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0",
+ "unist-util-is": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/unstorage": {
+ "version": "1.17.5",
+ "resolved": "https://registry.npmjs.org/unstorage/-/unstorage-1.17.5.tgz",
+ "integrity": "sha512-0i3iqvRfx29hkNntHyQvJTpf5W9dQ9ZadSoRU8+xVlhVtT7jAX57fazYO9EHvcRCfBCyi5YRya7XCDOsbTgkPg==",
+ "license": "MIT",
+ "dependencies": {
+ "anymatch": "^3.1.3",
+ "chokidar": "^5.0.0",
+ "destr": "^2.0.5",
+ "h3": "^1.15.10",
+ "lru-cache": "^11.2.7",
+ "node-fetch-native": "^1.6.7",
+ "ofetch": "^1.5.1",
+ "ufo": "^1.6.3"
+ },
+ "peerDependencies": {
+ "@azure/app-configuration": "^1.8.0",
+ "@azure/cosmos": "^4.2.0",
+ "@azure/data-tables": "^13.3.0",
+ "@azure/identity": "^4.6.0",
+ "@azure/keyvault-secrets": "^4.9.0",
+ "@azure/storage-blob": "^12.26.0",
+ "@capacitor/preferences": "^6 || ^7 || ^8",
+ "@deno/kv": ">=0.9.0",
+ "@netlify/blobs": "^6.5.0 || ^7.0.0 || ^8.1.0 || ^9.0.0 || ^10.0.0",
+ "@planetscale/database": "^1.19.0",
+ "@upstash/redis": "^1.34.3",
+ "@vercel/blob": ">=0.27.1",
+ "@vercel/functions": "^2.2.12 || ^3.0.0",
+ "@vercel/kv": "^1 || ^2 || ^3",
+ "aws4fetch": "^1.0.20",
+ "db0": ">=0.2.1",
+ "idb-keyval": "^6.2.1",
+ "ioredis": "^5.4.2",
+ "uploadthing": "^7.4.4"
+ },
+ "peerDependenciesMeta": {
+ "@azure/app-configuration": {
+ "optional": true
+ },
+ "@azure/cosmos": {
+ "optional": true
+ },
+ "@azure/data-tables": {
+ "optional": true
+ },
+ "@azure/identity": {
+ "optional": true
+ },
+ "@azure/keyvault-secrets": {
+ "optional": true
+ },
+ "@azure/storage-blob": {
+ "optional": true
+ },
+ "@capacitor/preferences": {
+ "optional": true
+ },
+ "@deno/kv": {
+ "optional": true
+ },
+ "@netlify/blobs": {
+ "optional": true
+ },
+ "@planetscale/database": {
+ "optional": true
+ },
+ "@upstash/redis": {
+ "optional": true
+ },
+ "@vercel/blob": {
+ "optional": true
+ },
+ "@vercel/functions": {
+ "optional": true
+ },
+ "@vercel/kv": {
+ "optional": true
+ },
+ "aws4fetch": {
+ "optional": true
+ },
+ "db0": {
+ "optional": true
+ },
+ "idb-keyval": {
+ "optional": true
+ },
+ "ioredis": {
+ "optional": true
+ },
+ "uploadthing": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/unstorage/node_modules/chokidar": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-5.0.0.tgz",
+ "integrity": "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==",
+ "license": "MIT",
+ "dependencies": {
+ "readdirp": "^5.0.0"
+ },
+ "engines": {
+ "node": ">= 20.19.0"
+ },
+ "funding": {
+ "url": "https://paulmillr.com/funding/"
+ }
+ },
+ "node_modules/unstorage/node_modules/readdirp": {
+ "version": "5.1.1",
+ "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-5.1.1.tgz",
+ "integrity": "sha512-Kko+Y5XQ6fM+Ce3dq3m9YGxnacYZYl9cA1wZjaF3Vbry2L3i1qVg8+CAgNPsXRArPMUMCaOR7oa9Nqntc43JKA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 20.19.0"
+ },
+ "funding": {
+ "type": "individual",
+ "url": "https://paulmillr.com/funding/"
+ }
+ },
+ "node_modules/url-extras": {
+ "version": "0.1.0",
+ "resolved": "https://registry.npmjs.org/url-extras/-/url-extras-0.1.0.tgz",
+ "integrity": "sha512-8tzwTeXFPuX/5PHuCDQE5Dd9Ts4rwoq2t9aIT+HS4iAVpmj5l4Ao7Q+BuuFjvWRqrLswBhQDk8O96ZicgCqQqw==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=20"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/util-deprecate": {
+ "version": "1.0.2",
+ "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+ "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+ "license": "MIT"
+ },
+ "node_modules/vfile": {
+ "version": "6.0.3",
+ "resolved": "https://registry.npmjs.org/vfile/-/vfile-6.0.3.tgz",
+ "integrity": "sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0",
+ "vfile-message": "^4.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/vfile-location": {
+ "version": "5.0.3",
+ "resolved": "https://registry.npmjs.org/vfile-location/-/vfile-location-5.0.3.tgz",
+ "integrity": "sha512-5yXvWDEgqeiYiBe1lbxYF7UMAIm/IcopxMHrMQDq3nvKcjPKIhZklUKL+AE7J7uApI4kwe2snsK+eI6UTj9EHg==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0",
+ "vfile": "^6.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/vfile-message": {
+ "version": "4.0.3",
+ "resolved": "https://registry.npmjs.org/vfile-message/-/vfile-message-4.0.3.tgz",
+ "integrity": "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==",
+ "license": "MIT",
+ "dependencies": {
+ "@types/unist": "^3.0.0",
+ "unist-util-stringify-position": "^4.0.0"
+ },
+ "funding": {
+ "type": "opencollective",
+ "url": "https://opencollective.com/unified"
+ }
+ },
+ "node_modules/vite": {
+ "version": "8.2.2",
+ "resolved": "https://registry.npmjs.org/vite/-/vite-8.2.2.tgz",
+ "integrity": "sha512-cFKLV/PRgAUlIRm5WjMjJ86jrftzpqcgH+Us+DS8mI3CDNiH30Whrz8uHL3+MOLPAgqbMBAqWdAHAphOAM+z/Q==",
+ "license": "MIT",
+ "dependencies": {
+ "lightningcss": "^1.33.0",
+ "picomatch": "^4.0.5",
+ "postcss": "^8.5.26",
+ "rolldown": "~1.2.4",
+ "tinyglobby": "^0.2.17"
+ },
+ "bin": {
+ "vite": "bin/vite.js"
+ },
+ "engines": {
+ "node": "^20.19.0 || >=22.12.0"
+ },
+ "funding": {
+ "url": "https://github.com/vitejs/vite?sponsor=1"
+ },
+ "optionalDependencies": {
+ "fsevents": "~2.3.3"
+ },
+ "peerDependencies": {
+ "@types/node": "^20.19.0 || >=22.12.0",
+ "@vitejs/devtools": "^0.4.0 || ^0.5.0",
+ "esbuild": "^0.27.0 || ^0.28.0",
+ "jiti": ">=1.21.0",
+ "less": "^4.0.0",
+ "sass": "^1.70.0",
+ "sass-embedded": "^1.70.0",
+ "stylus": ">=0.54.8",
+ "sugarss": "^5.0.0",
+ "terser": "^5.16.0",
+ "tsx": "^4.8.1",
+ "yaml": "^2.4.2"
+ },
+ "peerDependenciesMeta": {
+ "@types/node": {
+ "optional": true
+ },
+ "@vitejs/devtools": {
+ "optional": true
+ },
+ "esbuild": {
+ "optional": true
+ },
+ "jiti": {
+ "optional": true
+ },
+ "less": {
+ "optional": true
+ },
+ "sass": {
+ "optional": true
+ },
+ "sass-embedded": {
+ "optional": true
+ },
+ "stylus": {
+ "optional": true
+ },
+ "sugarss": {
+ "optional": true
+ },
+ "terser": {
+ "optional": true
+ },
+ "tsx": {
+ "optional": true
+ },
+ "yaml": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/vitefu": {
+ "version": "1.1.3",
+ "resolved": "https://registry.npmjs.org/vitefu/-/vitefu-1.1.3.tgz",
+ "integrity": "sha512-ub4okH7Z5KLjb6hDyjqrGXqWtWvoYdU3IGm/NorpgHncKoLTCfRIbvlhBm7r0YstIaQRYlp4yEbFqDcKSzXSSg==",
+ "license": "MIT",
+ "workspaces": [
+ "tests/deps/*",
+ "tests/projects/*",
+ "tests/projects/workspace/packages/*"
+ ],
+ "peerDependencies": {
+ "vite": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
+ },
+ "peerDependenciesMeta": {
+ "vite": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/volar-service-css": {
+ "version": "0.0.71",
+ "resolved": "https://registry.npmjs.org/volar-service-css/-/volar-service-css-0.0.71.tgz",
+ "integrity": "sha512-wRRFt9BpjMKCazcgOh67MSjUjiWUCAh99DyYSDIOTuxaRjEtDC7PpB0k1Y1wbJIW/pVtMUSVbpPo3UGSm0Byxw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "vscode-css-languageservice": "^6.3.0",
+ "vscode-languageserver-textdocument": "^1.0.11",
+ "vscode-uri": "^3.0.8"
+ },
+ "peerDependencies": {
+ "@volar/language-service": "~2.4.0"
+ },
+ "peerDependenciesMeta": {
+ "@volar/language-service": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/volar-service-emmet": {
+ "version": "0.0.71",
+ "resolved": "https://registry.npmjs.org/volar-service-emmet/-/volar-service-emmet-0.0.71.tgz",
+ "integrity": "sha512-zqjzt6bN95e3CUstBm0PBFAJnrfz0ZAARka87fart46/gNCLLuP3Vujy8V/J8HEziTFLnfkgIASLFYPUhonJcA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@emmetio/css-parser": "^0.4.1",
+ "@emmetio/html-matcher": "^1.3.0",
+ "@vscode/emmet-helper": "^2.9.3",
+ "vscode-uri": "^3.0.8"
+ },
+ "peerDependencies": {
+ "@volar/language-service": "~2.4.0"
+ },
+ "peerDependenciesMeta": {
+ "@volar/language-service": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/volar-service-html": {
+ "version": "0.0.71",
+ "resolved": "https://registry.npmjs.org/volar-service-html/-/volar-service-html-0.0.71.tgz",
+ "integrity": "sha512-e8tHPhgQ7ooLfudAEIku+kgd9pWkq3SSz8RbnQDI1+Eb8wbenkLGHqoirLqz5ORLV6wIMr2Iv08RWBG5eOcgpw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "vscode-html-languageservice": "^5.3.0",
+ "vscode-languageserver-textdocument": "^1.0.11",
+ "vscode-uri": "^3.0.8"
+ },
+ "peerDependencies": {
+ "@volar/language-service": "~2.4.0"
+ },
+ "peerDependenciesMeta": {
+ "@volar/language-service": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/volar-service-prettier": {
+ "version": "0.0.71",
+ "resolved": "https://registry.npmjs.org/volar-service-prettier/-/volar-service-prettier-0.0.71.tgz",
+ "integrity": "sha512-Rz7JVH3qD108UCdmIEiZvOBNljMt2nLFdbN8AXcDfn7xD9F5I2aCIsDVqBbXw21PsnxG0b7MfwtNF+zPS/NKUg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "vscode-uri": "^3.0.8"
+ },
+ "peerDependencies": {
+ "@volar/language-service": "~2.4.0",
+ "prettier": "^2.2 || ^3.0"
+ },
+ "peerDependenciesMeta": {
+ "@volar/language-service": {
+ "optional": true
+ },
+ "prettier": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/volar-service-typescript": {
+ "version": "0.0.71",
+ "resolved": "https://registry.npmjs.org/volar-service-typescript/-/volar-service-typescript-0.0.71.tgz",
+ "integrity": "sha512-yTtM/BVT6hoyEYnDtaCyAtNhdNeS/mhTTABlBOdw3NNiRBUin3IznFJpgfjer4c6RYopiPjjQjc9VFhxVl1mLw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "path-browserify": "^1.0.1",
+ "semver": "^7.6.2",
+ "typescript-auto-import-cache": "^0.3.5",
+ "vscode-languageserver-textdocument": "^1.0.11",
+ "vscode-nls": "^5.2.0",
+ "vscode-uri": "^3.0.8"
+ },
+ "peerDependencies": {
+ "@volar/language-service": "~2.4.0"
+ },
+ "peerDependenciesMeta": {
+ "@volar/language-service": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/volar-service-typescript-twoslash-queries": {
+ "version": "0.0.71",
+ "resolved": "https://registry.npmjs.org/volar-service-typescript-twoslash-queries/-/volar-service-typescript-twoslash-queries-0.0.71.tgz",
+ "integrity": "sha512-9K2k72s4n7rV9s4bX0MyjbX9iBribvKZbBJKuEmTCZfeWJXs6Yh7bGpY4eoc7UufAjvpheBqwyZCOIPBvxCv0A==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "vscode-uri": "^3.0.8"
+ },
+ "peerDependencies": {
+ "@volar/language-service": "~2.4.0"
+ },
+ "peerDependenciesMeta": {
+ "@volar/language-service": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/volar-service-yaml": {
+ "version": "0.0.71",
+ "resolved": "https://registry.npmjs.org/volar-service-yaml/-/volar-service-yaml-0.0.71.tgz",
+ "integrity": "sha512-qYGWGuVpUTnZGu5P/CR4KLK4aIR8RrcVnmfZ2eRcj9q/I8VZCoC5yy9FtEvfNvnDp4MU17yhdJcvpQPIqhJS2Q==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "vscode-uri": "^3.0.8",
+ "yaml-language-server": "~1.23.0"
+ },
+ "peerDependencies": {
+ "@volar/language-service": "~2.4.0"
+ },
+ "peerDependenciesMeta": {
+ "@volar/language-service": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/vscode-css-languageservice": {
+ "version": "6.3.10",
+ "resolved": "https://registry.npmjs.org/vscode-css-languageservice/-/vscode-css-languageservice-6.3.10.tgz",
+ "integrity": "sha512-eq5N9Er3fC4vA9zd9EFhyBG90wtCCuXgRSpAndaOgXMh1Wgep5lBgRIeDgjZBW9pa+332yC9+49cZMW8jcL3MA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@vscode/l10n": "^0.0.18",
+ "vscode-languageserver-textdocument": "^1.0.12",
+ "vscode-languageserver-types": "3.17.5",
+ "vscode-uri": "^3.1.0"
+ }
+ },
+ "node_modules/vscode-css-languageservice/node_modules/vscode-languageserver-types": {
+ "version": "3.17.5",
+ "resolved": "https://registry.npmjs.org/vscode-languageserver-types/-/vscode-languageserver-types-3.17.5.tgz",
+ "integrity": "sha512-Ld1VelNuX9pdF39h2Hgaeb5hEZM2Z3jUrrMgWQAu82jMtZp7p3vJT3BzToKtZI7NgQssZje5o0zryOrhQvzQAg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/vscode-html-languageservice": {
+ "version": "5.6.2",
+ "resolved": "https://registry.npmjs.org/vscode-html-languageservice/-/vscode-html-languageservice-5.6.2.tgz",
+ "integrity": "sha512-ulCrSnFnfQ16YzvwnYUgEbUEl/ZG7u2eV27YhvLObSHKkb8fw1Z9cgsnUwjTEeDIdJDoTDTDpxuhQwoenoLNMg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@vscode/l10n": "^0.0.18",
+ "vscode-languageserver-textdocument": "^1.0.12",
+ "vscode-languageserver-types": "^3.17.5",
+ "vscode-uri": "^3.1.0"
+ }
+ },
+ "node_modules/vscode-json-languageservice": {
+ "version": "4.1.8",
+ "resolved": "https://registry.npmjs.org/vscode-json-languageservice/-/vscode-json-languageservice-4.1.8.tgz",
+ "integrity": "sha512-0vSpg6Xd9hfV+eZAaYN63xVVMOTmJ4GgHxXnkLCh+9RsQBkWKIghzLhW2B9ebfG+LQQg8uLtsQ2aUKjTgE+QOg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "jsonc-parser": "^3.0.0",
+ "vscode-languageserver-textdocument": "^1.0.1",
+ "vscode-languageserver-types": "^3.16.0",
+ "vscode-nls": "^5.0.0",
+ "vscode-uri": "^3.0.2"
+ },
+ "engines": {
+ "npm": ">=7.0.0"
+ }
+ },
+ "node_modules/vscode-jsonrpc": {
+ "version": "9.0.1",
+ "resolved": "https://registry.npmjs.org/vscode-jsonrpc/-/vscode-jsonrpc-9.0.1.tgz",
+ "integrity": "sha512-rfuA6T75H6m5EkbhtEPzre9pT0HPcDI2MMy4+nPFIBks5J8JBAUHD4tRYSgaBOijIEC7SRkC1kKyXTLqbmh9jw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=14.0.0"
+ }
+ },
+ "node_modules/vscode-languageserver": {
+ "version": "9.0.1",
+ "resolved": "https://registry.npmjs.org/vscode-languageserver/-/vscode-languageserver-9.0.1.tgz",
+ "integrity": "sha512-woByF3PDpkHFUreUa7Hos7+pUWdeWMXRd26+ZX2A8cFx6v/JPTtd4/uN0/jB6XQHYaOlHbio03NTHCqrgG5n7g==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "vscode-languageserver-protocol": "3.17.5"
+ },
+ "bin": {
+ "installServerIntoExtension": "bin/installServerIntoExtension"
+ }
+ },
+ "node_modules/vscode-languageserver-protocol": {
+ "version": "3.18.2",
+ "resolved": "https://registry.npmjs.org/vscode-languageserver-protocol/-/vscode-languageserver-protocol-3.18.2.tgz",
+ "integrity": "sha512-XRyDbT0Pp3sSNti3JmxVEUMySWCSi1hhM+/KUlCy1hV1zmrqpM1OwO12EAki8blhmLuIMpaJrYbo0OzGVfK2Qg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "vscode-jsonrpc": "9.0.1",
+ "vscode-languageserver-types": "3.18.0"
+ }
+ },
+ "node_modules/vscode-languageserver-textdocument": {
+ "version": "1.0.12",
+ "resolved": "https://registry.npmjs.org/vscode-languageserver-textdocument/-/vscode-languageserver-textdocument-1.0.12.tgz",
+ "integrity": "sha512-cxWNPesCnQCcMPeenjKKsOCKQZ/L6Tv19DTRIGuLWe32lyzWhihGVJ/rcckZXJxfdKCFvRLS3fpBIsV/ZGX4zA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/vscode-languageserver-types": {
+ "version": "3.18.0",
+ "resolved": "https://registry.npmjs.org/vscode-languageserver-types/-/vscode-languageserver-types-3.18.0.tgz",
+ "integrity": "sha512-8TsGPNMIMiiBdkORgRSvLjuiEIiAFtO+KssmYWxQ+uSVvlf7RjK8YKCOjPzZ+YA04jXEV7+7LvkSmHkhpNS99g==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/vscode-languageserver/node_modules/vscode-jsonrpc": {
+ "version": "8.2.0",
+ "resolved": "https://registry.npmjs.org/vscode-jsonrpc/-/vscode-jsonrpc-8.2.0.tgz",
+ "integrity": "sha512-C+r0eKJUIfiDIfwJhria30+TYWPtuHJXHtI7J0YlOmKAo7ogxP20T0zxB7HZQIFhIyvoBPwWskjxrvAtfjyZfA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=14.0.0"
+ }
+ },
+ "node_modules/vscode-languageserver/node_modules/vscode-languageserver-protocol": {
+ "version": "3.17.5",
+ "resolved": "https://registry.npmjs.org/vscode-languageserver-protocol/-/vscode-languageserver-protocol-3.17.5.tgz",
+ "integrity": "sha512-mb1bvRJN8SVznADSGWM9u/b07H7Ecg0I3OgXDuLdn307rl/J3A9YD6/eYOssqhecL27hK1IPZAsaqh00i/Jljg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "vscode-jsonrpc": "8.2.0",
+ "vscode-languageserver-types": "3.17.5"
+ }
+ },
+ "node_modules/vscode-languageserver/node_modules/vscode-languageserver-types": {
+ "version": "3.17.5",
+ "resolved": "https://registry.npmjs.org/vscode-languageserver-types/-/vscode-languageserver-types-3.17.5.tgz",
+ "integrity": "sha512-Ld1VelNuX9pdF39h2Hgaeb5hEZM2Z3jUrrMgWQAu82jMtZp7p3vJT3BzToKtZI7NgQssZje5o0zryOrhQvzQAg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/vscode-nls": {
+ "version": "5.2.0",
+ "resolved": "https://registry.npmjs.org/vscode-nls/-/vscode-nls-5.2.0.tgz",
+ "integrity": "sha512-RAaHx7B14ZU04EU31pT+rKz2/zSl7xMsfIZuo8pd+KZO6PXtQmpevpq3vxvWNcrGbdmhM/rr5Uw5Mz+NBfhVng==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/vscode-uri": {
+ "version": "3.1.0",
+ "resolved": "https://registry.npmjs.org/vscode-uri/-/vscode-uri-3.1.0.tgz",
+ "integrity": "sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/web-namespaces": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/web-namespaces/-/web-namespaces-2.0.1.tgz",
+ "integrity": "sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ },
+ "node_modules/wrap-ansi": {
+ "version": "9.0.2",
+ "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz",
+ "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ansi-styles": "^6.2.1",
+ "string-width": "^7.0.0",
+ "strip-ansi": "^7.1.0"
+ },
+ "engines": {
+ "node": ">=18"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+ }
+ },
+ "node_modules/wrap-ansi/node_modules/ansi-styles": {
+ "version": "6.2.3",
+ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz",
+ "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+ }
+ },
+ "node_modules/wrap-ansi/node_modules/string-width": {
+ "version": "7.2.0",
+ "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",
+ "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "emoji-regex": "^10.3.0",
+ "get-east-asian-width": "^1.0.0",
+ "strip-ansi": "^7.1.0"
+ },
+ "engines": {
+ "node": ">=18"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/xxhash-wasm": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/xxhash-wasm/-/xxhash-wasm-1.1.0.tgz",
+ "integrity": "sha512-147y/6YNh+tlp6nd/2pWq38i9h6mz/EuQ6njIrmW8D1BS5nCqs0P6DG+m6zTGnNz5I+uhZ0SHxBs9BsPrwcKDA==",
+ "license": "MIT"
+ },
+ "node_modules/y18n": {
+ "version": "5.0.8",
+ "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
+ "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
+ "dev": true,
+ "license": "ISC",
+ "engines": {
+ "node": ">=10"
+ }
+ },
+ "node_modules/yaml": {
+ "version": "2.9.0",
+ "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.0.tgz",
+ "integrity": "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==",
+ "devOptional": true,
+ "license": "ISC",
+ "bin": {
+ "yaml": "bin.mjs"
+ },
+ "engines": {
+ "node": ">= 14.6"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/eemeli"
+ }
+ },
+ "node_modules/yaml-language-server": {
+ "version": "1.23.0",
+ "resolved": "https://registry.npmjs.org/yaml-language-server/-/yaml-language-server-1.23.0.tgz",
+ "integrity": "sha512-3qVyCOexLCWw06PQa5kRPwvMWMZ/eZeCRWUvgD6a0OkqL/4iCnxy2WumbWifa937Uo5xhyWJ0uxlU39ljhNh7A==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@vscode/l10n": "^0.0.18",
+ "ajv": "^8.17.1",
+ "ajv-draft-04": "^1.0.0",
+ "ajv-i18n": "^4.2.0",
+ "prettier": "^3.8.1",
+ "request-light": "^0.5.7",
+ "vscode-json-languageservice": "4.1.8",
+ "vscode-languageserver": "^9.0.0",
+ "vscode-languageserver-textdocument": "^1.0.1",
+ "vscode-languageserver-types": "^3.16.0",
+ "vscode-uri": "^3.0.2",
+ "yaml": "2.8.3"
+ },
+ "bin": {
+ "yaml-language-server": "bin/yaml-language-server"
+ }
+ },
+ "node_modules/yaml-language-server/node_modules/request-light": {
+ "version": "0.5.8",
+ "resolved": "https://registry.npmjs.org/request-light/-/request-light-0.5.8.tgz",
+ "integrity": "sha512-3Zjgh+8b5fhRJBQZoy+zbVKpAQGLyka0MPgW3zruTF4dFFJ8Fqcfu9YsAvi/rvdcaTeWG3MkbZv4WKxAn/84Lg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/yaml-language-server/node_modules/yaml": {
+ "version": "2.8.3",
+ "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.8.3.tgz",
+ "integrity": "sha512-AvbaCLOO2Otw/lW5bmh9d/WEdcDFdQp2Z2ZUH3pX9U2ihyUY0nvLv7J6TrWowklRGPYbB/IuIMfYgxaCPg5Bpg==",
+ "dev": true,
+ "license": "ISC",
+ "bin": {
+ "yaml": "bin.mjs"
+ },
+ "engines": {
+ "node": ">= 14.6"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/eemeli"
+ }
+ },
+ "node_modules/yargs": {
+ "version": "18.1.0",
+ "resolved": "https://registry.npmjs.org/yargs/-/yargs-18.1.0.tgz",
+ "integrity": "sha512-2rAgRKu54VsHkqI0/tYkmluGXHD4KW7yZoycuqDQ15QOTnc2VVfy0nN/1eMhnQLO00A+dwtK20xuCnc1YGeUyg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "cliui": "^9.0.1",
+ "escalade": "^3.1.1",
+ "get-caller-file": "^2.0.5",
+ "string-width": "^8.2.1",
+ "y18n": "^5.0.5",
+ "yargs-parser": "^22.0.0"
+ },
+ "engines": {
+ "node": "^20.19.0 || ^22.12.0 || >=23"
+ }
+ },
+ "node_modules/yargs-parser": {
+ "version": "22.0.0",
+ "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-22.0.0.tgz",
+ "integrity": "sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==",
+ "license": "ISC",
+ "engines": {
+ "node": "^20.19.0 || ^22.12.0 || >=23"
+ }
+ },
+ "node_modules/yocto-queue": {
+ "version": "1.2.2",
+ "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-1.2.2.tgz",
+ "integrity": "sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=12.20"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/zod": {
+ "version": "4.4.3",
+ "resolved": "https://registry.npmjs.org/zod/-/zod-4.4.3.tgz",
+ "integrity": "sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ==",
+ "license": "MIT",
+ "funding": {
+ "url": "https://github.com/sponsors/colinhacks"
+ }
+ },
+ "node_modules/zwitch": {
+ "version": "2.0.4",
+ "resolved": "https://registry.npmjs.org/zwitch/-/zwitch-2.0.4.tgz",
+ "integrity": "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==",
+ "license": "MIT",
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/wooorm"
+ }
+ }
+ }
+}
diff --git a/docs/package.json b/docs/package.json
new file mode 100644
index 000000000..8dcf74bf0
--- /dev/null
+++ b/docs/package.json
@@ -0,0 +1,26 @@
+{
+ "name": "worktrunk-docs",
+ "private": true,
+ "type": "module",
+ "scripts": {
+ "build": "astro build --force",
+ "check": "astro check",
+ "dev": "astro dev",
+ "parity": "node scripts/parity.mjs",
+ "preview": "astro preview",
+ "test": "node --test tests/plugins.test.mjs",
+ "test:site": "node --test tests/built-site.test.mjs"
+ },
+ "dependencies": {
+ "@astrojs/markdown-remark": "^7.2.4",
+ "@astrojs/sitemap": "^3.7.3",
+ "@astrojs/starlight": "^0.41.7",
+ "@expressive-code/core": "^0.44.1",
+ "astro": "^7.2.4"
+ },
+ "devDependencies": {
+ "@astrojs/check": "^0.9.10",
+ "playwright": "^1.62.1",
+ "typescript": "^6.0.3"
+ }
+}
diff --git a/docs/static/.well-known/agent-skills/index.json b/docs/public/.well-known/agent-skills/index.json
similarity index 100%
rename from docs/static/.well-known/agent-skills/index.json
rename to docs/public/.well-known/agent-skills/index.json
diff --git a/docs/static/.well-known/agent-skills/worktrunk b/docs/public/.well-known/agent-skills/worktrunk
similarity index 100%
rename from docs/static/.well-known/agent-skills/worktrunk
rename to docs/public/.well-known/agent-skills/worktrunk
diff --git a/docs/static/apple-touch-icon.png b/docs/public/apple-touch-icon.png
similarity index 100%
rename from docs/static/apple-touch-icon.png
rename to docs/public/apple-touch-icon.png
diff --git a/docs/static/claude-code.md b/docs/public/claude-code.md
similarity index 100%
rename from docs/static/claude-code.md
rename to docs/public/claude-code.md
diff --git a/docs/static/code-signing.md b/docs/public/code-signing.md
similarity index 100%
rename from docs/static/code-signing.md
rename to docs/public/code-signing.md
diff --git a/docs/static/config.md b/docs/public/config.md
similarity index 100%
rename from docs/static/config.md
rename to docs/public/config.md
diff --git a/docs/static/demos/twitter/thread-preview.html b/docs/public/demos/twitter/thread-preview.html
similarity index 100%
rename from docs/static/demos/twitter/thread-preview.html
rename to docs/public/demos/twitter/thread-preview.html
diff --git a/docs/static/demos/twitter/thread.md b/docs/public/demos/twitter/thread.md
similarity index 100%
rename from docs/static/demos/twitter/thread.md
rename to docs/public/demos/twitter/thread.md
diff --git a/docs/static/extending.md b/docs/public/extending.md
similarity index 100%
rename from docs/static/extending.md
rename to docs/public/extending.md
diff --git a/docs/static/faq.md b/docs/public/faq.md
similarity index 100%
rename from docs/static/faq.md
rename to docs/public/faq.md
diff --git a/docs/static/favicon-48.png b/docs/public/favicon-48.png
similarity index 100%
rename from docs/static/favicon-48.png
rename to docs/public/favicon-48.png
diff --git a/docs/static/favicon.png b/docs/public/favicon.png
similarity index 100%
rename from docs/static/favicon.png
rename to docs/public/favicon.png
diff --git a/docs/static/github-social-card.svg b/docs/public/github-social-card.svg
similarity index 100%
rename from docs/static/github-social-card.svg
rename to docs/public/github-social-card.svg
diff --git a/docs/static/hook.md b/docs/public/hook.md
similarity index 100%
rename from docs/static/hook.md
rename to docs/public/hook.md
diff --git a/docs/static/list.md b/docs/public/list.md
similarity index 100%
rename from docs/static/list.md
rename to docs/public/list.md
diff --git a/docs/static/llm-commits.md b/docs/public/llm-commits.md
similarity index 100%
rename from docs/static/llm-commits.md
rename to docs/public/llm-commits.md
diff --git a/docs/static/llms.txt b/docs/public/llms.txt
similarity index 96%
rename from docs/static/llms.txt
rename to docs/public/llms.txt
index c561d1852..db7c3bb4c 100644
--- a/docs/static/llms.txt
+++ b/docs/public/llms.txt
@@ -2,8 +2,8 @@
> CLI for Git worktree management, designed for parallel AI agent workflows.
-Worktrunk is a CLI for git worktree management, designed for running AI agents
-in parallel.
+Worktrunk is a CLI for Git worktree management, designed for **parallel AI agent
+workflows**.
Worktrunk's three core commands make worktrees as easy as branches.
Plus, Worktrunk has a bunch of quality-of-life features to simplify working
diff --git a/docs/static/logo.png b/docs/public/logo.png
similarity index 100%
rename from docs/static/logo.png
rename to docs/public/logo.png
diff --git a/docs/static/[email protected] b/docs/public/[email protected]
similarity index 100%
rename from docs/static/[email protected]
rename to docs/public/[email protected]
diff --git a/docs/static/merge.md b/docs/public/merge.md
similarity index 100%
rename from docs/static/merge.md
rename to docs/public/merge.md
diff --git a/docs/static/remove.md b/docs/public/remove.md
similarity index 100%
rename from docs/static/remove.md
rename to docs/public/remove.md
diff --git a/docs/static/robots.txt b/docs/public/robots.txt
similarity index 100%
rename from docs/static/robots.txt
rename to docs/public/robots.txt
diff --git a/docs/static/schema/list-v2.json b/docs/public/schema/list-v2.json
similarity index 100%
rename from docs/static/schema/list-v2.json
rename to docs/public/schema/list-v2.json
diff --git a/docs/static/social-card.svg b/docs/public/social-card.svg
similarity index 100%
rename from docs/static/social-card.svg
rename to docs/public/social-card.svg
diff --git a/docs/static/step.md b/docs/public/step.md
similarity index 100%
rename from docs/static/step.md
rename to docs/public/step.md
diff --git a/docs/static/switch.md b/docs/public/switch.md
similarity index 100%
rename from docs/static/switch.md
rename to docs/public/switch.md
diff --git a/docs/static/tips-patterns.md b/docs/public/tips-patterns.md
similarity index 100%
rename from docs/static/tips-patterns.md
rename to docs/public/tips-patterns.md
diff --git a/docs/static/worktrunk.md b/docs/public/worktrunk.md
similarity index 100%
rename from docs/static/worktrunk.md
rename to docs/public/worktrunk.md
diff --git a/docs/sass/custom.scss b/docs/sass/custom.scss
deleted file mode 100644
index d923a0e3d..000000000
--- a/docs/sass/custom.scss
+++ /dev/null
@@ -1,1511 +0,0 @@
-// Warm Workbench Theme for Worktrunk Docs
-// A clean workbench in a sunlit garage: warm paper, neatly labeled trays
-
-// ============================================================================
-// Base
-// ============================================================================
-
-html {
- // Reserve scrollbar space to prevent layout shift when navigating
- // Browser support: Safari 17+, Chrome 94+, Firefox 97+. Graceful degradation.
- scrollbar-gutter: stable;
-}
-
-body {
- padding: 0;
- margin: 0;
- box-sizing: border-box;
- display: flex;
- flex-direction: column;
- // iOS viewport jank fix: --vh-full is set by JS in base.html for iOS browsers.
- // Fallback to 100lvh for other browsers. See base.html for full explanation.
- min-height: var(--vh-full, 100lvh);
- font-family: var(--wt-font-sans);
- font-size: 15px;
- line-height: 1.5;
- color: var(--wt-color-text);
- background-color: var(--wt-color-bg);
-}
-
-a {
- text-decoration: none;
-}
-
-// ============================================================================
-// Utility Classes
-// ============================================================================
-
-.text-center {
- text-align: center;
-}
-
-// ============================================================================
-// Typography
-// ============================================================================
-
-// Shared heading underline effect (H1/H2)
-// Turns gold on hover, otherwise subtle craft brown
-%heading-underline {
- &::after {
- content: "";
- position: absolute;
- left: 0;
- bottom: -0.3rem;
- width: 45%;
- height: 2px;
- background: var(--wt-color-craft-brown);
- opacity: 0.5;
- border-radius: 1px;
- transition: background 150ms ease-out, opacity 150ms ease-out;
- }
-
- &:hover::after {
- background: var(--wt-color-accent);
- opacity: 1;
- }
-}
-
-// Headings
-h1, h2, h3, h4, h5, h6 {
- font-family: var(--wt-font-head);
- color: var(--wt-color-text);
- // Account for sticky header when scrolling to anchors
- scroll-margin-top: calc(var(--wt-header-height) + var(--wt-main-padding-top));
-}
-
-h1 {
- font-size: 1.5rem;
- font-weight: 650;
- letter-spacing: -0.02em;
- margin-top: 2rem;
- margin-bottom: 0.5rem;
- position: relative;
- width: fit-content; // Block-level but sized to content (for underline effect)
-
- > a {
- @extend %heading-underline;
- }
-}
-
-h2 {
- font-size: 1.4rem;
- font-weight: 600;
- letter-spacing: -0.02em;
- margin-top: 1.6rem;
- margin-bottom: 0.4rem;
- position: relative;
- display: inline-block;
-
- > a {
- @extend %heading-underline;
- }
-}
-
-h3 {
- font-size: 1.15rem;
- font-weight: 550;
- margin-top: 1.2rem;
- margin-bottom: 0.3rem;
- color: var(--wt-color-text-muted);
-}
-
-h4 {
- font-size: 1rem;
- font-weight: 550;
- margin-top: 1rem;
- margin-bottom: 0.25rem;
-}
-
-// Heading anchor links - entire heading is clickable
-// .heading-anchor = custom anchors in templates, .zola-anchor = Zola-generated
-h1 > a.heading-anchor,
-h1 > a.zola-anchor,
-h2 > a.zola-anchor,
-h3 > a.zola-anchor,
-h4 > a.zola-anchor {
- color: inherit;
- text-decoration: none;
-
- &:hover {
- text-decoration: none;
- }
-}
-
-// h3/h4 hover: color shift to accent (h1/h2 have underline intensify via ::after)
-h3 > a.zola-anchor,
-h4 > a.zola-anchor {
- transition: color 150ms ease-out;
-
- &:hover {
- color: var(--wt-color-accent);
- }
-}
-
-// Page title heading (used on content pages and hero)
-// These are standalone titles, not section headers, so no underline
-.heading-text {
- font-family: var(--wt-font-head);
- font-size: 1.75rem;
- font-weight: 650;
- letter-spacing: -0.02em;
- margin-top: 0;
- margin-bottom: 0.5rem;
- color: var(--wt-color-text);
- width: auto; // Override h1's fit-content to allow centering
-
- // Disable the h1 > a underline for page titles
- > a::after {
- display: none;
- }
-}
-
-// ============================================================================
-// Header & Bench Rail
-// ============================================================================
-
-header {
- // Height includes safe-area-inset so content isn't compressed on notched devices
- height: calc(var(--wt-header-height) + env(safe-area-inset-top, 0px));
- box-sizing: border-box;
- background-color: var(--wt-color-bg-soft);
- border-bottom: 1px solid var(--wt-color-border-subtle);
- padding: 0 50px;
- // iOS safe area: push content below notch/Dynamic Island
- padding-top: env(safe-area-inset-top, 0px);
- position: sticky;
- top: 0;
- // Z-index hierarchy: overlay(199) < scrim(200) = menu(200) < header(201)
- // Header on top so toggle button remains clickable when menu is open
- z-index: 201;
- display: flex;
- align-items: center;
- justify-content: space-between;
-}
-
-// iOS 26 Liquid Glass fix: solid scrim behind translucent browser chrome
-// Safari's translucent URL bar samples underlying content - this ensures it
-// samples a stable solid color (header background) instead of scrolling content.
-// Hidden on non-iOS to avoid unnecessary DOM/paint cost.
-.ios-chrome-scrim {
- display: none;
-}
-
-@supports (-webkit-touch-callout: none) {
- .ios-chrome-scrim {
- display: block;
- position: fixed;
- top: 0;
- left: 0;
- right: 0;
- // Cover safe area inset plus header height so the browser chrome
- // always samples this solid color, not scrolling content beneath
- height: calc(env(safe-area-inset-top, 0px) + var(--wt-header-height));
- background: var(--wt-color-bg-soft);
- // Below header (201) so header remains interactive
- z-index: 200;
- pointer-events: none;
- }
-}
-
-.logo {
- display: flex;
- align-items: center;
- gap: 0.35rem;
- font-family: var(--wt-font-sans);
- font-weight: 600;
- font-size: 1.25rem;
- color: var(--wt-color-text);
-
- img {
- width: 44px;
- height: 44px;
- object-fit: contain;
- }
-}
-
-// Navigation
-nav {
- display: flex;
- align-items: center;
- gap: 0;
-}
-
-// Navigation links
-.nav-item {
- font-size: 0.85rem;
- font-weight: 500;
- color: var(--wt-color-text-muted);
- padding: 0.2rem 0.4rem;
- border-radius: var(--wt-radius-pill);
- transition: color 150ms, background 150ms;
-
- &:hover {
- color: var(--wt-color-text);
- background: var(--wt-color-bg-soft);
- }
-}
-
-// ============================================================================
-// Search - Dropdown style (elasticlunr)
-// ============================================================================
-
-.search-container {
- position: relative;
- margin-right: 1rem;
-
- // Keep input expanded while anything in container has focus (including
- // clicking a search result link). Prevents jarring shrink during navigation.
- &:focus-within #userinput {
- width: 240px;
- border-color: var(--wt-color-accent);
- }
-
- // Freeze search container during view transitions to prevent layout shift.
- // Without this, focus loss during transition causes input to shrink.
- // Progressive enhancement: View Transitions API (Chrome 111+, Safari 18+)
- &:focus-within {
- view-transition-name: search-frozen;
- }
-}
-
-#userinput {
- width: 180px;
- padding: 0.4rem 0.75rem;
- font-size: 0.9rem;
- font-family: var(--wt-font-sans);
- color: var(--wt-color-text);
- background: var(--wt-color-bg);
- border: 1px solid var(--wt-color-border-subtle);
- border-radius: var(--wt-radius-md);
- transition: width 150ms, border-color 150ms;
-
- &::placeholder {
- color: var(--wt-color-text-soft);
- }
-}
-
-#suggestions {
- display: none;
- position: absolute;
- top: calc(100% + 0.5rem);
- left: 0;
- width: 400px;
- max-height: 70vh;
- overflow-y: auto;
- background: var(--wt-color-bg-elevated);
- border: 1px solid var(--wt-color-border-subtle);
- border-radius: var(--wt-radius-md);
- box-shadow: 0 8px 30px var(--wt-shadow-medium);
- z-index: 1000;
-}
-
-.search-result {
- display: flex;
- flex-direction: column;
- padding: 0.75rem 1rem;
- border-bottom: 1px solid var(--wt-color-border-subtle);
- text-decoration: none;
- transition: background 150ms;
-
- &:last-child {
- border-bottom: none;
- }
-
- &:hover, &:focus {
- background: var(--wt-color-bg-soft);
- outline: none;
- }
-}
-
-.search-title {
- font-weight: 600;
- color: var(--wt-color-text);
- margin-bottom: 0.25rem;
-}
-
-.search-excerpt {
- font-size: 0.85rem;
- color: var(--wt-color-text-muted);
- line-height: 1.4;
-
- b {
- color: var(--wt-color-text);
- font-weight: 600;
- }
-}
-
-// ============================================================================
-// Main Content Area
-// ============================================================================
-
-main {
- display: flex;
- flex-grow: 1;
- background-color: var(--wt-color-bg);
- padding: var(--wt-main-padding-top) 80px;
- gap: 2.5rem;
-}
-
-.content {
- display: block;
- box-sizing: border-box;
- width: 100%;
- max-width: 922px;
- min-width: 0;
- overflow-x: auto;
- padding: 1.5rem 30px;
- background-color: var(--wt-color-bg-elevated);
- border-radius: var(--wt-radius-lg);
- border: 1px solid var(--wt-color-border-subtle);
- box-shadow: 0 1px 3px var(--wt-shadow-soft);
- // Account for sticky header when scrolling to page anchor (e.g., /#worktrunk)
- scroll-margin-top: calc(var(--wt-header-height) + var(--wt-main-padding-top));
-}
-
-// Paragraphs
-.content p {
- margin-bottom: 0.75rem;
-}
-
-// Images - horizontally scrollable, never shrink
-.content p:has(> img) {
- overflow-x: auto;
- -webkit-overflow-scrolling: touch;
-}
-
-.content img {
- display: block;
- max-width: 100%;
- height: auto; // Maintain aspect ratio when width/height attrs set for CLS prevention
- box-sizing: border-box;
- border: 1px solid var(--wt-color-code-border);
- border-left: 3px solid var(--wt-color-accent);
- border-radius: 0 var(--wt-radius-md) var(--wt-radius-md) 0;
- box-shadow: 0 2px 8px var(--wt-shadow-soft), 0 1px 2px var(--wt-shadow-medium);
-}
-
-// Demo GIFs - shrink to min-width, then horizontal scroll
-.content figure.demo {
- margin-top: 0.25rem;
-
- picture {
- display: block;
- overflow-x: auto;
- -webkit-overflow-scrolling: touch;
- }
-
- img {
- display: block;
- min-width: 800px;
- max-width: 100%;
- height: auto;
- // Hide until loaded (JS adds .loaded class) - visibility preserves GIF animation state
- visibility: hidden;
-
- &.loaded {
- visibility: visible;
- }
- }
-}
-
-// Tighten spacing between paragraphs and code blocks
-.content p + pre,
-.content p + .terminal,
-.content pre + p,
-.content .terminal + p {
- margin-top: 0.5rem;
-}
-
-// Links
-.content a {
- color: var(--wt-color-link);
- text-decoration: underline;
- text-decoration-thickness: 1px;
- text-underline-offset: 2px;
-}
-
-// ============================================================================
-// Inline Code
-// ============================================================================
-
-.content code {
- padding: 0.1rem 0.3rem;
- color: var(--wt-color-code-inline-text);
- font-family: var(--wt-font-mono);
- font-size: 0.92rem;
- font-weight: 400;
-}
-
-// Remove padding from code inside links so underline animation matches text width
-.content a code {
- padding: 0;
-}
-
-// ============================================================================
-// Code Blocks - Distinctive card style with left accent
-// ============================================================================
-
-// Override syntect's background to use our theme colors
-.z-code {
- background-color: transparent;
-}
-
-// Quoted strings get olive color via CSS sibling selector (light mode only).
-// Giallo emits: <span class="z-punctuation z-definition z-string">'</span><span class="z-string">content</span>
-// Bare strings (subcommands like `switch`) are just <span class="z-string"> without a preceding quote span.
-// Must match punctuation.definition.string in worktrunk-light.json (#588a10).
-@media (prefers-color-scheme: light) {
- .z-punctuation.z-definition.z-string + .z-string {
- color: #588a10;
- }
-}
-
-// Shared styles for code blocks and terminal output
-%code-block-base {
- position: relative;
- background-color: var(--wt-color-code-bg);
- border: 1px solid var(--wt-color-code-border);
- border-left: 3px solid var(--wt-color-accent);
- border-radius: 0 var(--wt-radius-md) var(--wt-radius-md) 0;
- padding: 0.875rem 1rem;
- overflow-x: auto;
- margin: 1.25rem 0;
- box-shadow: 0 2px 8px var(--wt-shadow-soft), 0 1px 2px var(--wt-shadow-medium);
- transition: box-shadow 50ms;
-
- &:hover {
- box-shadow: 0 0 0 1px var(--wt-color-accent-soft),
- 0 4px 16px var(--wt-shadow-accent),
- 0 2px 8px var(--wt-shadow-medium);
- }
-
- code {
- background-color: transparent;
- padding: 0;
- font-family: var(--wt-font-mono);
- font-size: 0.875rem;
- line-height: 1.6;
- // Note: color is NOT set here to allow syntax highlighting themes to apply
- }
-}
-
-.content pre {
- @extend %code-block-base;
-
- // Override .content code color to allow syntax highlighting
- code {
- color: inherit;
- }
-}
-
-// Wrapper for code blocks - enables fixed copy button during horizontal scroll
-.code-block-wrapper {
- position: relative;
-}
-
-// Copy button for code blocks
-// Positioned on the wrapper (not the pre) so it stays fixed when code scrolls horizontally
-.code-copy-btn {
- position: absolute;
- top: 0.5rem;
- right: 0.5rem;
- padding: 0.4rem;
- background: var(--wt-color-bg-soft);
- border: 1px solid var(--wt-color-border-subtle);
- border-radius: var(--wt-radius-sm);
- cursor: pointer;
- color: var(--wt-color-text-muted);
- opacity: 0;
- transition: opacity 150ms, background 150ms, color 150ms;
- line-height: 0;
- z-index: 1;
-
- &:hover {
- background: var(--wt-color-bg);
- color: var(--wt-color-text);
- }
-
- &.copied {
- color: var(--wt-color-accent);
- }
-}
-
-.code-block-wrapper:hover .code-copy-btn {
- opacity: 1;
-}
-
-// Terminal output styling (ANSI colors)
-.terminal {
- @extend %code-block-base;
- font-family: var(--wt-font-mono);
- font-size: 0.875rem;
- line-height: 1.5;
- color: var(--wt-color-text); // Default text color for terminal (not syntax-highlighted)
-
- // Command text with $ prompt (generated via ::before, making it non-copyable)
- // When giallo spans are present, their colors take precedence over the base color
- .cmd {
- color: var(--wt-color-accent);
-
- &::before {
- content: "$ ";
- color: var(--wt-color-text-soft);
- }
- }
-
- // Softer bold for table headers and branch names
- b {
- font-weight: 550;
- }
-
- // ANSI color classes for terminal output
- .d { opacity: 0.67; }
- .g { color: var(--green, #0a0); }
- .r { color: var(--red, #a00); }
- .c { color: var(--cyan, #0aa); }
- .y { color: var(--yellow, #a60); }
- .b { color: var(--blue, #00a); }
-
- // Gutter spans - extend vertically to form continuous line
- span[style*="background:var(--bright-white"] {
- display: inline-block;
- margin: -0.25em 0;
- padding: 0.25em 0;
- }
-}
-
-// Command-only terminals (recipe lists with no fixed-width output) wrap long
-// pipelines at spaces instead of scrolling them out of view; a single
-// unbreakable token still falls back to the inherited horizontal scroll.
-// Fixed-width output (tables, ASCII art) keeps the default no-wrap.
-.terminal--commands code {
- white-space: pre-wrap;
-}
-
-// ============================================================================
-// Blockquotes / Callouts
-// ============================================================================
-
-.content blockquote {
- border-radius: var(--wt-radius-md);
- padding: 0.75rem 1rem;
- border: 1px solid var(--wt-color-border-subtle);
- border-left: 3px solid var(--wt-color-accent);
- position: relative;
- background: var(--wt-color-bg-elevated);
- margin: 1rem 0;
-
- p {
- margin: 0;
- }
-}
-
-// ============================================================================
-// Tables - Scrollable like code blocks
-// ============================================================================
-
-// Tables use display: block + overflow-x: auto for horizontal scrolling within
-// the content area. This prevents tables from breaking out of the container.
-// border-collapse: separate + overflow: clip on inner tbody handles border-radius.
-.content table {
- display: block;
- overflow-x: auto;
- width: fit-content;
- max-width: 100%;
- border-collapse: separate;
- border-spacing: 0;
- margin: 1rem 0;
- border-radius: var(--wt-radius-md);
- border: 1px solid var(--wt-color-border-subtle);
-
- th, td {
- border: 1px solid var(--wt-color-border-subtle);
- border-top: none;
- border-left: none;
- padding: 0.6rem 0.875rem;
- text-align: left;
- vertical-align: top;
- }
-
- // Remove right border on last column (table border handles it)
- th:last-child, td:last-child {
- border-right: none;
- }
-
- // Remove bottom border on last row (table border handles it)
- tr:last-child td {
- border-bottom: none;
- }
-
- th {
- background-color: var(--wt-color-bg-soft);
- font-size: 0.8rem;
- font-weight: 600;
- color: var(--wt-color-text-muted);
- text-transform: uppercase;
- letter-spacing: 0.03em;
- }
-
- td {
- font-size: 0.9rem;
- }
-
- // Prevent inline code from wrapping (paths, commands)
- td code {
- white-space: nowrap;
- }
-
- // But allow multiline code blocks in tables to wrap
- td pre code {
- white-space: pre;
- }
-
- // Plain multiline code without block styling
- td code.multiline {
- white-space: pre;
- display: block;
- }
-
- td:first-child {
- font-weight: 550;
- color: var(--wt-color-text);
- }
-}
-
-// ============================================================================
-// TOC / Sidebar
-// ============================================================================
-
-.toc {
- width: 220px;
- flex-shrink: 0;
-}
-
-.toc-sticky {
- position: sticky;
- top: calc(var(--wt-header-height) + var(--wt-main-padding-top));
- box-sizing: border-box;
- border-radius: var(--wt-radius-md);
- background-color: var(--wt-color-bg-elevated);
- border: 1px solid var(--wt-color-border-subtle);
- border-top: 3px solid var(--wt-color-accent);
- padding: 0.75rem 0 1rem;
- // iOS jank fix: --vh-full set by JS, fallback to lvh. See base.html.
- max-height: calc(var(--vh-full, 100lvh) - var(--wt-header-height) - var(--wt-main-padding-top) - 20px);
- overflow-y: auto;
- overscroll-behavior: contain;
-}
-
-.toc-group-label {
- font-size: 0.7rem;
- font-weight: 600;
- text-transform: uppercase;
- letter-spacing: 0.05em;
- color: var(--wt-color-text-soft);
- padding: 0.6rem 0.45rem 0.2rem;
- margin: 0.5rem 0.4rem 0;
-
- &:first-child {
- margin-top: 0;
- }
-}
-
-.toc-item {
- padding: 0;
- margin: 0 0.4rem;
-
- a {
- display: block;
- padding: 0.55rem 0.5rem;
- border-radius: var(--wt-radius-sm);
- font-size: 0.8rem;
- color: var(--wt-color-text-muted);
- transition: color 150ms, background 150ms;
-
- &:hover {
- background: var(--wt-color-bg-soft);
- color: var(--wt-color-text);
- }
-
- &.active {
- border-left: 3px solid var(--wt-color-accent);
- background: var(--wt-color-accent-soft);
- color: var(--wt-color-text);
- padding-left: calc(0.5rem - 3px);
- }
- }
-}
-
-.toc-item-child {
- padding: 0;
- margin: 0 0.4rem;
-
- a {
- font-size: 0.75rem;
- color: var(--wt-color-text-soft);
- padding: 0.2rem 0.8rem 0.2rem 1.35rem;
- border-radius: var(--wt-radius-sm);
- display: block;
- transition: color 150ms, background 150ms;
-
- &:hover {
- color: var(--wt-color-text-muted);
- background: var(--wt-color-bg-soft);
- }
- }
-
- &.nested {
- a {
- font-size: 0.7rem;
- padding-left: 1.95rem;
- }
- }
-
- // H1 entries in TOC - section markers
- // Distinguished by size, weight, and spacing from H2 items
- &.toc-h1 {
- margin-top: 0.5rem;
-
- a {
- font-size: 0.8rem;
- font-weight: 600;
- color: var(--wt-color-text-muted);
-
- &:hover {
- color: var(--wt-color-text);
- background: var(--wt-color-bg-soft);
- }
- }
- }
-
- // H2s under H1s - same alignment as standalone H2s
- &.toc-h2-under-h1 {
- // No extra indent - aligns with standalone H2s
- }
-}
-
-// ============================================================================
-// Page Navigation
-// ============================================================================
-
-.page-nav {
- display: flex;
- justify-content: space-between;
- margin-top: 3rem;
- padding-top: 1.5rem;
- border-top: 1px solid var(--wt-color-border-subtle);
-
- a {
- color: var(--wt-color-accent);
- font-weight: 500;
- padding: 0.5rem 1rem;
- border-radius: var(--wt-radius-md);
- transition: color 150ms, background 150ms;
-
- &:hover {
- background: var(--wt-color-accent-soft);
- }
- }
-}
-
-// ============================================================================
-// Footer
-// ============================================================================
-
-footer {
- padding: 1.5rem 0;
- border-top: 1px solid var(--wt-color-border-subtle);
- display: flex;
- justify-content: center;
- background-color: var(--wt-color-bg-soft);
-}
-
-.footer-social {
- display: flex;
- gap: 0.75rem;
-
- a {
- display: flex;
- align-items: center;
- justify-content: center;
- width: 40px;
- height: 40px;
- border-radius: 50%;
- color: var(--wt-color-text-muted);
- background: var(--wt-color-bg);
- border: 1px solid var(--wt-color-border-subtle);
- transition: color 150ms, border-color 150ms, background 150ms;
-
- &:hover,
- &:focus-visible {
- color: var(--wt-color-text);
- border-color: var(--wt-color-accent);
- background: var(--wt-color-accent-soft);
- }
-
- svg {
- flex-shrink: 0;
- }
- }
-}
-
-// ============================================================================
-// Hero Section
-// ============================================================================
-
-.hero {
- // Warm gradient background with subtle radial glow
- background: radial-gradient(ellipse 80% 60% at 70% 40%, rgba(254, 243, 199, 0.7) 0%, transparent 60%),
- radial-gradient(ellipse 50% 40% at 30% 70%, rgba(251, 243, 219, 0.5) 0%, transparent 50%),
- var(--wt-color-bg-soft);
- // iOS jank fix: --vh-full set by JS, fallback to lvh. See base.html.
- height: calc(var(--vh-full, 100lvh) - var(--wt-header-height) - env(safe-area-inset-top, 0px));
- max-height: calc(var(--vh-full, 100lvh) - var(--wt-header-height) - env(safe-area-inset-top, 0px));
- padding: 4rem 40px 3rem;
- position: relative;
- display: flex;
- align-items: center;
- justify-content: space-evenly;
- overflow: hidden;
- box-sizing: border-box;
-
- // Ensure flex children respect container bounds
- > * {
- flex-shrink: 1;
- min-height: 0;
- }
-
- .hero-image {
- // iOS jank fix: --vh-full set by JS, fallback to lvh. See base.html.
- max-height: calc(var(--vh-full, 100lvh) * 0.55);
- width: auto;
- aspect-ratio: 1;
- object-fit: contain;
- flex-shrink: 1;
- // Subtle glow behind the logo
- filter: drop-shadow(0 8px 24px rgba(217, 119, 6, 0.15));
- transition: filter 300ms, transform 300ms;
-
- &:hover {
- filter: drop-shadow(0 12px 32px rgba(217, 119, 6, 0.25));
- transform: scale(1.02);
- }
- }
-
- // Collapse when empty (subpages don't have hero content)
- &:not(:has(*)) {
- display: none;
- }
-
- .heading-text {
- font-size: 2.5rem;
- font-weight: 650;
- letter-spacing: -0.02em;
- color: var(--wt-color-text);
- }
-
- .title-text {
- font-size: 1.25rem;
- font-weight: 400;
- color: var(--wt-color-text-muted);
- max-width: 35ch;
- }
-
- .explore-more {
- position: absolute;
- bottom: 3.5rem;
- left: 50%;
- transform: translateX(-50%);
- color: var(--wt-color-text-muted);
- cursor: pointer;
- transition: color 150ms;
- animation: float 3s ease-in-out infinite;
-
- &:hover {
- color: var(--wt-color-text);
- animation-play-state: paused;
- }
- }
-}
-
-@keyframes float {
- 0%, 100% { transform: translateX(-50%) translateY(0); }
- 50% { transform: translateX(-50%) translateY(-6px); }
-}
-
-// Dark mode hero adjustments
-@media (prefers-color-scheme: dark) {
- .hero {
- background: radial-gradient(ellipse 80% 60% at 70% 40%, rgba(245, 158, 11, 0.08) 0%, transparent 60%),
- radial-gradient(ellipse 50% 40% at 30% 70%, rgba(139, 115, 85, 0.06) 0%, transparent 50%),
- var(--wt-color-bg-soft);
-
- .hero-image {
- filter: drop-shadow(0 8px 24px rgba(245, 158, 11, 0.2));
-
- &:hover {
- filter: drop-shadow(0 12px 32px rgba(245, 158, 11, 0.3));
- }
- }
- }
-}
-
-// Primary button
-.button {
- display: inline-block;
- background: var(--wt-color-accent);
- color: white;
- padding: 0.6rem 1.5rem;
- border-radius: var(--wt-radius-pill);
- font-weight: 600;
- font-size: 1rem;
- border: none;
- cursor: pointer;
- transition: background 150ms, box-shadow 150ms;
- box-shadow: 0 2px 4px var(--wt-shadow-accent);
-
- &:hover {
- background: var(--wt-color-accent-strong);
- box-shadow: 0 4px 12px var(--wt-shadow-accent-strong);
- }
-
- &:active {
- box-shadow: 0 1px 2px var(--wt-shadow-accent);
- }
-}
-
-// Reset button styles for non-button buttons
-button.explore-more {
- background: none;
- border: none;
- font: inherit;
-}
-
-// ============================================================================
-// Lists
-// ============================================================================
-
-ul, ol {
- padding-left: 1.5rem;
- margin-top: 0.5rem;
-}
-
-ul > li, ol > li {
- padding: 0.15rem 0;
- color: var(--wt-color-text);
-}
-
-ul > li::marker {
- color: var(--wt-color-accent);
-}
-
-// ============================================================================
-// Badges — status labels (experimental, deprecated, etc.)
-// ============================================================================
-
-// Experimental badge — empty span, text via ::after so it doesn't affect
-// Zola's heading slug generation or page TOC entries.
-.badge-experimental {
- display: inline-block;
- vertical-align: 0.15em;
- white-space: nowrap;
-
- &::after {
- content: "EXPERIMENTAL";
- font-size: 0.65rem;
- font-weight: 600;
- letter-spacing: 0.04em;
- color: var(--wt-color-text-soft);
- border: 1px solid var(--wt-color-border-subtle);
- border-radius: var(--wt-radius-pill);
- padding: 0.05rem 0.5rem;
- line-height: 1.4;
- }
-}
-
-// Badge after heading — generated on a separate line so Zola's anchor link
-// doesn't wrap it. The badge lands in a <p> (CommonMark wraps inline HTML);
-// collapse that <p> to inline so it flows on the heading's line.
-:is(h1, h2, h3, h4):has(+ p > .badge-experimental:only-child) {
- display: inline-block;
-}
-
-:is(h1, h2, h3, h4) + p:has(> .badge-experimental:only-child) {
- display: inline;
- margin: 0;
-}
-
-// ============================================================================
-// Figures
-// ============================================================================
-
-figure {
- margin: 1.5rem 0;
-}
-
-figcaption {
- text-align: center;
- font-size: 0.9rem;
- color: var(--wt-color-text-muted);
- margin-top: 0.5rem;
-}
-
-// ============================================================================
-// Responsive
-// ============================================================================
-
-@media screen and (max-width: 1024px) {
- :root {
- --wt-main-padding-top: 30px;
- }
-
- main {
- padding: var(--wt-main-padding-top) 40px;
- gap: 1.5rem;
- }
-
- .content {
- max-width: 100%;
- padding: 1.5rem 24px;
- }
-}
-
-// ============================================================================
-// Mobile Menu
-// Z-index: overlay(199) < menu(200) < header(201)
-// ============================================================================
-
-.mobile-menu-toggle {
- display: none;
- align-items: center;
- justify-content: center;
- background: none;
- border: none;
- padding: 0.5rem;
- margin-right: auto;
- cursor: pointer;
- color: var(--wt-color-text);
- transition: color 150ms;
- -webkit-tap-highlight-color: transparent;
-
- &:hover {
- color: var(--wt-color-accent);
- }
-
- .close-icon {
- display: none;
- }
-
- &[aria-expanded="true"] {
- .menu-icon {
- display: none;
- }
- .close-icon {
- display: block;
- }
- }
-}
-
-.mobile-menu-overlay {
- display: none;
- position: fixed;
- inset: 0;
- background: rgba(0, 0, 0, 0.4);
- z-index: 199;
- opacity: 0;
- transition: opacity 200ms ease;
-
- &.active {
- display: block;
- opacity: 1;
- }
-}
-
-.mobile-menu {
- display: none;
- position: fixed;
- top: calc(var(--wt-header-height) + env(safe-area-inset-top, 0px));
- left: 0;
- width: min(260px, 70vw);
- // iOS jank fix: --vh-full set by JS, fallback to lvh. See base.html.
- height: calc(var(--vh-full, 100lvh) - var(--wt-header-height) - env(safe-area-inset-top, 0px));
- background: var(--wt-color-bg-elevated);
- border-right: 1px solid var(--wt-color-border-subtle);
- z-index: 200;
- transform: translateX(-100%);
- transition: transform 250ms ease;
- overflow-y: auto;
- overscroll-behavior: contain;
-
- &.active {
- display: block;
- transform: translateX(0);
- }
-}
-
-.mobile-menu-content {
- padding: 1rem 0.75rem 2rem;
-}
-
-.mobile-menu-section {
- display: flex;
- flex-direction: column;
- gap: 0.25rem;
-}
-
-.mobile-nav-item {
- display: block;
- padding: 0.6rem 0.75rem;
- font-size: 0.95rem;
- font-weight: 500;
- color: var(--wt-color-text);
- border-radius: var(--wt-radius-sm);
- transition: background 150ms, color 150ms;
-
- &:hover {
- background: var(--wt-color-bg-soft);
- }
-}
-
-.mobile-menu-divider {
- height: 1px;
- background: var(--wt-color-border-subtle);
- margin: 1rem 0;
-}
-
-.mobile-menu-toc {
- gap: 0;
-}
-
-.mobile-toc-group {
- font-size: 0.65rem;
- font-weight: 600;
- text-transform: uppercase;
- letter-spacing: 0.05em;
- color: var(--wt-color-text-soft);
- padding: 0.6rem 0.75rem 0.2rem;
- margin-top: 0.4rem;
-
- &:first-child {
- margin-top: 0;
- }
-}
-
-.mobile-toc-item {
- display: block;
- padding: 0.5rem 0.75rem;
- font-size: 0.85rem;
- color: var(--wt-color-text-muted);
- border-radius: var(--wt-radius-sm);
- transition: background 150ms, color 150ms;
-
- &:hover {
- background: var(--wt-color-bg-soft);
- color: var(--wt-color-text);
- }
-}
-
-// Prevent body scroll when mobile menu is open
-body.mobile-menu-open {
- overflow: hidden;
-}
-
-@media screen and (max-width: 768px) {
- :root {
- --wt-header-height: 50px;
- --wt-main-padding-top: 20px;
- }
-
- body {
- font-size: 16px;
- }
-
- header {
- height: calc(var(--wt-header-height) + env(safe-area-inset-top, 0px));
- padding: 10px 20px;
- padding-top: calc(env(safe-area-inset-top, 0px) + 10px);
- display: flex;
- flex-direction: row;
- align-items: center;
- justify-content: space-between;
- }
-
- // Hide desktop nav on mobile
- header nav {
- display: none;
- }
-
- main {
- padding: var(--wt-main-padding-top);
- flex-direction: column;
- }
-
- .content {
- padding: 1rem 16px;
- border-radius: var(--wt-radius-lg);
- }
-
- h1, .heading-text {
- font-size: 1.5rem;
- }
-
- h2 {
- font-size: 1.25rem;
- }
-
- .hero {
- height: calc(var(--vh-full, 100lvh) - var(--wt-header-height) - env(safe-area-inset-top, 0px));
- padding: 2rem 20px;
- flex-direction: column;
- gap: 2rem;
-
- .heading-text {
- font-size: 2rem;
- }
- }
-
- .toc {
- display: none;
- }
-
- .mobile-menu-toggle {
- display: flex;
- }
-}
-
-// ============================================================================
-// View Transitions (smooth page navigation)
-// ============================================================================
-
-@view-transition {
- navigation: auto;
-}
-
-::view-transition-old(root),
-::view-transition-new(root) {
- animation-duration: 50ms;
-}
-
-// Freeze focused search box during transition - no animation, just cross-fade
-::view-transition-old(search-frozen),
-::view-transition-new(search-frozen) {
- animation: none;
-}
-
-// ============================================================================
-// Transitions & Accessibility
-// ============================================================================
-
-button, .nav-item {
- transition: color 150ms, background 150ms, box-shadow 150ms;
-}
-
-// Focus states
-a:focus-visible,
-button:focus-visible,
-input:focus-visible {
- outline: 2px solid var(--wt-color-accent);
- outline-offset: 2px;
-}
-
-// Reduce motion for users who prefer it
-@media (prefers-reduced-motion: reduce) {
- *, *::before, *::after {
- animation-duration: 0.01ms !important;
- animation-iteration-count: 1 !important;
- transition-duration: 0.01ms !important;
- }
-
- ::view-transition-old(root),
- ::view-transition-new(root) {
- animation: none !important;
- }
-}
-
-// ============================================================================
-// Micro-interactions
-// ============================================================================
-
-// Search - subtle glow on focus
-#userinput:focus {
- box-shadow: 0 0 0 3px var(--wt-shadow-accent);
-}
-
-// Content links - animated underline flourish on hover
-// Permanent underline via text-decoration; ::after adds animated thickening
-.content a:not(.button):not(.heading-anchor):not(.zola-anchor) {
- position: relative;
-
- &::after {
- content: "";
- position: absolute;
- left: 0;
- bottom: 0;
- width: 0;
- height: 2px;
- background: var(--wt-color-link);
- transition: width 200ms ease-out;
- }
-
- &:hover::after {
- width: 100%;
- }
-}
-
-// .button shadows defined in Hero Section
-
-// Custom scrollbar (webkit browsers)
-::-webkit-scrollbar {
- width: 8px;
- height: 8px;
-}
-
-::-webkit-scrollbar-track {
- background: transparent;
-}
-
-::-webkit-scrollbar-thumb {
- background: var(--wt-color-border-subtle);
- border-radius: var(--wt-radius-sm);
-
- &:hover {
- background: var(--wt-color-text-soft);
- }
-}
-
-// Firefox scrollbar
-* {
- scrollbar-width: thin;
- scrollbar-color: var(--wt-color-border-subtle) transparent;
-}
-
-// Custom text selection
-::selection {
- background: var(--wt-color-accent-soft);
- color: var(--wt-color-text);
-}
-
-
-// Nav item hover underlines
-header nav .nav-item {
- position: relative;
-
- &::after {
- content: "";
- position: absolute;
- left: 0;
- bottom: -2px;
- width: 0;
- height: 2px;
- background: var(--wt-color-accent);
- transition: width 200ms ease-out;
- }
-
- &:hover::after {
- width: 100%;
- }
-}
-
-// TOC hover defined in .toc-item a:hover
-
-// Logo hover effect
-header .logo:hover img {
- filter: drop-shadow(0 0 8px var(--wt-shadow-accent-strong));
- transition: filter 200ms ease;
-}
-
-// button.explore-more uses .hero .explore-more animation (float keyframes)
-
-// ============================================================================
-// Dark Mode Adjustments
-// ============================================================================
-
-@media (prefers-color-scheme: dark) {
- :root {
- color-scheme: dark;
- }
-
- #suggestions {
- .search-title b,
- .search-excerpt b {
- color: var(--wt-color-accent);
- }
- }
-}
-
-// ============================================================================
-// Print Styles
-// ============================================================================
-
-@media print {
- // Hide navigation elements
- header,
- footer,
- .toc,
- .hero,
- .mobile-menu,
- .mobile-menu-overlay,
- .mobile-menu-toggle,
- .code-copy-btn,
- .page-nav {
- display: none !important;
- }
-
- // Reset layout
- body {
- background: white;
- color: black;
- font-size: 12pt;
- }
-
- main {
- display: block;
- padding: 0;
- }
-
- .content {
- max-width: 100%;
- padding: 0;
- border: none;
- box-shadow: none;
- background: transparent;
- }
-
- // Improve link visibility
- .content a {
- color: black;
- text-decoration: underline;
-
- &[href^="http"]::after {
- content: " (" attr(href) ")";
- font-size: 0.8em;
- color: #666;
- }
- }
-
- // Code blocks - keep together, remove decorative elements
- // Use !important to override dark mode variables that might bleed through
- .content pre,
- .terminal {
- border: 1px solid #ccc !important;
- box-shadow: none !important;
- page-break-inside: avoid;
- background: #f5f5f5 !important;
- }
-
- // Tables
- .content table {
- page-break-inside: avoid;
- }
-
- // Headings - keep with following content
- h1, h2, h3, h4, h5, h6 {
- page-break-after: avoid;
- }
-
- // Images
- img {
- max-width: 100%;
- page-break-inside: avoid;
- }
-}
diff --git a/docs/scripts/parity.mjs b/docs/scripts/parity.mjs
new file mode 100644
index 000000000..7621952c6
--- /dev/null
+++ b/docs/scripts/parity.mjs
@@ -0,0 +1,252 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { chromium } from 'playwright';
+
+const docsRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const repoRoot = path.resolve(docsRoot, '..');
+const args = new Map();
+
+for (let index = 2; index < process.argv.length; index += 1) {
+ const name = process.argv[index];
+ if (!name.startsWith('--')) throw new Error(`Unexpected argument: ${name}`);
+ const value = process.argv[index + 1];
+ if (!value || value.startsWith('--')) throw new Error(`Missing value for ${name}`);
+ args.set(name.slice(2), value);
+ index += 1;
+}
+
+const referenceBase = new URL(args.get('reference') ?? 'https://worktrunk.dev/');
+const candidateBase = new URL(args.get('candidate') ?? 'http://127.0.0.1:4321/');
+const timestamp = new Date().toISOString().replaceAll(':', '-').replaceAll('.', '-');
+const outputDir = path.resolve(args.get('output') ?? path.join(repoRoot, '.tmp', 'site-parity', timestamp));
+
+const routes = [
+ { path: '/', label: 'Home' },
+ { path: '/switch/', label: 'Switch' },
+ { path: '/extending/', label: 'Extending' },
+ { path: '/config/', label: 'Config' },
+];
+const viewports = [
+ { name: 'desktop', width: 1440, height: 1000 },
+ { name: 'mobile', width: 390, height: 844 },
+];
+const themes = ['light', 'dark'];
+
+await mkdir(outputDir, { recursive: true });
+
+let browser;
+try {
+ browser = await chromium.launch({ channel: process.env.PLAYWRIGHT_BROWSER_CHANNEL ?? 'chrome' });
+} catch (error) {
+ if (process.env.PLAYWRIGHT_BROWSER_CHANNEL) throw error;
+ browser = await chromium.launch();
+}
+
+const report = {
+ generatedAt: new Date().toISOString(),
+ reference: referenceBase.href,
+ candidate: candidateBase.href,
+ outputDir,
+ cases: [],
+};
+
+try {
+ for (const viewport of viewports) {
+ for (const theme of themes) {
+ for (const route of routes) {
+ const id = `${route.path === '/' ? 'home' : route.path.split('/').filter(Boolean).join('-')}-${viewport.name}-${theme}`;
+ const entry = { id, route: route.path, routeLabel: route.label, viewport, theme };
+
+ for (const target of [
+ { name: 'reference', base: referenceBase },
+ { name: 'candidate', base: candidateBase },
+ ]) {
+ const context = await browser.newContext({
+ viewport: { width: viewport.width, height: viewport.height },
+ colorScheme: theme,
+ reducedMotion: 'reduce',
+ });
+ await context.addInitScript((selectedTheme) => {
+ localStorage.setItem('starlight-theme', selectedTheme);
+ }, theme);
+ const page = await context.newPage();
+ const consoleErrors = [];
+ const failedRequests = [];
+ page.on('console', (message) => {
+ if (message.type() === 'error') consoleErrors.push(message.text());
+ });
+ page.on('requestfailed', (request) => {
+ failedRequests.push({ url: request.url(), error: request.failure()?.errorText ?? 'unknown' });
+ });
+
+ const url = new URL(route.path, target.base);
+ const response = await page.goto(url.href, { waitUntil: 'domcontentloaded', timeout: 30_000 });
+ await page.evaluate(async () => {
+ if (document.fonts?.ready) await document.fonts.ready;
+ });
+
+ const screenshot = `${id}-${target.name}.png`;
+ await page.screenshot({
+ path: path.join(outputDir, screenshot),
+ fullPage: true,
+ animations: 'disabled',
+ });
+
+ const observation = await page.evaluate(() => {
+ const visible = (element) => {
+ if (!element) return false;
+ const style = getComputedStyle(element);
+ const rect = element.getBoundingClientRect();
+ return style.display !== 'none' && style.visibility !== 'hidden' && rect.width > 0 && rect.height > 0;
+ };
+ const rect = (element) => {
+ if (!element) return null;
+ const value = element.getBoundingClientRect();
+ return {
+ x: Math.round(value.x * 100) / 100,
+ y: Math.round(value.y * 100) / 100,
+ width: Math.round(value.width * 100) / 100,
+ height: Math.round(value.height * 100) / 100,
+ };
+ };
+ const textElement = (selector, text) =>
+ [...document.querySelectorAll(selector)].find((element) => element.textContent?.trim() === text);
+ const comparison = [...document.querySelectorAll('table')].find((table) =>
+ /Worktrunk/.test(table.textContent ?? '') && /Plain Git/i.test(table.textContent ?? '')
+ );
+ const prose = document.querySelector('[data-contract="home-content-rail"] > p')
+ ?? document.querySelector('main .content > p, .sl-markdown-content > p, main p');
+ const demo = document.querySelector('figure.demo');
+ const railRects = [prose, demo, comparison].map(rect).filter(Boolean);
+ const lefts = railRects.map((value) => value.x);
+ const starLink = document.querySelector('a[aria-label="GitHub stars"]')
+ ?? [...document.querySelectorAll('a[href="https://github.com/max-sixty/worktrunk"]')]
+ .find((anchor) => /stars/i.test(anchor.textContent ?? ''));
+ const starImage = starLink?.querySelector('img[src*="img.shields.io/github/stars"]') ?? null;
+ const mobileMenu = textElement('button', 'Menu') ?? document.querySelector('button[aria-label*="menu" i]');
+ const hrefs = [...document.querySelectorAll('a[href]')].map((anchor) => anchor.href);
+
+ return {
+ title: document.title,
+ document: {
+ width: document.documentElement.scrollWidth,
+ clientWidth: document.documentElement.clientWidth,
+ height: document.documentElement.scrollHeight,
+ },
+ geometry: {
+ header: rect(document.querySelector('header')),
+ hero: rect(document.querySelector('[data-contract="home-hero"], .hero')),
+ heroTitle: rect(textElement('h1', 'Worktrunk')),
+ heroLogo: rect(document.querySelector('[data-contract="hero-logo"] img, .hero-image, .hero > img')),
+ prose: rect(prose),
+ demo: rect(demo),
+ comparison: rect(comparison),
+ contentRailLeftSpread: lefts.length > 1 ? Math.max(...lefts) - Math.min(...lefts) : null,
+ },
+ capabilities: {
+ star: {
+ linkFound: Boolean(starLink),
+ href: starLink?.href ?? null,
+ visibleText: starLink?.textContent?.trim() ?? null,
+ liveBadge: Boolean(starImage),
+ imageSrc: starImage?.src ?? null,
+ imageComplete: starImage?.complete ?? false,
+ naturalWidth: starImage?.naturalWidth ?? 0,
+ naturalHeight: starImage?.naturalHeight ?? 0,
+ },
+ mobileMenu: {
+ present: Boolean(mobileMenu),
+ visible: visible(mobileMenu),
+ },
+ destinations: {
+ github: hrefs.some((href) => href === 'https://github.com/max-sixty/worktrunk'),
+ crates: hrefs.some((href) => href.startsWith('https://crates.io/crates/worktrunk')),
+ share: hrefs.some((href) => href.startsWith('https://twitter.com/intent/tweet')),
+ tips: hrefs.some((href) => new URL(href).pathname === '/tips-patterns/'),
+ },
+ },
+ };
+ });
+
+ entry[target.name] = {
+ url: url.href,
+ status: response?.status() ?? null,
+ screenshot,
+ consoleErrors,
+ failedRequests,
+ ...observation,
+ };
+ await context.close();
+ }
+ report.cases.push(entry);
+ }
+ }
+ }
+} finally {
+ await browser.close();
+}
+
+const escapeHtml = (value) => String(value)
+ .replaceAll('&', '&amp;')
+ .replaceAll('<', '&lt;')
+ .replaceAll('>', '&gt;')
+ .replaceAll('"', '&quot;');
+
+const homeCases = report.cases.filter((entry) => entry.route === '/');
+const parityRows = homeCases.map((entry) => {
+ const referenceCapabilities = entry.reference.capabilities;
+ const candidateCapabilities = entry.candidate.capabilities;
+ const starClass = candidateCapabilities.star.liveBadge && candidateCapabilities.star.naturalWidth > 0 ? 'pass' : 'fail';
+ return `<tr>
+ <td>${escapeHtml(`${entry.viewport.name} / ${entry.theme}`)}</td>
+ <td>${referenceCapabilities.star.liveBadge ? `${referenceCapabilities.star.naturalWidth}×${referenceCapabilities.star.naturalHeight}` : 'missing'}</td>
+ <td class="${starClass}">${candidateCapabilities.star.liveBadge ? `${candidateCapabilities.star.naturalWidth}×${candidateCapabilities.star.naturalHeight}` : `missing; text=${escapeHtml(candidateCapabilities.star.visibleText)}`}</td>
+ <td>${entry.reference.geometry.contentRailLeftSpread ?? 'n/a'}px</td>
+ <td>${entry.candidate.geometry.contentRailLeftSpread ?? 'n/a'}px</td>
+ </tr>`;
+}).join('\n');
+
+const casesHtml = report.cases.map((entry) => `<section>
+ <h2>${escapeHtml(`${entry.routeLabel} · ${entry.viewport.name} · ${entry.theme}`)}</h2>
+ <div class="pair">
+ <figure><figcaption>Reference</figcaption><a href="${entry.reference.screenshot}"><img src="${entry.reference.screenshot}" alt="Reference ${escapeHtml(entry.routeLabel)}"></a></figure>
+ <figure><figcaption>Candidate</figcaption><a href="${entry.candidate.screenshot}"><img src="${entry.candidate.screenshot}" alt="Candidate ${escapeHtml(entry.routeLabel)}"></a></figure>
+ </div>
+</section>`).join('\n');
+
+const html = `<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width">
+<title>Worktrunk site parity report</title>
+<style>
+ :root { color-scheme: light dark; font-family: system-ui, sans-serif; }
+ body { margin: 0 auto; max-width: 110rem; padding: 2rem; background: #eeece7; color: #2d2926; }
+ h1, h2 { letter-spacing: -.025em; } h2 { margin-top: 4rem; }
+ table { border-collapse: collapse; background: #fff; } th, td { padding: .6rem .8rem; border: 1px solid #d8d3cb; text-align: left; }
+ .pass { color: #28650b; } .fail { color: #a61b1b; font-weight: 700; }
+ .pair { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 1rem; align-items: start; }
+ figure { margin: 0; } figcaption { margin-bottom: .5rem; font: 600 .78rem ui-monospace, monospace; text-transform: uppercase; letter-spacing: .08em; }
+ img { display: block; width: 100%; height: auto; background: white; border: 1px solid #d8d3cb; }
+ @media (max-width: 60rem) { .pair { grid-template-columns: 1fr; } body { padding: 1rem; } }
+</style></head><body>
+<h1>Worktrunk site parity report</h1>
+<p><strong>Reference:</strong> ${escapeHtml(referenceBase.href)}<br><strong>Candidate:</strong> ${escapeHtml(candidateBase.href)}<br><strong>Generated:</strong> ${escapeHtml(report.generatedAt)}</p>
+<p>This report exposes visual and capability differences; it does not decide whether an intentional change is better.</p>
+<h2>Homepage capability floor</h2>
+<table><thead><tr><th>Case</th><th>Reference stars</th><th>Candidate stars</th><th>Reference rail spread</th><th>Candidate rail spread</th></tr></thead><tbody>${parityRows}</tbody></table>
+${casesHtml}
+</body></html>`;
+
+await Promise.all([
+ writeFile(path.join(outputDir, 'report.json'), `${JSON.stringify(report, null, 2)}\n`),
+ writeFile(path.join(outputDir, 'index.html'), html),
+]);
+
+const missingCandidateStars = homeCases.filter((entry) => !entry.candidate.capabilities.star.liveBadge || entry.candidate.capabilities.star.naturalWidth === 0);
+console.log(`Parity report: ${path.join(outputDir, 'index.html')}`);
+console.log(`Machine data: ${path.join(outputDir, 'report.json')}`);
+console.log(`Captured ${report.cases.length} cases (${report.cases.length * 2} screenshots).`);
+if (missingCandidateStars.length > 0) {
+ console.log(`Capability mismatch: live GitHub star badge missing in ${missingCandidateStars.length}/${homeCases.length} candidate homepage cases.`);
+}
diff --git a/docs/src/components/Footer.astro b/docs/src/components/Footer.astro
new file mode 100644
index 000000000..fb3efc32b
--- /dev/null
+++ b/docs/src/components/Footer.astro
@@ -0,0 +1,51 @@
+---
+import DefaultFooter from '@astrojs/starlight/components/Footer.astro';
+
+const links = [
+ ['GitHub', 'https://github.com/max-sixty/worktrunk'],
+ ['crates.io', 'https://crates.io/crates/worktrunk'],
+ [
+ 'Share on X',
+ 'https://twitter.com/intent/tweet?text=Worktrunk%20%E2%80%94%20CLI%20for%20git%20worktree%20management&url=https%3A%2F%2Fworktrunk.dev',
+ ],
+ [
+ 'Reddit',
+ 'https://www.reddit.com/submit?url=https%3A%2F%2Fworktrunk.dev&title=Worktrunk%20%E2%80%94%20CLI%20for%20git%20worktree%20management',
+ ],
+ ['LinkedIn', 'https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fworktrunk.dev'],
+] as const;
+---
+
+<div class="wt-footer-stack">
+ <DefaultFooter><slot /></DefaultFooter>
+ <nav class="wt-project-links" data-contract="project-links" aria-label="Project links">
+ {links.map(([label, href]) => <a href={href}>{label}</a>)}
+ </nav>
+</div>
+
+<style>
+ .wt-project-links {
+ box-sizing: border-box;
+ display: flex;
+ flex-wrap: wrap;
+ gap: 0.45rem 1.15rem;
+ width: min(calc(100% - 2rem), 53.75rem);
+ margin: 2rem auto 0;
+ border-block-start: 1px solid var(--wt-line);
+ padding-block: 1rem 2rem;
+ font-family: var(--sl-font-mono);
+ font-size: 0.68rem;
+ letter-spacing: 0.045em;
+ }
+
+ .wt-project-links a {
+ color: var(--wt-ink-muted);
+ text-decoration: none;
+ }
+
+ .wt-project-links a:hover {
+ color: var(--wt-copper);
+ text-decoration: underline;
+ text-underline-offset: 0.2em;
+ }
+</style>
diff --git a/docs/src/components/Head.astro b/docs/src/components/Head.astro
new file mode 100644
index 000000000..37e66f0d6
--- /dev/null
+++ b/docs/src/components/Head.astro
@@ -0,0 +1,97 @@
+---
+import Default from '@astrojs/starlight/components/Head.astro';
+
+const description = 'Git worktree management for parallel AI agent workflows.';
+const image = new URL('/assets/social/social-card.png', Astro.site).href;
+const isHome = Astro.url.pathname === '/';
+const structuredData = isHome
+ ? [
+ {
+ '@context': 'https://schema.org',
+ '@type': 'WebSite',
+ name: 'Worktrunk',
+ url: 'https://worktrunk.dev/',
+ description,
+ },
+ {
+ '@context': 'https://schema.org',
+ '@type': 'SoftwareApplication',
+ name: 'Worktrunk',
+ url: 'https://worktrunk.dev/',
+ description,
+ applicationCategory: 'DeveloperApplication',
+ operatingSystem: 'macOS, Linux, Windows',
+ offers: {
+ '@type': 'Offer',
+ price: '0',
+ priceCurrency: 'USD',
+ },
+ codeRepository: 'https://github.com/max-sixty/worktrunk',
+ license: 'https://opensource.org/licenses/Apache-2.0',
+ },
+ ]
+ : [];
+---
+
+<Default />
+<meta property="og:image" content={image} />
+<meta property="og:image:width" content="1200" />
+<meta property="og:image:height" content="630" />
+<meta name="twitter:image" content={image} />
+<style is:inline>starlight-menu-button:not(:defined) { display: none; }</style>
+<script>
+ import { installTocFollower } from './toc-scroll.mjs';
+
+ installTocFollower();
+</script>
+<script is:inline>
+ if (window.location.hostname === 'worktrunk.dev') {
+ const analytics = document.createElement('script');
+ analytics.async = true;
+ analytics.src = 'https://www.googletagmanager.com/gtag/js?id=G-6YY8BDJ4QH';
+ document.head.append(analytics);
+ window.dataLayer = window.dataLayer || [];
+ function gtag(){dataLayer.push(arguments);}
+ gtag('js', new Date());
+ gtag('config', 'G-6YY8BDJ4QH');
+ }
+
+ function setDemoTheme(root = document) {
+ const theme = document.documentElement.dataset.theme === 'dark' ? 'dark' : 'light';
+ root.querySelectorAll('figure.demo picture > source').forEach((source) => {
+ const sourceTheme = source.dataset.demoTheme
+ || (source.srcset.includes('/dark/') ? 'dark' : 'light');
+ const layoutMedia = source.dataset.demoMedia || 'all';
+ source.media = sourceTheme === theme ? layoutMedia : 'not all';
+ });
+ }
+
+ if (document.readyState === 'loading') {
+ document.addEventListener('DOMContentLoaded', () => setDemoTheme(), { once: true });
+ } else {
+ setDemoTheme();
+ }
+ document.addEventListener('astro:page-load', () => setDemoTheme());
+ new MutationObserver(() => setDemoTheme()).observe(document.documentElement, {
+ attributes: true,
+ attributeFilter: ['data-theme'],
+ });
+
+ // Starlight keeps mobile-menu state on the host, while accessibility APIs
+ // read it from the controlling button.
+ new MutationObserver((mutations) => {
+ mutations.forEach(({ target }) => {
+ if (!(target instanceof HTMLElement) || target.localName !== 'starlight-menu-button') return;
+ const button = target.querySelector('button');
+ const expanded = target.getAttribute('aria-expanded') === 'true' ? 'true' : 'false';
+ if (button?.getAttribute('aria-expanded') !== expanded) {
+ button.setAttribute('aria-expanded', expanded);
+ }
+ });
+ }).observe(document.documentElement, {
+ attributes: true,
+ attributeFilter: ['aria-expanded'],
+ subtree: true,
+ });
+</script>
+{structuredData.map((value) => <script is:inline type="application/ld+json" set:html={JSON.stringify(value)} />)}
diff --git a/docs/src/components/PageTitle.astro b/docs/src/components/PageTitle.astro
new file mode 100644
index 000000000..f0c1dcbdb
--- /dev/null
+++ b/docs/src/components/PageTitle.astro
@@ -0,0 +1,30 @@
+---
+import DefaultPageTitle from '@astrojs/starlight/components/PageTitle.astro';
+import type { StarlightRouteData } from '@astrojs/starlight/route-data';
+
+const isHomepage = Astro.url.pathname === '/';
+const { starlightRoute } = Astro.locals as typeof Astro.locals & {
+ starlightRoute: StarlightRouteData;
+};
+const title = starlightRoute.entry.data.title;
+---
+
+{
+ isHomepage ? (
+ <h1 id="_top"><span id="worktrunk">{title}</span></h1>
+ ) : (
+ <DefaultPageTitle />
+ )
+}
+
+<style>
+ @layer starlight.core {
+ h1 {
+ margin-top: 1rem;
+ color: var(--sl-color-white);
+ font-size: var(--sl-text-h1);
+ font-weight: 600;
+ line-height: var(--sl-line-height-headings);
+ }
+ }
+</style>
diff --git a/docs/src/components/SocialIcons.astro b/docs/src/components/SocialIcons.astro
new file mode 100644
index 000000000..c932e8f77
--- /dev/null
+++ b/docs/src/components/SocialIcons.astro
@@ -0,0 +1,29 @@
+<a
+ class="wt-header-stars"
+ data-contract="github-stars"
+ href="https://github.com/max-sixty/worktrunk"
+ aria-label="GitHub stars"
+>
+ <img
+ src="https://img.shields.io/github/stars/max-sixty/worktrunk?style=social"
+ alt="GitHub stars"
+ width="90"
+ height="20"
+ loading="eager"
+ decoding="async"
+ />
+</a>
+
+<style>
+ .wt-header-stars {
+ display: inline-flex;
+ align-items: center;
+ padding: 0.25rem;
+ line-height: 0;
+ }
+
+ .wt-header-stars img {
+ width: auto;
+ height: 1.25rem;
+ }
+</style>
diff --git a/docs/src/components/ThemeSelect.astro b/docs/src/components/ThemeSelect.astro
new file mode 100644
index 000000000..8122daab7
--- /dev/null
+++ b/docs/src/components/ThemeSelect.astro
@@ -0,0 +1 @@
+<!-- Worktrunk follows the operating-system theme without adding another header control. -->
diff --git a/docs/src/components/toc-scroll.mjs b/docs/src/components/toc-scroll.mjs
new file mode 100644
index 000000000..f8c7a6bc0
--- /dev/null
+++ b/docs/src/components/toc-scroll.mjs
@@ -0,0 +1,145 @@
+const desktopTocSelector = 'nav[aria-labelledby="starlight__on-this-page"]';
+const tocRootSelector = 'starlight-toc, mobile-starlight-toc';
+const scrollportSelector = '.right-sidebar';
+const desktopBreakpoint = '(min-width: 72rem)';
+const tocInset = 48;
+
+function currentSetter(element) {
+ for (let prototype = Object.getPrototypeOf(element); prototype; prototype = Object.getPrototypeOf(prototype)) {
+ const setter = Object.getOwnPropertyDescriptor(prototype, 'current')?.set;
+ if (setter) return setter;
+ }
+}
+
+function syncTocRootToHash(toc, hash) {
+ const link = [...toc.querySelectorAll('a')].find((candidate) => candidate.hash === hash);
+ if (!link) return false;
+
+ const setter = currentSetter(toc);
+ if (setter) {
+ setter.call(toc, link);
+ } else {
+ for (const current of toc.querySelectorAll('a[aria-current="true"]')) {
+ current.removeAttribute('aria-current');
+ }
+ link.setAttribute('aria-current', 'true');
+ }
+
+ const display = toc.querySelector('.display-current');
+ if (display) display.textContent = link.textContent;
+ return true;
+}
+
+export function syncTocCurrentToHash(doc = document, hash = window.location.hash) {
+ if (!hash) return false;
+ return [...doc.querySelectorAll(tocRootSelector)]
+ .map((toc) => syncTocRootToHash(toc, hash))
+ .some(Boolean);
+}
+
+export function tocScrollDelta(scrollportRect, currentRect, inset = tocInset) {
+ const availableInset = Math.min(inset, (scrollportRect.bottom - scrollportRect.top) / 4);
+ const top = scrollportRect.top + availableInset;
+ const bottom = scrollportRect.bottom - availableInset;
+ if (currentRect.top < top) return currentRect.top - top;
+ if (currentRect.bottom > bottom) return currentRect.bottom - bottom;
+ return 0;
+}
+
+export function keepCurrentTocLinkVisible(current) {
+ const toc = current.closest(desktopTocSelector);
+ if (!toc || toc.getClientRects().length === 0) return false;
+
+ const scrollport = toc.closest(scrollportSelector);
+ if (!scrollport || scrollport.scrollHeight <= scrollport.clientHeight) return false;
+
+ const delta = tocScrollDelta(
+ scrollport.getBoundingClientRect(),
+ current.getBoundingClientRect(),
+ );
+ if (delta === 0) return false;
+ scrollport.scrollTop += delta;
+ return true;
+}
+
+// Follow Starlight's own current-section state; never infer it from document scroll.
+export function installTocFollower(doc = document, view = window) {
+ let pendingHash = view.location.hash;
+ const initializedTocs = new WeakSet();
+ const correctedTocs = new Set();
+ const applyPendingHash = () => {
+ const tocs = [...doc.querySelectorAll(tocRootSelector)];
+ if (!pendingHash || tocs.length === 0 || !tocs.every((toc) => initializedTocs.has(toc))) {
+ return false;
+ }
+ const matched = syncTocCurrentToHash(doc, pendingHash);
+ if (matched) pendingHash = '';
+ return matched;
+ };
+ const followCurrent = () => {
+ const current = doc.querySelector(`${desktopTocSelector} a[aria-current="true"]`);
+ if (current) keepCurrentTocLinkVisible(current);
+ };
+
+ const observer = new MutationObserver((mutations) => {
+ for (const { target } of mutations) {
+ if (target.getAttribute('aria-current') !== 'true') continue;
+ const toc = target.closest(tocRootSelector);
+ if (toc) initializedTocs.add(toc);
+ if (pendingHash && toc && !correctedTocs.has(toc)) {
+ syncTocRootToHash(toc, pendingHash);
+ correctedTocs.add(toc);
+ const tocs = [...doc.querySelectorAll(tocRootSelector)];
+ if (tocs.length > 0 && tocs.every((candidate) => correctedTocs.has(candidate))) {
+ pendingHash = '';
+ }
+ break;
+ }
+ if (keepCurrentTocLinkVisible(target)) break;
+ }
+ });
+ observer.observe(doc.documentElement, {
+ attributes: true,
+ attributeFilter: ['aria-current'],
+ subtree: true,
+ });
+
+ const desktop = view.matchMedia(desktopBreakpoint);
+ const followOnDesktop = ({ matches }) => {
+ if (matches) followCurrent();
+ };
+ desktop.addEventListener('change', followOnDesktop);
+ doc.addEventListener('astro:page-load', followCurrent);
+ followCurrent();
+
+ let syncFrame;
+ const scheduleHashSync = (hash = view.location.hash) => {
+ if (!hash) return;
+ pendingHash = hash;
+ correctedTocs.clear();
+ view.cancelAnimationFrame(syncFrame);
+ syncFrame = view.requestAnimationFrame(() => {
+ syncFrame = view.requestAnimationFrame(() => {
+ applyPendingHash();
+ });
+ });
+ };
+ const syncLocationHash = () => scheduleHashSync();
+ const syncClickedHash = ({ target }) => {
+ const link = target?.closest?.(`${tocRootSelector} a[href^="#"]`);
+ if (link) scheduleHashSync(link.hash);
+ };
+ doc.addEventListener('click', syncClickedHash);
+ doc.addEventListener('astro:page-load', syncLocationHash);
+ view.addEventListener('hashchange', syncLocationHash);
+
+ return () => {
+ observer.disconnect();
+ view.cancelAnimationFrame(syncFrame);
+ desktop.removeEventListener('change', followOnDesktop);
+ doc.removeEventListener('astro:page-load', followCurrent);
+ doc.removeEventListener('click', syncClickedHash);
+ doc.removeEventListener('astro:page-load', syncLocationHash);
+ view.removeEventListener('hashchange', syncLocationHash);
+ };
+}
diff --git a/docs/src/content.config.ts b/docs/src/content.config.ts
new file mode 100644
index 000000000..6a7b7a02b
--- /dev/null
+++ b/docs/src/content.config.ts
@@ -0,0 +1,7 @@
+import { defineCollection } from 'astro:content';
+import { docsLoader } from '@astrojs/starlight/loaders';
+import { docsSchema } from '@astrojs/starlight/schema';
+
+export const collections = {
+ docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+};
diff --git a/docs/content/claude-code.md b/docs/src/content/docs/claude-code.md
similarity index 68%
rename from docs/content/claude-code.md
rename to docs/src/content/docs/claude-code.md
index d65451ef3..9e7930a6f 100644
--- a/docs/content/claude-code.md
+++ b/docs/src/content/docs/claude-code.md
@@ -1,12 +1,9 @@
-+++
-title = "Agent Integration"
-description = "Worktrunk plugins for Claude Code, Codex, OpenCode, and Gemini CLI: a configuration skill, wt list activity tracking, and Claude-only worktree isolation."
-weight = 23
-
-[extra]
-group = "Reference"
-+++
-
+---
+title: "Agent Integration"
+description: "Worktrunk plugins for Claude Code, Codex, OpenCode, and Gemini CLI: a configuration skill, wt list activity tracking, and Claude-only worktree isolation."
+sidebar:
+ order: 23
+---
Worktrunk ships a plugin for each supported agent CLI. What a plugin provides depends on the hooks that CLI exposes:
| Capability | Claude Code | Codex | OpenCode | Gemini CLI |
@@ -22,31 +19,44 @@ The configuration skill is documentation the agent reads to help set up LLM comm
### Claude Code
-{{ terminal(cmd="wt config plugins claude install") }}
+```bash
+wt config plugins claude install
+```
Manual equivalent:
-{{ terminal(cmd="claude plugin marketplace add max-sixty/worktrunk|||claude plugin install worktrunk@worktrunk") }}
+```bash
+claude plugin marketplace add max-sixty/worktrunk
+claude plugin install worktrunk@worktrunk
+```
### Codex
-{{ terminal(cmd="wt config plugins codex install") }}
+```bash
+wt config plugins codex install
+```
This configures the Worktrunk marketplace in Codex. Then run `/plugins` in Codex and install Worktrunk from the marketplace. Manual equivalent:
-{{ terminal(cmd="codex plugin marketplace add max-sixty/worktrunk") }}
+```bash
+codex plugin marketplace add max-sixty/worktrunk
+```
To remove the marketplace entry, run `wt config plugins codex uninstall`. Already-installed plugins are left unchanged.
### OpenCode
-{{ terminal(cmd="wt config plugins opencode install") }}
+```bash
+wt config plugins opencode install
+```
This writes the activity-tracking plugin to OpenCode's global plugins directory, `~/.config/opencode/plugins/worktrunk.ts` (honoring `$OPENCODE_CONFIG_DIR` and `$XDG_CONFIG_HOME`). `wt config plugins opencode uninstall` removes it.
### Gemini CLI
-{{ terminal(cmd="gemini extensions install https://github.com/max-sixty/worktrunk") }}
+```bash
+gemini extensions install https://github.com/max-sixty/worktrunk
+```
Gemini loads the extension natively from the repository, so there is no `wt` wrapper. `gemini extensions uninstall worktrunk` removes it.
@@ -67,16 +77,16 @@ The Claude Code, Codex, OpenCode, and Gemini plugins track agent sessions with s
<!-- ⚠️ AUTO-GENERATED from tests/snapshots/integration__integration_tests__list__list_with_user_marker.snap — edit source to update -->
-{% terminal(cmd="wt list") %}
-<span class="cmd">wt list</span>
- <b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Remote⇅</b> <b>Path</b> <b>Commit</b> <b>Age</b> <b>Message</b>
-@ main <span class=d>^</span><span class=d>⇡</span> <span class=g>⇡1</span> . <span class=d>33323bc</span> <span class=d>1d</span> <span class=d>Initial commit</span>
-+ feature-api <span class=d>↑</span> 🤖 <span class=g>↑1</span> <span class=g>+1</span> ../repo.feature-api <span class=d>70343f0</span> <span class=d>1d</span> <span class=d>Add REST API endpoints</span>
-+ review-ui <span class=c>?</span> <span class=d>↑</span> 💬 <span class=g>↑1</span> <span class=g>+1</span> ../repo.review-ui <span class=d>a585d6e</span> <span class=d>1d</span> <span class=d>Add dashboard component</span>
-+ wip-docs <span class=c>?</span> <span class=d>–</span> ../repo.wip-docs <span class=d>33323bc</span> <span class=d>1d</span> <span class=d>Initial commit</span>
+```console
+$ wt list
+ Branch Status HEAD± main↕ main…± Remote⇅ Path Commit Age Message
+@ main ^⇡ ⇡1 . 33323bc 1d Initial commit
++ feature-api ↑ 🤖 ↑1 +1 ../repo.feature-api 70343f0 1d Add REST API endpoints
++ review-ui ? ↑ 💬 ↑1 +1 ../repo.review-ui a585d6e 1d Add dashboard component
++ wip-docs ? – ../repo.wip-docs 33323bc 1d Initial commit
-<span class=d>○</span> <span class=d>Showing 4 worktrees, 2 with changes, 2 ahead</span>
-{% end %}
+○ Showing 4 worktrees, 2 with changes, 2 ahead
+```
<!-- END AUTO-GENERATED -->
@@ -89,11 +99,11 @@ All four plugins clear the marker when a session ends. A stale marker can remain
Set status markers manually for any workflow:
-{% terminal() %}
-<span class="cmd">wt config state marker set "🚧" # Current branch</span>
-<span class="cmd">wt config state marker set "✅" --branch feature # Specific branch</span>
-<span class="cmd">git config worktrunk.state.feature.marker '{"marker":"💬","set_at":0}' # Direct</span>
-{% end %}
+```console
+$ wt config state marker set "🚧" # Current branch
+$ wt config state marker set "✅" --branch feature # Specific branch
+$ git config worktrunk.state.feature.marker '{"marker":"💬","set_at":0}' # Direct
+```
### Agent CLIs without a plugin
@@ -125,7 +135,7 @@ Claude Code agents can run in isolated worktrees (`isolation: "worktree"`). By d
<code>~/w/myproject.feature-auth !🤖 @<span style='color:#0a0'>+42</span> <span style='color:#a00'>-8</span> <span style='color:#0a0'>↑3</span> <span style='color:#0a0'>⇡1</span> <span style='color:#0a0'>#3035</span> Opus 🌔 65% <span style='color:#a70'>1.4×(10am–3pm)</span></code>
-Worktree state comes from the same cells [`wt list`](@/list.md) renders; Claude Code's stdin JSON adds the model, the `🌔 65%` context gauge, and the rate-limit pace notice. [`wt list statusline`](@/list.md#wt-list-statusline) documents every segment, how the links behave, and the JSON fields behind them.
+Worktree state comes from the same cells [`wt list`](/list/) renders; Claude Code's stdin JSON adds the model, the `🌔 65%` context gauge, and the rate-limit pace notice. [`wt list statusline`](/list/#wt-list-statusline) documents every segment, how the links behave, and the JSON fields behind them.
<figure class="demo">
<picture>
diff --git a/docs/content/code-signing.md b/docs/src/content/docs/code-signing.md
similarity index 88%
rename from docs/content/code-signing.md
rename to docs/src/content/docs/code-signing.md
index d3f5eca11..e31e10a8b 100644
--- a/docs/content/code-signing.md
+++ b/docs/src/content/docs/code-signing.md
@@ -1,15 +1,10 @@
-+++
-title = "Code Signing Policy"
-description = "How Worktrunk's Windows release binaries are code-signed: certificate provenance, the build and signing pipeline, project roles, and per-release approval."
-weight = 26
-
-[extra]
-group = "Reference"
-# Linked from the install section rather than the sidebar: the page exists to
-# satisfy SignPath Foundation's transparency requirement, not to be browsed.
-hide_from_nav = true
-+++
-
+---
+title: "Code Signing Policy"
+description: "How Worktrunk's Windows release binaries are code-signed: certificate provenance, the build and signing pipeline, project roles, and per-release approval."
+sidebar:
+ order: 26
+ hidden: true
+---
This page is Worktrunk's **code signing policy**. It describes what gets signed, which certificate is used, how the signing pipeline works, and who authorizes each release. It exists both to document the process for users and to satisfy the transparency requirements of the [SignPath Foundation](https://signpath.org/) open-source code signing program.
## Why signing matters
@@ -55,7 +50,7 @@ Every signing request requires **manual approval** by an Approver before the cer
## Privacy
-Worktrunk is a local-first command-line tool. It performs no telemetry, collects no analytics, and transmits no user data. Network access happens only when a command the user ran needs it (for example, fetching CI status for `wt list --full`); the [FAQ](@/faq.md) and inline documentation describe exactly when. The signed binaries add no data collection of any kind.
+Worktrunk is a local-first command-line tool. It performs no telemetry, collects no analytics, and transmits no user data. Network access happens only when a command the user ran needs it (for example, fetching CI status for `wt list --full`); the [FAQ](/faq/) and inline documentation describe exactly when. The signed binaries add no data collection of any kind.
## Reporting a problem
diff --git a/docs/content/config.md b/docs/src/content/docs/config.md
similarity index 67%
rename from docs/content/config.md
rename to docs/src/content/docs/config.md
index bc89bd56f..c8ea38eb4 100644
--- a/docs/content/config.md
+++ b/docs/src/content/docs/config.md
@@ -1,12 +1,9 @@
-+++
-title = "wt config"
-description = "Manage user & project configs. Includes shell integration, hooks, and saved state."
-weight = 15
-
-[extra]
-group = "Commands"
-+++
-
+---
+title: "wt config"
+description: "Manage user & project configs. Includes shell integration, hooks, and saved state."
+sidebar:
+ order: 15
+---
<!-- ⚠️ AUTO-GENERATED from `wt config --help-page` — edit src/cli/mod.rs to update -->
Manage user & project configs. Includes shell integration, hooks, and saved state.
@@ -15,19 +12,27 @@ Manage user & project configs. Includes shell integration, hooks, and saved stat
Install shell integration (required for directory switching):
-{{ terminal(cmd="wt config shell install") }}
+```console
+$ wt config shell install
+```
Create user config file with documented examples:
-{{ terminal(cmd="wt config create") }}
+```console
+$ wt config create
+```
Create project config file (`.config/wt.toml`) for hooks:
-{{ terminal(cmd="wt config create --project") }}
+```console
+$ wt config create --project
+```
Show current configuration and file locations:
-{{ terminal(cmd="wt config show") }}
+```console
+$ wt config show
+```
## Configuration files
@@ -84,7 +89,7 @@ Controls where new worktrees are created.
- `{{ branch | sanitize_db }}` — database-safe: lowercase, underscores, hash suffix (e.g., `feature_auth_x7k`)
- `{{ branch | codename(2) }}` — deterministic friendly name from a ~1.26M-combo pool (e.g., `malleable-opah`)
-This is a smaller set than [the variables hooks and aliases get](@/hook.md#template-variables).
+This is a smaller set than [the variables hooks and aliases get](/hook/#template-variables).
**Examples** for repo at `~/code/myproject`, branch `feature/auth`:
@@ -171,7 +176,7 @@ command = "llm -m claude-haiku-4.5"
command = "aichat -m claude:claude-haiku-4.5"
```
-See [LLM commits docs](@/llm-commits.md) for setup and [Custom prompt templates](#custom-prompt-templates) for template customization.
+See [LLM commits docs](/llm-commits/) for setup and [Custom prompt templates](#custom-prompt-templates) for template customization.
## Command config
@@ -197,7 +202,7 @@ timeout-ms = 0 # Wall-clock budget for the entire collect phase; 0 disables
`columns` selects and orders the columns the `wt list` table and the `wt switch`
picker render; `--format json` ignores it and always emits every field. Omit it
for the default set. It is meant to drive a per-invocation
-[alias](@/extending.md#aliases) (`wt --config-set 'list.columns=[…]' list`),
+[alias](/extending/#aliases) (`wt --config-set 'list.columns=[…]' list`),
giving a named view without disturbing the default `wt list`. A static setting
works but pins one layout over a table that otherwise adapts to `--full` and
terminal width.
@@ -251,7 +256,7 @@ Templates may reference `{{ branch }}`, `{{ worktree_path }}`,
namespaces:
- `{{ vars.* }}` — values stored with
- [`wt config state vars set`](@/config.md#wt-config-state-vars).
+ [`wt config state vars set`](/config/#wt-config-state-vars).
- `{{ git.branch.* }}` — the branch's own git config under `branch.<name>.*`,
read straight from `git config` (e.g. `{{ git.branch.jira }}` for a key you
set yourself, or the git-native `description`). Git lowercases config variable
@@ -322,11 +327,11 @@ pager = "delta --paging=never" # Example: override git's core.pager for diff p
exclude = [] # Additional excludes (e.g., [".cache/", ".turbo/"])
```
-Built-in excludes (VCS metadata and tool-state directories) always apply; [the `wt step copy-ignored` docs](@/step.md#wt-step-copy-ignored) list them. User config and project config exclusions are combined.
+Built-in excludes (VCS metadata and tool-state directories) always apply; [the `wt step copy-ignored` docs](/step/#wt-step-copy-ignored) list them. User config and project config exclusions are combined.
### Aliases
-Command templates that run as `wt <name>`. See the [Extending Worktrunk guide](@/extending.md#aliases) for usage and flags.
+Command templates that run as `wt <name>`. See the [Extending Worktrunk guide](/extending/#aliases) for usage and flags.
```toml
[aliases]
@@ -334,15 +339,15 @@ greet = "echo Hello from {{ branch }}"
url = "echo http://localhost:{{ branch | hash_port }}"
```
-Aliases defined here apply to all projects. For project-specific aliases, use the [project config](@/config.md#project-configuration) `[aliases]` section instead.
+Aliases defined here apply to all projects. For project-specific aliases, use the [project config](/config/#project-configuration) `[aliases]` section instead.
### User project-specific settings
-User config can include a `[projects]` table for project-specific settings — worktree layout, setting overrides, anything else — separate from the [project config](@/config.md#project-configuration) shared with teammates.
+User config can include a `[projects]` table for project-specific settings — worktree layout, setting overrides, anything else — separate from the [project config](/config/#project-configuration) shared with teammates.
Entries are keyed by project identifier — `<host>/<owner>/<repo>` derived from the primary remote URL (no `.git` suffix), or the canonical repo path when there is no remote. Run `wt config show` inside the repo to see the identifier for the current project; it appears in the `PROJECT CONFIG` section as `Identifier: …`.
-Scalar values (like `worktree-path`) replace the global value; everything else (hooks, aliases, etc.) appends, global first. See [how the layers rank](@/config.md#precedence).
+Scalar values (like `worktree-path`) replace the global value; everything else (hooks, aliases, etc.) appends, global first. See [how the layers rank](/config/#precedence).
```toml
[projects."github.com/user/repo"]
@@ -375,7 +380,7 @@ Every matching entry applies, least- to most-specific, following the rule above:
#### Forge platform and hostname
-`forge` names the forge for the matched repositories — the user-level counterpart of the project config's [forge platform](@/config.md#forge-platform) block, for a self-hosted host whose name carries no `github`, `gitlab`, or `gitea` for detection to read.
+`forge` names the forge for the matched repositories — the user-level counterpart of the project config's [forge platform](/config/#forge-platform) block, for a self-hosted host whose name carries no `github`, `gitlab`, or `gitea` for detection to read.
```toml
[projects."git.company.example/*"]
@@ -385,7 +390,7 @@ forge.hostname = "api.git.company.example" # API host, when the remote's own h
Both fields describe the host rather than the repository, which is why a pattern keyed to a hostname suits them, and why an SSH alias resolved through `~/.ssh/config` — where the name in the remote URL is local to one machine — belongs here rather than in a repository's committed config. A repository's own `[forge]` block still wins over any entry here, field by field: a repository that sets only `platform` still takes a matching entry's `hostname`.
-Hooks support all three [hook forms](@/hook.md#hook-forms). A table runs multiple commands concurrently; an array-of-tables pipeline runs steps in sequence. The dotted-key examples below are equivalent to the table forms — TOML treats `projects."github.com/user/repo".post-start.server = "..."` and a `[projects."github.com/user/repo".post-start]` table the same way:
+Hooks support all three [hook forms](/hook/#hook-forms). A table runs multiple commands concurrently; an array-of-tables pipeline runs steps in sequence. The dotted-key examples below are equivalent to the table forms — TOML treats `projects."github.com/user/repo".post-start.server = "..."` and a `[projects."github.com/user/repo".post-start]` table the same way:
```toml
# Single command
@@ -417,7 +422,7 @@ Available variables:
- `{{ git_diff }}`, `{{ git_diff_stat }}` — diff content
- `{{ branch }}`, `{{ repo }}` — context
- `{{ recent_commits }}` — recent commit messages
-- `{{ user_guidance }}`, `{{ project_guidance }}` — rendered append fragments (see [Appending to the prompt](@/config.md#appending-to-the-prompt))
+- `{{ user_guidance }}`, `{{ project_guidance }}` — rendered append fragments (see [Appending to the prompt](/config/#appending-to-the-prompt))
Default template:
@@ -530,11 +535,11 @@ template-append = """
"""
```
-How the fragment renders, and the project-config counterpart: [the LLM commits guide](@/llm-commits.md#appending-to-the-prompt).
+How the fragment renders, and the project-config counterpart: [the LLM commits guide](/llm-commits/#appending-to-the-prompt).
## Hooks
-See [`wt hook`](@/hook.md) for hook types, execution order, template variables, and examples. User hooks apply to all projects; [project hooks](@/config.md#project-configuration) apply only to that repository.
+See [`wt hook`](/hook/) for hook types, execution order, template variables, and examples. User hooks apply to all projects; [project hooks](/config/#project-configuration) apply only to that repository.
<!-- USER_CONFIG_END -->
<!-- PROJECT_CONFIG_START -->
# Project Configuration
@@ -545,7 +550,7 @@ To create a starter file with commented-out examples, run `wt config create --pr
## Hooks
-Project hooks apply to this repository only. See [`wt hook`](@/hook.md) for hook types, execution order, and examples.
+Project hooks apply to this repository only. See [`wt hook`](/hook/) for hook types, execution order, and examples.
```toml
pre-start = "npm ci"
@@ -572,7 +577,7 @@ platform = "github" # or "gitlab", "gitea" (experimental), "azure-devops" (expe
hostname = "github.example.com" # Example: API host (GHE / self-hosted GitLab)
```
-When many repositories share one self-hosted host, name it once in user config with a [pattern-keyed `[projects]` entry](@/config.md#user-project-specific-settings) instead of repeating this block in each repo. A repository's own `[forge]` still wins, field by field.
+When many repositories share one self-hosted host, name it once in user config with a [pattern-keyed `[projects]` entry](/config/#user-project-specific-settings) instead of repeating this block in each repo. A repository's own `[forge]` still wins, field by field.
## Commit-message append
@@ -588,7 +593,7 @@ template-append = """
"""
```
-The first time the fragment is used (and whenever it changes), `wt` prompts the user to approve it — the same one-shot gate as project-defined hooks. Only `template-append` is honored from the project file; the LLM command and the main prompt template stay in [user config](@/config.md), since they describe per-developer environment (which CLI is installed, which agent the developer prefers). How the fragment renders: [the LLM commits guide](@/llm-commits.md#appending-to-the-prompt).
+The first time the fragment is used (and whenever it changes), `wt` prompts the user to approve it — the same one-shot gate as project-defined hooks. Only `template-append` is honored from the project file; the LLM command and the main prompt template stay in [user config](/config/), since they describe per-developer environment (which CLI is installed, which agent the developer prefers). How the fragment renders: [the LLM commits guide](/llm-commits/#appending-to-the-prompt).
## Copy-ignored excludes
@@ -599,11 +604,11 @@ Additional excludes for `wt step copy-ignored`:
exclude = [".cache/", ".turbo/"]
```
-Built-in excludes (VCS metadata and tool-state directories) always apply; [the `wt step copy-ignored` docs](@/step.md#wt-step-copy-ignored) list them. User config and project config exclusions are combined.
+Built-in excludes (VCS metadata and tool-state directories) always apply; [the `wt step copy-ignored` docs](/step/#wt-step-copy-ignored) list them. User config and project config exclusions are combined.
## Aliases
-Command templates that run as `wt <name>`. See the [Extending Worktrunk guide](@/extending.md#aliases) for usage and flags.
+Command templates that run as `wt <name>`. See the [Extending Worktrunk guide](/extending/#aliases) for usage and flags.
```toml
[aliases]
@@ -611,14 +616,16 @@ deploy = "make deploy BRANCH={{ branch }}"
url = "echo http://localhost:{{ branch | hash_port }}"
```
-Aliases defined here are shared with teammates. For personal aliases, use the [user config](@/config.md#aliases) `[aliases]` section instead.
+Aliases defined here are shared with teammates. For personal aliases, use the [user config](/config/#aliases) `[aliases]` section instead.
<!-- PROJECT_CONFIG_END -->
# Shell Integration
Worktrunk needs shell integration to change directories when switching worktrees. Install with:
-{{ terminal(cmd="wt config shell install") }}
+```console
+$ wt config shell install
+```
For manual setup, see `wt config shell init --help`.
@@ -650,7 +657,9 @@ For nested config sections, use double underscores to separate levels:
Override the LLM command in CI to use a mock:
-{{ terminal(cmd="WORKTRUNK_COMMIT__GENERATION__COMMAND=__WT_QUOT__echo 'test: automated commit'__WT_QUOT__ wt merge") }}
+```console
+$ WORKTRUNK_COMMIT__GENERATION__COMMAND="echo 'test: automated commit'" wt merge
+```
### Other environment variables
@@ -676,13 +685,16 @@ Override the LLM command in CI to use a mock:
`--config-set <toml>` overrides any user config key for a single invocation. The value is a TOML fragment, so arrays and tables work directly; the flag is global (works before or after the subcommand), repeatable, and a later `--config-set` replaces an earlier one for the same key.
-{{ terminal(cmd="wt --config-set list.full=true list|||wt step copy-ignored --config-set 'step.copy-ignored.exclude=[__WT_QUOT__target__WT_QUOT__, __WT_QUOT__dist__WT_QUOT__]'") }}
+```console
+$ wt --config-set list.full=true list
+$ wt step copy-ignored --config-set 'step.copy-ignored.exclude=["target", "dist"]'
+```
This composes with aliases — an alias body can invoke `wt --config-set … <command>` to render a named view without changing the saved config.
## Precedence
-Sources closer to the invocation rank higher (user config above system config), and within a config file a [project entry](@/config.md#user-project-specific-settings) outranks the global key of the same name. So `worktree-path` comes from the first of these that sets it:
+Sources closer to the invocation rank higher (user config above system config), and within a config file a [project entry](/config/#user-project-specific-settings) outranks the global key of the same name. So `worktree-path` comes from the first of these that sets it:
1. `--config-set 'worktree-path = …'`
2. `WORKTRUNK_WORKTREE_PATH`
@@ -691,51 +703,53 @@ Sources closer to the invocation rank higher (user config above system config),
A `--config-set` that names a project entry is both the highest layer and the most specific key, so it beats the same flag's global key:
-{{ terminal(cmd="wt --config-set 'projects.__WT_QUOT__github.com/owner/repo__WT_QUOT__.worktree-path = __WT_QUOT__/tmp/scratch__WT_QUOT__' switch --create feature") }}
+```console
+$ wt --config-set 'projects."github.com/owner/repo".worktree-path = "/tmp/scratch"' switch --create feature
+```
Hooks, aliases and `step.copy-ignored.exclude` accumulate rather than replace, so an env-set hook and a project's hook both run.
## Command reference
-{% terminal() %}
-wt config - Manage user &amp; project configs
+```
+wt config - Manage user & project configs
Includes shell integration, hooks, and saved state.
-Usage: <b><span class=c>wt config</span></b> <span class=c>[OPTIONS]</span> <span class=c>&lt;COMMAND&gt;</span>
+Usage: wt config [OPTIONS] <COMMAND>
-<b><span class=g>Commands:</span></b>
- <b><span class=c>shell</span></b> Shell integration setup
- <b><span class=c>create</span></b> Create configuration file
- <b><span class=c>show</span></b> Show configuration files &amp; locations
- <b><span class=c>update</span></b> Update deprecated config settings
- <b><span class=c>approvals</span></b> Manage command approvals
- <b><span class=c>alias</span></b> Inspect and preview aliases
- <b><span class=c>plugins</span></b> Plugin management
- <b><span class=c>state</span></b> Manage internal data and cache
+Commands:
+ shell Shell integration setup
+ create Create configuration file
+ show Show configuration files & locations
+ update Update deprecated config settings
+ approvals Manage command approvals
+ alias Inspect and preview aliases
+ plugins Plugin management
+ state Manage internal data and cache
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
# Subcommands
@@ -752,7 +766,9 @@ If a config file doesn't exist, shows defaults that would be used.
Use `--full` to run diagnostic checks:
-{{ terminal(cmd="wt config show --full") }}
+```console
+$ wt config show --full
+```
This tests:
- **CI tool status** — Whether `gh` (GitHub) or `glab` (GitLab) is installed and authenticated
@@ -761,43 +777,43 @@ This tests:
### Command reference
-{% terminal() %}
-wt config show - Show configuration files &amp; locations
+```
+wt config show - Show configuration files & locations
-Usage: <b><span class=c>wt config show</span></b> <span class=c>[OPTIONS]</span>
+Usage: wt config show [OPTIONS]
-<b><span class=g>Options:</span></b>
- <b><span class=c>--full</span></b>
+Options:
+ --full
Run diagnostic checks (CI tools, commit generation, version)
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Output:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Output:
+ --format <FORMAT>
Output format
[default: text]
[possible values: text, json]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt config approvals
@@ -808,25 +824,39 @@ Project hooks and project aliases prompt for approval on first run to prevent un
### Examples
List commands and their approval status for current project:
-{{ terminal(cmd="wt config approvals list") }}
+```console
+$ wt config approvals list
+```
Pre-approve all hook and alias commands for current project:
-{{ terminal(cmd="wt config approvals add") }}
+```console
+$ wt config approvals add
+```
Pre-approve without prompting, for a container or CI job:
-{{ terminal(cmd="wt config approvals add --yes") }}
+```console
+$ wt config approvals add --yes
+```
Clear approvals for current project:
-{{ terminal(cmd="wt config approvals clear") }}
+```console
+$ wt config approvals clear
+```
Clear only approvals for commands no longer in the project config:
-{{ terminal(cmd="wt config approvals clear --stale") }}
+```console
+$ wt config approvals clear --stale
+```
Clear global approvals:
-{{ terminal(cmd="wt config approvals clear --global") }}
+```console
+$ wt config approvals clear --global
+```
Check whether an unattended run would stop for approval:
-{{ terminal(cmd="wt config approvals list --format=json | jq -r .state") }}
+```console
+$ wt config approvals list --format=json | jq -r .state
+```
### How approvals work
@@ -855,89 +885,96 @@ Approved commands are saved to `~/.config/worktrunk/approvals.toml`. Re-approval
### Command reference
-{% terminal() %}
+```
wt config approvals - Manage command approvals
-Usage: <b><span class=c>wt config approvals</span></b> <span class=c>[OPTIONS]</span> <span class=c>&lt;COMMAND&gt;</span>
+Usage: wt config approvals [OPTIONS] <COMMAND>
-<b><span class=g>Commands:</span></b>
- <b><span class=c>list</span></b> List project commands and their approval status
- <b><span class=c>add</span></b> Store approvals in approvals.toml
- <b><span class=c>clear</span></b> Clear approved commands from approvals.toml
+Commands:
+ list List project commands and their approval status
+ add Store approvals in approvals.toml
+ clear Clear approved commands from approvals.toml
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt config alias
Inspect and preview aliases.
-Aliases are command templates configured in user (`~/.config/worktrunk/config.toml`) or project (`.config/wt.toml`) config and run as `wt <name>`. See the [Extending Worktrunk guide](@/extending.md#aliases) for the configuration format.
+Aliases are command templates configured in user (`~/.config/worktrunk/config.toml`) or project (`.config/wt.toml`) config and run as `wt <name>`. See the [Extending Worktrunk guide](/extending/#aliases) for the configuration format.
### Examples
Show every configured alias's template:
-{{ terminal(cmd="wt config alias show") }}
+```console
+$ wt config alias show
+```
Show the template for `deploy`:
-{{ terminal(cmd="wt config alias show deploy") }}
+```console
+$ wt config alias show deploy
+```
Preview an invocation without running it:
-{{ terminal(cmd="wt config alias dry-run deploy|||wt config alias dry-run deploy -- --env=staging") }}
+```console
+$ wt config alias dry-run deploy
+$ wt config alias dry-run deploy -- --env=staging
+```
### Command reference
-{% terminal() %}
+```
wt config alias - Inspect and preview aliases
-Usage: <b><span class=c>wt config alias</span></b> <span class=c>[OPTIONS]</span> <span class=c>&lt;COMMAND&gt;</span>
+Usage: wt config alias [OPTIONS] <COMMAND>
-<b><span class=g>Commands:</span></b>
- <b><span class=c>show</span></b> Show an alias&#39;s template, or all aliases&#39; templates
- <b><span class=c>dry-run</span></b> Preview an alias invocation with template expansion
+Commands:
+ show Show an alias's template, or all aliases' templates
+ dry-run Preview an alias invocation with template expansion
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt config state
@@ -947,73 +984,87 @@ State is stored in `.git/` (config entries and log files), separate from configu
### Keys
-- **cache**: [Regenerable caches — CI status, summaries, git commands, hints, and the `wt switch -` target](@/config.md#wt-config-state-cache)
-- **default-branch**: [The repository's default branch (`main`, `master`, etc.)](@/config.md#wt-config-state-default-branch)
-- **marker**: [Custom status marker for a branch (shown in `wt list`)](@/config.md#wt-config-state-marker)
-- **vars**: <span class="badge-experimental"></span> [Custom variables per branch](@/config.md#wt-config-state-vars)
-- **logs**: [Operation and debug logs](@/config.md#wt-config-state-logs)
+- **cache**: [Regenerable caches — CI status, summaries, git commands, hints, and the `wt switch -` target](/config/#wt-config-state-cache)
+- **default-branch**: [The repository's default branch (`main`, `master`, etc.)](/config/#wt-config-state-default-branch)
+- **marker**: [Custom status marker for a branch (shown in `wt list`)](/config/#wt-config-state-marker)
+- **vars**: <span class="badge-experimental"></span> [Custom variables per branch](/config/#wt-config-state-vars)
+- **logs**: [Operation and debug logs](/config/#wt-config-state-logs)
### Examples
Get the default branch:
-{{ terminal(cmd="wt config state default-branch") }}
+```console
+$ wt config state default-branch
+```
Set the default branch manually:
-{{ terminal(cmd="wt config state default-branch set main") }}
+```console
+$ wt config state default-branch set main
+```
Set a marker for current branch:
-{{ terminal(cmd="wt config state marker set 🚧") }}
+```console
+$ wt config state marker set 🚧
+```
Store arbitrary data:
-{{ terminal(cmd="wt config state vars set env=staging") }}
+```console
+$ wt config state vars set env=staging
+```
Drop the regenerable caches:
-{{ terminal(cmd="wt config state cache clear") }}
+```console
+$ wt config state cache clear
+```
Show all stored state:
-{{ terminal(cmd="wt config state get") }}
+```console
+$ wt config state get
+```
Clear all stored state:
-{{ terminal(cmd="wt config state clear") }}
+```console
+$ wt config state clear
+```
### Command reference
-{% terminal() %}
+```
wt config state - Manage internal data and cache
-Usage: <b><span class=c>wt config state</span></b> <span class=c>[OPTIONS]</span> <span class=c>&lt;COMMAND&gt;</span>
+Usage: wt config state [OPTIONS] <COMMAND>
-<b><span class=g>Commands:</span></b>
- <b><span class=c>get</span></b> Get all stored state
- <b><span class=c>clear</span></b> Clear all stored state
- <b><span class=c>cache</span></b> Regenerable caches
- <b><span class=c>default-branch</span></b> Default branch detection and override
- <b><span class=c>logs</span></b> Operation and debug logs
- <b><span class=c>marker</span></b> Branch markers
- <b><span class=c>vars</span></b> [experimental] Custom variables per branch
+Commands:
+ get Get all stored state
+ clear Clear all stored state
+ cache Regenerable caches
+ default-branch Default branch detection and override
+ logs Operation and debug logs
+ marker Branch markers
+ vars [experimental] Custom variables per branch
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt config state cache
@@ -1023,7 +1074,7 @@ View or drop worktrunk's regenerable caches in one place. Everything here is reb
### What's cached
-- **CI status** — GitHub/GitLab CI per branch (30–60s TTL), shown in [`wt list`](@/list.md#ci-status), plus the largest PR/MR number seen (sizes the CI column)
+- **CI status** — GitHub/GitLab CI per branch (30–60s TTL), shown in [`wt list`](/list/#ci-status), plus the largest PR/MR number seen (sizes the CI column)
- **Summaries** — LLM-generated branch summaries (`wt list --full`, `wt switch` preview)
- **Git commands** — cached merge-tree, ancestry, diff-stat, and `wt switch` preview results
- **Hints** — one-time hints already shown in this repo
@@ -1036,48 +1087,52 @@ Without a subcommand, runs `get`.
### Examples
Show cache contents:
-{{ terminal(cmd="wt config state cache") }}
+```console
+$ wt config state cache
+```
Drop all caches:
-{{ terminal(cmd="wt config state cache clear") }}
+```console
+$ wt config state cache clear
+```
### Command reference
-{% terminal() %}
+```
wt config state cache - Regenerable caches
-Usage: <b><span class=c>wt config state cache</span></b> <span class=c>[OPTIONS]</span> <span class=c>[COMMAND]</span>
+Usage: wt config state cache [OPTIONS] [COMMAND]
-<b><span class=g>Commands:</span></b>
- <b><span class=c>get</span></b> Show cache contents
- <b><span class=c>clear</span></b> Drop all caches
+Commands:
+ get Show cache contents
+ clear Drop all caches
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Output:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Output:
+ --format <FORMAT>
Output format (text, json) [default: text]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt config state default-branch
@@ -1085,9 +1140,11 @@ Default branch detection and override.
Useful in scripts to avoid hardcoding `main` or `master`:
-{{ terminal(cmd="git rebase $(wt config state default-branch)") }}
+```console
+$ git rebase $(wt config state default-branch)
+```
-In a hook or alias template, prefer the `{{ default_branch }}` [template variable](@/hook.md#template-variables); `$(wt config state default-branch)` is for plain shell scripts.
+In a hook or alias template, prefer the `{{ default_branch }}` [template variable](/hook/#template-variables); `$(wt config state default-branch)` is for plain shell scripts.
Without a subcommand, runs `get`. Use `set` to override, or `clear` then `get` to re-detect.
@@ -1116,38 +1173,38 @@ If none of these match, detection fails; set it explicitly with `wt config state
### Command reference
-{% terminal() %}
+```
wt config state default-branch - Default branch detection and override
-Usage: <b><span class=c>wt config state default-branch</span></b> <span class=c>[OPTIONS]</span> <span class=c>[COMMAND]</span>
+Usage: wt config state default-branch [OPTIONS] [COMMAND]
-<b><span class=g>Commands:</span></b>
- <b><span class=c>get</span></b> Get the default branch
- <b><span class=c>set</span></b> Set the default branch
- <b><span class=c>clear</span></b> Clear the default branch cache
+Commands:
+ get Get the default branch
+ set Set the default branch
+ clear Clear the default branch cache
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt config state logs
@@ -1207,106 +1264,116 @@ All logs are stored in `.git/wt/logs/` (in the main worktree's git directory). A
### Examples
List all log files:
-{{ terminal(cmd="wt config state logs") }}
+```console
+$ wt config state logs
+```
Query the command log:
-{{ terminal(cmd="tail -5 .git/wt/logs/commands.jsonl | jq .") }}
+```console
+$ tail -5 .git/wt/logs/commands.jsonl | jq .
+```
Path to one hook log (e.g. the `post-start` `server` hook for the current branch):
-{{ terminal(cmd="wt config state logs --format=json | jq -r '.hook_output[] | select(.source == __WT_QUOT__user__WT_QUOT__ and .hook_type == __WT_QUOT__post-start__WT_QUOT__ and (.name | startswith(__WT_QUOT__server__WT_QUOT__))) | .path'") }}
+```console
+$ wt config state logs --format=json | jq -r '.hook_output[] | select(.source == "user" and .hook_type == "post-start" and (.name | startswith("server"))) | .path'
+```
Logs for a specific branch:
-{{ terminal(cmd="wt config state logs --format=json | jq '.hook_output[] | select(.branch | startswith(__WT_QUOT__feature__WT_QUOT__))'") }}
+```console
+$ wt config state logs --format=json | jq '.hook_output[] | select(.branch | startswith("feature"))'
+```
Clear all logs:
-{{ terminal(cmd="wt config state logs clear") }}
+```console
+$ wt config state logs clear
+```
### Command reference
-{% terminal() %}
+```
wt config state logs - Operation and debug logs
-Usage: <b><span class=c>wt config state logs</span></b> <span class=c>[OPTIONS]</span> <span class=c>[COMMAND]</span>
+Usage: wt config state logs [OPTIONS] [COMMAND]
-<b><span class=g>Commands:</span></b>
- <b><span class=c>get</span></b> List all log file paths
- <b><span class=c>profile</span></b> Performance profile from a trace
- <b><span class=c>clear</span></b> Clear all log files
+Commands:
+ get List all log file paths
+ profile Performance profile from a trace
+ clear Clear all log files
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Output:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Output:
+ --format <FORMAT>
Output format (text, json) [default: text]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt config state ci-status
CI status cache.
-**Deprecated** — the CI status cache is now part of [`wt config state cache`](@/config.md#wt-config-state-cache). This subcommand still works but prints a deprecation notice.
+**Deprecated** — the CI status cache is now part of [`wt config state cache`](/config/#wt-config-state-cache). This subcommand still works but prints a deprecation notice.
-Status values, display symbols, and fetch behavior: [`wt list` CI status](@/list.md#ci-status).
+Status values, display symbols, and fetch behavior: [`wt list` CI status](/list/#ci-status).
Without a subcommand, runs `get` for the current branch. Use `clear` to reset cache for a branch or `clear --all` to reset all.
### Command reference
-{% terminal() %}
+```
wt config state ci-status - CI status cache
-Usage: <b><span class=c>wt config state ci-status</span></b> <span class=c>[OPTIONS]</span> <span class=c>[COMMAND]</span>
+Usage: wt config state ci-status [OPTIONS] [COMMAND]
-<b><span class=g>Commands:</span></b>
- <b><span class=c>get</span></b> Get CI status for a branch
- <b><span class=c>clear</span></b> Clear CI status cache
+Commands:
+ get Get CI status for a branch
+ clear Clear CI status cache
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Output:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Output:
+ --format <FORMAT>
Output format (text, json) [default: text]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt config state marker
@@ -1318,68 +1385,71 @@ Custom status text or emoji shown in the `wt list` Status column.
Markers appear at the end of the Status column, after git symbols:
-{% terminal(cmd="wt list") %}
-&#32;&#32;<b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Remote⇅</b> <b>Commit</b> <b>Age</b> <b>Message</b>
-@ main <span class=d>^</span><span class=d>⇡</span> <span class=g>⇡1</span> <span class=d>33323bc</span> <span class=d>1d</span> <span class=d>Initial commit</span>
-+ feature-api <span class=d>↑</span> 🤖 <span class=g>↑1</span> <span class=g>+1</span> <span class=d>70343f0</span> <span class=d>1d</span> <span class=d>Add REST API endp…</span>
-+ review-ui <span class=c>?</span> <span class=d>↑</span> 💬 <span class=g>↑1</span> <span class=g>+1</span> <span class=d>a585d6e</span> <span class=d>1d</span> <span class=d>Add dashboard com…</span>
-+ wip-docs <span class=c>?</span> <span class=d>–</span> <span class=d>33323bc</span> <span class=d>1d</span> <span class=d>Initial commit</span>
+```console
+$ wt list
+ Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
+@ main ^⇡ ⇡1 33323bc 1d Initial commit
++ feature-api ↑ 🤖 ↑1 +1 70343f0 1d Add REST API endp…
++ review-ui ? ↑ 💬 ↑1 +1 a585d6e 1d Add dashboard com…
++ wip-docs ? – 33323bc 1d Initial commit
-<span class=d>○</span> <span class=d>Showing 4 worktrees, 2 with changes, 2 ahead, 1 column hidden</span>
-{% end %}
+○ Showing 4 worktrees, 2 with changes, 2 ahead, 1 column hidden
+```
### Use cases
- **Work status** — `🚧` WIP, `✅` ready for review, `🔥` urgent
-- **Agent tracking** — The [Claude Code](@/claude-code.md) plugin sets markers automatically
+- **Agent tracking** — The [Claude Code](/claude-code/) plugin sets markers automatically
- **Notes** — Any short text: `"blocked"`, `"needs tests"`
### Storage
Stored in git config as `worktrunk.state.<branch>.marker`. Set directly with:
-{{ terminal(cmd="git config worktrunk.state.feature.marker '{__WT_QUOT__marker__WT_QUOT__:__WT_QUOT__🚧__WT_QUOT__,__WT_QUOT__set_at__WT_QUOT__:0}'") }}
+```console
+$ git config worktrunk.state.feature.marker '{"marker":"🚧","set_at":0}'
+```
Without a subcommand, runs `get` for the current branch. For `--branch`, use `get --branch=NAME`.
### Command reference
-{% terminal() %}
+```
wt config state marker - Branch markers
-Usage: <b><span class=c>wt config state marker</span></b> <span class=c>[OPTIONS]</span> <span class=c>[COMMAND]</span>
+Usage: wt config state marker [OPTIONS] [COMMAND]
-<b><span class=g>Commands:</span></b>
- <b><span class=c>get</span></b> Get marker for a branch
- <b><span class=c>set</span></b> Set marker for a branch
- <b><span class=c>clear</span></b> Clear marker for a branch
+Commands:
+ get Get marker for a branch
+ set Set marker for a branch
+ clear Clear marker for a branch
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Output:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Output:
+ --format <FORMAT>
Output format (text, json) [default: text]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt config state vars
@@ -1392,20 +1462,29 @@ Store custom variables per branch. Values are stored as-is — plain strings or
### Examples
Set and get values:
-{{ terminal(cmd="wt config state vars set env=staging|||wt config state vars get env") }}
+```console
+$ wt config state vars set env=staging
+$ wt config state vars get env
+```
Store JSON:
-{{ terminal(cmd="wt config state vars set config='{__WT_QUOT__port__WT_QUOT__: 3000, __WT_QUOT__debug__WT_QUOT__: true}'") }}
+```console
+$ wt config state vars set config='{"port": 3000, "debug": true}'
+```
List all keys:
-{{ terminal(cmd="wt config state vars list") }}
+```console
+$ wt config state vars list
+```
Operate on a different branch:
-{{ terminal(cmd="wt config state vars set env=production --branch=main") }}
+```console
+$ wt config state vars set env=production --branch=main
+```
### Template access
-Variables are available in [hook templates](@/hook.md#template-variables) as `{{ vars.<key> }}`. Use the `default` filter for keys that may not be set:
+Variables are available in [hook templates](/hook/#template-variables) as `{{ vars.<key> }}`. Use the `default` filter for keys that may not be set:
```toml
[post-start]
@@ -1414,7 +1493,9 @@ dev = "ENV={{ vars.env | default('development') }} npm start -- --port {{ vars.p
JSON object and array values support dot access:
-{{ terminal(cmd="wt config state vars set config='{__WT_QUOT__port__WT_QUOT__: 3000, __WT_QUOT__debug__WT_QUOT__: true}'") }}
+```console
+$ wt config state vars set config='{"port": 3000, "debug": true}'
+```
```toml
[post-start]
dev = "npm start -- --port {{ vars.config.port }}"
@@ -1426,38 +1507,38 @@ Stored in git config as `worktrunk.state.<branch>.vars.<key>`. Keys must contain
### Command reference
-{% terminal() %}
+```
wt config state vars - [experimental] Custom variables per branch
-Usage: <b><span class=c>wt config state vars</span></b> <span class=c>[OPTIONS]</span> <span class=c>&lt;COMMAND&gt;</span>
+Usage: wt config state vars [OPTIONS] <COMMAND>
-<b><span class=g>Commands:</span></b>
- <b><span class=c>get</span></b> Get a value
- <b><span class=c>list</span></b> List all keys
- <b><span class=c>set</span></b> Set a value
- <b><span class=c>clear</span></b> Clear a key or all keys
+Commands:
+ get Get a value
+ list List all keys
+ set Set a value
+ clear Clear a key or all keys
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
<!-- END AUTO-GENERATED -->
diff --git a/docs/content/extending.md b/docs/src/content/docs/extending.md
similarity index 86%
rename from docs/content/extending.md
rename to docs/src/content/docs/extending.md
index c597b61d9..2e384fc06 100644
--- a/docs/content/extending.md
+++ b/docs/src/content/docs/extending.md
@@ -1,12 +1,9 @@
-+++
-title = "Extending Worktrunk"
-description = "Three ways to add custom behavior: hooks for lifecycle automation, aliases for reusable commands, and custom subcommands for standalone tools."
-weight = 21
-
-[extra]
-group = "Reference"
-+++
-
+---
+title: "Extending Worktrunk"
+description: "Three ways to add custom behavior: hooks for lifecycle automation, aliases for reusable commands, and custom subcommands for standalone tools."
+sidebar:
+ order: 21
+---
Worktrunk has three extension mechanisms.
**[Hooks](#hooks)** are shell commands that run automatically at lifecycle events (switching, starting, committing, merging, removing). Defined in TOML.
@@ -23,11 +20,11 @@ Worktrunk has three extension mechanisms.
| **Shareable via repo** | `.config/wt.toml` | `.config/wt.toml` | Distribute the binary |
| **Language** | Shell commands | Shell commands | Any |
-Hooks and aliases live in the same TOML config and share the [template engine](@/hook.md#template-variables). User config is trusted; project config requires approval on first run. When both define the same name, both run (user first).
+Hooks and aliases live in the same TOML config and share the [template engine](/hook/#template-variables). User config is trusted; project config requires approval on first run. When both define the same name, both run (user first).
## Hooks
-Ten hooks cover five lifecycle events — switch, start, commit, merge, remove — each with a blocking `pre-` variant (failure aborts the operation) and a background `post-` variant. [`wt hook`](@/hook.md#hook-types) maps each hook to its timing and typical uses.
+Ten hooks cover five lifecycle events — switch, start, commit, merge, remove — each with a blocking `pre-` variant (failure aborts the operation) and a background `post-` variant. [`wt hook`](/hook/#hook-types) maps each hook to its timing and typical uses.
```toml
[pre-start]
@@ -40,7 +37,7 @@ server = "npm run dev -- --port {{ branch | hash_port }}"
test = "npm test"
```
-See [`wt hook`](@/hook.md) for the full reference and built-in recipes (dev server per worktree, database per worktree, progressive validation). [Tips & Patterns](@/tips-patterns.md) has more.
+See [`wt hook`](/hook/) for the full reference and built-in recipes (dev server per worktree, database per worktree, progressive validation). [Tips & Patterns](/tips-patterns/) has more.
## Aliases
@@ -53,13 +50,16 @@ open = "open http://localhost:{{ branch | hash_port }}"
since-main = "git log --oneline {{ default_branch }}..HEAD"
```
-{{ terminal(cmd="wt deploy --env=staging|||wt open") }}
+```bash
+wt deploy --env=staging
+wt open
+```
`wt <name>` resolves to a built-in first, then an alias, then a [custom subcommand](#custom-subcommands).
### Templates
-Aliases use the same [template engine as hooks](@/hook.md#template-variables): variables, [filters](@/hook.md#worktrunk-filters), [functions](@/hook.md#worktrunk-functions), and [`--KEY=VALUE` smart routing](@/hook.md#passing-values) (bind if the template references `KEY`, else forward to `{{ args }}`). For example, `wt deploy --env=staging` sets `{{ env }}`.
+Aliases use the same [template engine as hooks](/hook/#template-variables): variables, [filters](/hook/#worktrunk-filters), [functions](/hook/#worktrunk-functions), and [`--KEY=VALUE` smart routing](/hook/#passing-values) (bind if the template references `KEY`, else forward to `{{ args }}`). For example, `wt deploy --env=staging` sets `{{ env }}`.
Alias templates add `{{ args }}` for positional CLI arguments. Operation-context variables (`target`, `base`, `pr_number`) aren't auto-populated, but can still be bound with `--KEY=VALUE`.
@@ -72,9 +72,13 @@ Alias templates add `{{ args }}` for positional CLI arguments. Operation-context
s = "wt switch {{ args }}"
```
-{{ terminal(cmd="wt s some-branch|||wt s feature/api|||wt s 'has a space'") }}
+```bash
+wt s some-branch
+wt s feature/api
+wt s 'has a space'
+```
-For indexing (`{{ args[0] }}`), looping, and counting, see [Passing values](@/hook.md#passing-values).
+For indexing (`{{ args[0] }}`), looping, and counting, see [Passing values](/hook/#passing-values).
Tokens after `--` forward unconditionally, bypassing any binding. Writing `wt deploy -- --branch=foo` forwards the literal `--branch=foo` to `{{ args }}` even though the template references `{{ branch }}`.
@@ -85,11 +89,15 @@ An alias that forwards `{{ args }}` to a `wt` command — like `co = "wt switch
- `wt config alias show <name>` prints the template.
- `wt config alias dry-run <name> [-- args...]` prints the rendered command.
-{{ terminal(cmd="wt config alias show deploy|||wt config alias dry-run deploy|||wt config alias dry-run deploy -- --env=staging") }}
+```bash
+wt config alias show deploy
+wt config alias dry-run deploy
+wt config alias dry-run deploy -- --env=staging
+```
### Multi-step pipelines
-`[[aliases.NAME]]` defines a pipeline using the [same `[[block]]` semantics as hooks](@/hook.md#hook-forms): blocks run in order, keys within a block run concurrently, and a step failure aborts the remainder.
+`[[aliases.NAME]]` defines a pipeline using the [same `[[block]]` semantics as hooks](/hook/#hook-forms): blocks run in order, keys within a block run concurrently, and a step failure aborts the remainder.
```toml
[[aliases.release]]
@@ -191,7 +199,10 @@ Run with `wt hook-log --kind=post-start --name=server` to tail the log for the `
Any executable named `wt-<name>` on `PATH` becomes available as `wt <name>`, the same pattern git uses for `git-foo`. Built-in commands and [aliases](#aliases) take precedence.
-{{ terminal(cmd="wt sync origin # runs: wt-sync origin|||wt -C /tmp/repo sync # -C is forwarded as the child's working directory") }}
+```bash
+wt sync origin # runs: wt-sync origin
+wt -C /tmp/repo sync # -C is forwarded as the child's working directory
+```
Arguments pass through verbatim, stdio is inherited, and the child's exit code propagates unchanged.
diff --git a/docs/content/faq.md b/docs/src/content/docs/faq.md
similarity index 85%
rename from docs/content/faq.md
rename to docs/src/content/docs/faq.md
index db62be087..9b2bc0e9e 100644
--- a/docs/content/faq.md
+++ b/docs/src/content/docs/faq.md
@@ -1,12 +1,9 @@
-+++
-title = "FAQ"
-description = "Common questions about Worktrunk: comparison to git worktree and branch switching, bare repos, TUI support, and more."
-weight = 25
-
-[extra]
-group = "Reference"
-+++
-
+---
+title: "FAQ"
+description: "Common questions about Worktrunk: comparison to git worktree and branch switching, bare repos, TUI support, and more."
+sidebar:
+ order: 25
+---
## How does Worktrunk compare to alternatives?
### vs. branch switching
@@ -17,24 +14,24 @@ Branch switching uses one directory: uncommitted changes from one agent get mixe
Git's built-in worktree commands work but require manual lifecycle management:
-{% terminal() %}
+```console
# Plain git worktree workflow
-<span class="cmd">git worktree add -b feature-branch ../myapp-feature main</span>
-<span class="cmd">cd ../myapp-feature</span>
+$ git worktree add -b feature-branch ../myapp-feature main
+$ cd ../myapp-feature
# ...work, commit, push...
-<span class="cmd">cd ../myapp</span>
-<span class="cmd">git merge feature-branch</span>
-<span class="cmd">git worktree remove ../myapp-feature</span>
-<span class="cmd">git branch -d feature-branch</span>
-{% end %}
+$ cd ../myapp
+$ git merge feature-branch
+$ git worktree remove ../myapp-feature
+$ git branch -d feature-branch
+```
Worktrunk automates the full lifecycle:
-{% terminal() %}
-<span class="cmd">wt switch --create feature-branch # Creates worktree, runs setup hooks</span>
+```console
+$ wt switch --create feature-branch # Creates worktree, runs setup hooks
# ...work...
-<span class="cmd">wt merge # Merges into default branch, cleans up</span>
-{% end %}
+$ wt merge # Merges into default branch, cleans up
+```
No cd back to main — `wt merge` runs from the feature worktree and merges into the target, like GitHub's merge button.
@@ -60,17 +57,17 @@ Git TUIs operate on a single repository. Worktrunk manages multiple worktrees, r
## Does Worktrunk support stacked branches?
-Not natively — stacked-branch workflows are a large design space, so Worktrunk treats them as an extension rather than a built-in. [`worktrunk-sync`](https://github.com/pablospe/worktrunk-sync) is a community tool that auto-detects the branch dependency tree from git history and rebases each branch onto its parent in topological order. Install with `cargo install worktrunk-sync` and run as `wt sync` (via [custom subcommands](@/extending.md#custom-subcommands)).
+Not natively — stacked-branch workflows are a large design space, so Worktrunk treats them as an extension rather than a built-in. [`worktrunk-sync`](https://github.com/pablospe/worktrunk-sync) is a community tool that auto-detects the branch dependency tree from git history and rebases each branch onto its parent in topological order. Install with `cargo install worktrunk-sync` and run as `wt sync` (via [custom subcommands](/extending/#custom-subcommands)).
## How do I move uncommitted changes to a new worktree?
Stash the changes, create the worktree, then pop:
-{% terminal() %}
-<span class="cmd">git stash push -u # -u also stashes untracked files</span>
-<span class="cmd">wt switch --create feature # new branch off the default branch</span>
-<span class="cmd">git stash pop # changes reappear in the new worktree</span>
-{% end %}
+```console
+$ git stash push -u # -u also stashes untracked files
+$ wt switch --create feature # new branch off the default branch
+$ git stash pop # changes reappear in the new worktree
+```
The stash lives in the shared `.git` directory, so it's reachable from the new worktree. The original branch is left clean.
@@ -80,7 +77,7 @@ The stash lives in the shared `.git` directory, so it's reachable from the new w
If shell integration isn't working (auto-cd not happening, completions missing, `wt` not found as a function), the fastest path to a fix is using Claude Code with the Worktrunk plugin:
-1. Install the [Worktrunk plugin](@/claude-code.md) in Claude Code
+1. Install the [Worktrunk plugin](/claude-code/) in Claude Code
2. Ask Claude to debug the Worktrunk shell integration
Claude will run `wt config show`, inspect the shell config files, and identify the issue.
@@ -99,7 +96,7 @@ Three verbosity levels. Each is a superset of the previous one.
At `-vv`, debug-level records (command lines, in-process spans, bounded subprocess preview) route to `trace.log` instead of stderr — so the terminal stays readable while the deep trace lands on disk. A one-line pointer on stderr shows where the files went.
-The `-vv` files have distinct audiences: `trace.log` is the human trace (bounded, gistable), `trace.jsonl` the same records for machines, `subprocess.log` the raw uncapped subprocess output, and `diagnostic.md` a bug-report bundle. Each is described in [`wt config state logs`](@/config.md#wt-config-state-logs).
+The `-vv` files have distinct audiences: `trace.log` is the human trace (bounded, gistable), `trace.jsonl` the same records for machines, `subprocess.log` the raw uncapped subprocess output, and `diagnostic.md` a bug-report bundle. Each is described in [`wt config state logs`](/config/#wt-config-state-logs).
`RUST_LOG` overrides the flag baseline when set (`RUST_LOG=debug wt -v` lifts `-v` to debug-on-stderr).
@@ -187,7 +184,9 @@ Removal also refuses, `--force` included, when the directory at a registered pat
To protect a worktree from removal entirely (say it holds a local database), lock it:
-{{ terminal(cmd="git worktree lock ../myproject.feature --reason __WT_QUOT__Contains local database__WT_QUOT__") }}
+```bash
+git worktree lock ../myproject.feature --reason "Contains local database"
+```
Locked worktrees show `⊞` in `wt list`. Neither `git worktree remove` nor `wt remove` (even with `--force`) will delete them. Unlock with `git worktree unlock`.
@@ -195,7 +194,7 @@ Locked worktrees show `⊞` in `wt list`. Neither `git worktree remove` nor `wt
By default, `wt remove` only deletes branches whose content is already in the default branch. Branches showing `_` (same commit) or `⊂` (integrated) in `wt list` are safe to delete.
-For the full algorithm, see [Branch cleanup](@/remove.md#branch-cleanup) — it handles squash-merge and rebase workflows where commit history differs but file changes match.
+For the full algorithm, see [Branch cleanup](/remove/#branch-cleanup) — it handles squash-merge and rebase workflows where commit history differs but file changes match.
Use `-D` to force-delete branches with unmerged changes. Use `--no-delete-branch` to keep the branch regardless of status.
@@ -217,25 +216,25 @@ Worktrunk runs `git` commands internally and optionally runs `gh` (GitHub) or `g
1. **User hooks** (`~/.config/worktrunk/config.toml`) — Personal automation for all repositories
2. **Project hooks** (`.config/wt.toml`) — Repository-specific automation
-3. **LLM commands** (`~/.config/worktrunk/config.toml`) — Commit message generation and [branch summaries](@/llm-commits.md#branch-summaries)
+3. **LLM commands** (`~/.config/worktrunk/config.toml`) — Commit message generation and [branch summaries](/llm-commits/#branch-summaries)
4. **--execute flag** — Explicitly provided commands
User hooks and user aliases don't require approval (you defined them). Commands from project hooks and project aliases require approval on first run. Approved commands are saved to the approvals file (`approvals.toml`). If a command changes, Worktrunk requires new approval.
### Example approval prompt
-{% terminal() %}
-<span class="y">▲ <b>repo</b> needs approval to execute <b>3</b> commands:</span>
+```console
+▲ repo needs approval to execute 3 commands:
-<span class="d">○</span> pre-start <b>install</b>:
-<span style='background:var(--bright-white,#fff)'> </span> <span class="d"><span class="b">npm</span> ci</span>
-<span class="d">○</span> pre-start <b>build</b>:
-<span style='background:var(--bright-white,#fff)'> </span> <span class="d"><span class="b">cargo</span> build <span class="c">--release</span></span>
-<span class="d">○</span> pre-start <b>env</b>:
-<span style='background:var(--bright-white,#fff)'> </span> <span class="d"><span class="b">echo</span> <span class="g">'PORT={{ branch | hash_port }}'</span> <span class="c">></span> .env.local</span>
+○ pre-start install:
+ npm ci
+○ pre-start build:
+ cargo build --release
+○ pre-start env:
+ echo 'PORT={{ branch | hash_port }}' > .env.local
-<span class="c">❯</span> Allow and remember? <b>[y/N]</b>
-{% end %}
+❯ Allow and remember? [y/N]
+```
Use `--yes` to bypass prompts (useful for CI/automation).
@@ -245,19 +244,19 @@ All hook executions and LLM commands are recorded in `.git/wt/logs/commands.json
View the log with `wt config state logs get`, or query directly:
-{% terminal() %}
+```console
# Recent commands
-<span class="cmd">tail -5 .git/wt/logs/commands.jsonl | jq .</span>
+$ tail -5 .git/wt/logs/commands.jsonl | jq .
# Failed commands
-<span class="cmd">jq 'select(.exit != 0 and .exit != null)' .git/wt/logs/commands.jsonl</span>
-{% end %}
+$ jq 'select(.exit != 0 and .exit != null)' .git/wt/logs/commands.jsonl
+```
Clear with `wt config state logs clear`.
## Does Worktrunk work on Windows?
-Yes. Core commands, shell integration, and tab completion work in both Git Bash and PowerShell. See [installation](@/worktrunk.md#install) for setup details, including avoiding the Windows Terminal `wt` conflict.
+Yes. Core commands, shell integration, and tab completion work in both Git Bash and PowerShell. See [installation](/worktrunk/#install) for setup details, including avoiding the Windows Terminal `wt` conflict.
**Git for Windows required** — Hooks use bash syntax and execute via Git Bash, so [Git for Windows](https://gitforwindows.org/) must be installed even when PowerShell is the interactive shell.
@@ -277,7 +276,7 @@ An alias body renders once at dispatch, in the invoking worktree's context, so a
Confirm it with `wt config alias dry-run <name>`: if the value is already substituted (e.g. `… echo branch=main`), it was baked at dispatch.
-To defer a variable to the nested command, wrap it as `{% raw %}{{ branch }}{% endraw %}`; for `wt step for-each`, also keep it inside a quoted `sh -c '…'` so the alias's shell doesn't word-split it. See [deferring expansion in an alias](@/extending.md#deferring-expansion-to-a-nested-wt-command). A repo-level variable like `{{ default_branch }}` is unaffected — it is identical in every worktree.
+To defer a variable to the nested command, wrap it as `{% raw %}{{ branch }}{% endraw %}`; for `wt step for-each`, also keep it inside a quoted `sh -c '…'` so the alias's shell doesn't word-split it. See [deferring expansion in an alias](/extending/#deferring-expansion-to-a-nested-wt-command). A repo-level variable like `{{ default_branch }}` is unaffected — it is identical in every worktree.
## Installation fails with C compilation errors
@@ -285,7 +284,9 @@ Worktrunk requires Git 2.34 or newer.
Installing with Cargo and the default features also requires a C99 compiler for bash syntax highlighting. If tree-sitter or C compilation fails (C99 mode, `le16toh` undefined), install without syntax highlighting:
-{{ terminal(cmd="cargo install worktrunk --no-default-features --features cli") }}
+```bash
+cargo install worktrunk --no-default-features --features cli
+```
This disables bash syntax highlighting in command output but keeps all core functionality. The syntax highlighting feature requires C99 compiler support and can fail on older systems or minimal Docker images.
@@ -293,13 +294,17 @@ This disables bash syntax highlighting in command output but keeps all core func
### Quick tests
-{{ terminal(cmd="cargo test") }}
+```bash
+cargo test
+```
### Full integration tests
Shell integration tests require bash, zsh, fish, nushell, and pwsh, plus `jq`:
-{{ terminal(cmd="cargo test --test integration --features shell-integration-tests") }}
+```bash
+cargo test --test integration --features shell-integration-tests
+```
## How can I contribute?
diff --git a/docs/content/hook.md b/docs/src/content/docs/hook.md
similarity index 73%
rename from docs/content/hook.md
rename to docs/src/content/docs/hook.md
index 37cd2263e..36dbd3285 100644
--- a/docs/content/hook.md
+++ b/docs/src/content/docs/hook.md
@@ -1,12 +1,9 @@
-+++
-title = "wt hook"
-description = "Run configured hooks."
-weight = 17
-
-[extra]
-group = "Commands"
-+++
-
+---
+title: "wt hook"
+description: "Run configured hooks."
+sidebar:
+ order: 17
+---
<!-- ⚠️ AUTO-GENERATED from `wt hook --help-page` — edit src/cli/mod.rs to update -->
Run configured hooks.
@@ -23,7 +20,7 @@ Hooks are shell commands that run at key points in the worktree lifecycle — au
| **merge** | `pre-merge` | `post-merge` |
| **remove** | `pre-remove` | `post-remove` |
-`pre-*` hooks block — failure aborts the operation. `post-*` hooks run in the background with output logged (use [`wt config state logs`](@/config.md#wt-config-state-logs) to find and manage log files). Use `-v` to see the template variables for background hooks; `wt hook <type> --dry-run` previews the commands.
+`pre-*` hooks block — failure aborts the operation. `post-*` hooks run in the background with output logged (use [`wt config state logs`](/config/#wt-config-state-logs) to find and manage log files). Use `-v` to see the template variables for background hooks; `wt hook <type> --dry-run` previews the commands.
The most common creation hook is `post-start` — it runs background tasks (dev servers, file copying, builds) without blocking worktree creation. Prefer `post-start` over `pre-start` unless a later step needs the work completed first.
@@ -40,24 +37,24 @@ The most common creation hook is `post-start` — it runs background tasks (dev
| `pre-remove` | Cleanup before worktree deletion: saving test artifacts, backing up state. Runs in the worktree being removed |
| `post-remove` | Stopping dev servers, removing containers, notifying external systems. Template variables reference the removed worktree |
-During `wt merge`, hooks run in this order: pre-commit → post-commit → pre-merge → pre-remove → post-remove + post-merge. See [`wt merge`](@/merge.md#pipeline) for the complete pipeline.
+During `wt merge`, hooks run in this order: pre-commit → post-commit → pre-merge → pre-remove → post-remove + post-merge. See [`wt merge`](/merge/#pipeline) for the complete pipeline.
# Security
Project commands require approval on first run:
-{% terminal() %}
-<span class="y">▲ <b>repo</b> needs approval to execute <b>3</b> commands:</span>
+```
+▲ repo needs approval to execute 3 commands:
-<span class="d">○</span> pre-start <b>install</b>:
-<span style='background:var(--bright-white,#fff)'> </span> <span class="d"><span class="b">npm</span> ci</span>
-<span class="d">○</span> pre-start <b>build</b>:
-<span style='background:var(--bright-white,#fff)'> </span> <span class="d"><span class="b">cargo</span> build <span class="c">--release</span></span>
-<span class="d">○</span> pre-start <b>env</b>:
-<span style='background:var(--bright-white,#fff)'> </span> <span class="d"><span class="b">echo</span> <span class="g">'PORT={{ branch | hash_port }}'</span> <span class="c">></span> .env.local</span>
+○ pre-start install:
+ npm ci
+○ pre-start build:
+ cargo build --release
+○ pre-start env:
+ echo 'PORT={{ branch | hash_port }}' > .env.local
-<span class="c">❯</span> Allow and remember? <b>[y/N]</b>
-{% end %}
+❯ Allow and remember? [y/N]
+```
- Approvals are saved to `~/.config/worktrunk/approvals.toml`
- If a command changes, new approval is required
@@ -102,7 +99,7 @@ server = "npm run dev"
Here `install` runs first, then `build` and `server` run together.
-Templates are syntax-checked before the pipeline starts and rendered as each step runs, so a step can store [per-branch vars](@/config.md#wt-config-state-vars) that later steps read via `{{ vars.<key> }}`. Because an earlier step can still change those values, a preview leaves them alone: `wt hook <type> --dry-run` and `wt hook show --expanded` render `{{ vars.<key> }}` as itself while every other variable expands.
+Templates are syntax-checked before the pipeline starts and rendered as each step runs, so a step can store [per-branch vars](/config/#wt-config-state-vars) that later steps read via `{{ vars.<key> }}`. Because an earlier step can still change those values, a preview leaves them alone: `wt hook <type> --dry-run` and `wt hook show --expanded` render `{{ vars.<key> }}` as itself while every other variable expands.
Most hooks don't need `[[hook]]` blocks. Reach for them when there's a dependency chain — typically setup that must complete before later steps, like installing dependencies before running a build and dev server concurrently.
@@ -111,7 +108,7 @@ Most hooks don't need `[[hook]]` blocks. Reach for them when there's a dependenc
| Aspect | Project hooks | User hooks |
|--------|--------------|------------|
| Location | `.config/wt.toml` | `~/.config/worktrunk/config.toml` |
-| Scope | Single repository | All repositories (or [per-project](@/config.md#user-project-specific-settings)) |
+| Scope | Single repository | All repositories (or [per-project](/config/#user-project-specific-settings)) |
| Approval | Required | Not required |
| Execution order | After user hooks | First |
@@ -147,7 +144,7 @@ Hooks can use template variables that expand at runtime:
| | `{{ hook_type }}` | Hook type being run (e.g. `pre-start`, `pre-merge`) |
| | `{{ hook_name }}` | Hook command name (if named) |
| | `{{ args }}` | Tokens forwarded from the CLI — see [Running Hooks Manually](#running-hooks-manually) |
-| user | `{{ vars.<key> }}` | Per-branch variables from [`wt config state vars`](@/config.md#wt-config-state-vars) |
+| user | `{{ vars.<key> }}` | Per-branch variables from [`wt config state vars`](/config/#wt-config-state-vars) |
The `repo` variables (`repo`, `repo_path`, `owner`, `remote_repo`, `primary_worktree_path`, `default_branch`, `remote`, `remote_url`) are constant across the whole repository — `default_branch` is the same in every worktree. The `active` variables (`branch`, `worktree_path`, `worktree_name`, `commit`, `short_commit`, `upstream`) vary per worktree.
@@ -277,7 +274,7 @@ if ctx['branch'].startswith('feature/') and 'backend' in ctx['repo']:
## Copying untracked files
-One specific command worth calling out: [`wt step copy-ignored`](@/step.md#wt-step-copy-ignored). Git worktrees share the repository but not untracked files, and this copies gitignored files between worktrees:
+One specific command worth calling out: [`wt step copy-ignored`](/step/#wt-step-copy-ignored). Git worktrees share the repository but not untracked files, and this copies gitignored files between worktrees:
```toml
[post-start]
@@ -288,13 +285,24 @@ copy = "wt step copy-ignored"
`wt hook <type>` runs hooks on demand — useful for testing during development, running in CI pipelines, or re-running after a failure.
-{{ terminal(cmd="wt hook pre-merge # Run all pre-merge hooks|||wt hook pre-merge test # Run hooks named __WT_QUOT__test__WT_QUOT__ from both sources|||wt hook pre-merge test build # Run hooks named __WT_QUOT__test__WT_QUOT__ and __WT_QUOT__build__WT_QUOT__|||wt hook pre-merge user: # Run all user hooks|||wt hook pre-merge project: # Run all project hooks|||wt hook pre-merge user:test # Run only user's __WT_QUOT__test__WT_QUOT__ hook|||wt hook pre-merge --yes # Skip approval prompts (for CI)|||wt hook pre-start --branch=feature/test # Override a template variable|||wt hook pre-merge -- --extra args # Forward tokens into __WT_OPEN__ args __WT_CLOSE__") }}
+```console
+$ wt hook pre-merge # Run all pre-merge hooks
+$ wt hook pre-merge test # Run hooks named "test" from both sources
+$ wt hook pre-merge test build # Run hooks named "test" and "build"
+$ wt hook pre-merge user: # Run all user hooks
+$ wt hook pre-merge project: # Run all project hooks
+$ wt hook pre-merge user:test # Run only user's "test" hook
+$ wt hook pre-merge --yes # Skip approval prompts (for CI)
+$ wt hook pre-start --branch=feature/test # Override a template variable
+$ wt hook pre-merge -- --extra args # Forward tokens into {{ args }}
+```
The `user:` and `project:` prefixes filter by source. Use `user:` or `project:` alone to run all hooks from that source, or `user:name` / `project:name` to run a specific hook.
-{% terminal(cmd="wt hook pre-merge") %}
-<span class=c>◎</span> <span class=c>Running pre-merge <b>project:test</b></span>
-<span style='background:var(--bright-white,#fff)'> </span> <span class=d><span style='color:var(--blue,#00a)'>cargo</span></span><span class=d> test</span>
+```console
+$ wt hook pre-merge
+◎ Running pre-merge project:test
+ cargo test
Finished test [unoptimized + debuginfo] target(s) in 0.12s
Running unittests src/lib.rs (target/debug/deps/worktrunk-abc123)
@@ -305,15 +313,16 @@ test auth::tests::test_token_refresh ... ok
test auth::tests::test_token_validation ... ok
test result: ok. 18 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.08s
-<span class=c>◎</span> <span class=c>Running pre-merge <b>project:lint</b></span>
-<span style='background:var(--bright-white,#fff)'> </span> <span class=d><span style='color:var(--blue,#00a)'>cargo</span></span><span class=d> clippy</span>
+◎ Running pre-merge project:lint
+ cargo clippy
Checking worktrunk v0.1.0
Finished dev [unoptimized + debuginfo] target(s) in 1.23s
-{% end %}
+```
-{% terminal(cmd="wt hook post-start") %}
+```console
+$ wt hook post-start
◎ Running post-start: project @ ~/acme
-{% end %}
+```
## Passing values
@@ -325,60 +334,60 @@ The long form `--var KEY=VALUE` is deprecated but still supported. It force-bind
# Recipes
-- [Eliminate cold starts](@/tips-patterns.md#eliminate-cold-starts): `wt step copy-ignored` in `post-start` shares build caches and dependencies; use a `[[post-start]]` pipeline when a later hook depends on the copy
-- [Dev server per worktree](@/tips-patterns.md#dev-server-per-worktree): `wt step tether` in `post-start` runs the dev server and kills its whole process group when the worktree is removed, with optional subdomain routing
-- [Database per worktree](@/tips-patterns.md#database-per-worktree): a `post-start` pipeline stores container name, port, and connection string as [per-branch vars](@/config.md#wt-config-state-vars) that later hooks reference
-- [Progressive validation](@/tips-patterns.md#progressive-validation): quick lint/typecheck in `pre-commit`, expensive tests and builds in `pre-merge`
-- [Target-specific hooks](@/tips-patterns.md#target-specific-hooks): branch on `{{ target }}` in `post-merge` for per-environment deploys
+- [Eliminate cold starts](/tips-patterns/#eliminate-cold-starts): `wt step copy-ignored` in `post-start` shares build caches and dependencies; use a `[[post-start]]` pipeline when a later hook depends on the copy
+- [Dev server per worktree](/tips-patterns/#dev-server-per-worktree): `wt step tether` in `post-start` runs the dev server and kills its whole process group when the worktree is removed, with optional subdomain routing
+- [Database per worktree](/tips-patterns/#database-per-worktree): a `post-start` pipeline stores container name, port, and connection string as [per-branch vars](/config/#wt-config-state-vars) that later hooks reference
+- [Progressive validation](/tips-patterns/#progressive-validation): quick lint/typecheck in `pre-commit`, expensive tests and builds in `pre-merge`
+- [Target-specific hooks](/tips-patterns/#target-specific-hooks): branch on `{{ target }}` in `post-merge` for per-environment deploys
## See also
-- [`wt merge`](@/merge.md) — Runs hooks automatically during merge
-- [`wt switch`](@/switch.md) — Runs pre-start/post-start hooks on `--create`
-- [`wt config approvals`](@/config.md#wt-config-approvals) — Manage approvals
-- [`wt config state logs`](@/config.md#wt-config-state-logs) — Access background hook logs
+- [`wt merge`](/merge/) — Runs hooks automatically during merge
+- [`wt switch`](/switch/) — Runs pre-start/post-start hooks on `--create`
+- [`wt config approvals`](/config/#wt-config-approvals) — Manage approvals
+- [`wt config state logs`](/config/#wt-config-state-logs) — Access background hook logs
## Command reference
-{% terminal() %}
+```
wt hook - Run configured hooks
-Usage: <b><span class=c>wt hook</span></b> <span class=c>[OPTIONS]</span> <span class=c>&lt;COMMAND&gt;</span>
-
-<b><span class=g>Commands:</span></b>
- <b><span class=c>show</span></b> Show configured hooks
- <b><span class=c>pre-switch</span></b> Run pre-switch hooks
- <b><span class=c>post-switch</span></b> Run post-switch hooks
- <b><span class=c>pre-start</span></b> Run pre-start hooks
- <b><span class=c>post-start</span></b> Run post-start hooks
- <b><span class=c>pre-commit</span></b> Run pre-commit hooks
- <b><span class=c>post-commit</span></b> Run post-commit hooks
- <b><span class=c>pre-merge</span></b> Run pre-merge hooks
- <b><span class=c>post-merge</span></b> Run post-merge hooks
- <b><span class=c>pre-remove</span></b> Run pre-remove hooks
- <b><span class=c>post-remove</span></b> Run post-remove hooks
-
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
-
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Usage: wt hook [OPTIONS] <COMMAND>
+
+Commands:
+ show Show configured hooks
+ pre-switch Run pre-switch hooks
+ post-switch Run post-switch hooks
+ pre-start Run pre-start hooks
+ post-start Run post-start hooks
+ pre-commit Run pre-commit hooks
+ post-commit Run post-commit hooks
+ pre-merge Run pre-merge hooks
+ post-merge Run post-merge hooks
+ pre-remove Run pre-remove hooks
+ post-remove Run post-remove hooks
+
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
+
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
<!-- END AUTO-GENERATED -->
diff --git a/docs/content/list.md b/docs/src/content/docs/list.md
similarity index 70%
rename from docs/content/list.md
rename to docs/src/content/docs/list.md
index d3948f098..ee67c1e30 100644
--- a/docs/content/list.md
+++ b/docs/src/content/docs/list.md
@@ -1,12 +1,9 @@
-+++
-title = "wt list"
-description = "List worktrees and their status."
-weight = 11
-
-[extra]
-group = "Commands"
-+++
-
+---
+title: "wt list"
+description: "List worktrees and their status."
+sidebar:
+ order: 11
+---
<!-- ⚠️ AUTO-GENERATED from `wt list --help-page` — edit src/cli/mod.rs to update -->
List worktrees and their status.
@@ -30,45 +27,50 @@ The table renders progressively: branch names, paths, and commit hashes appear i
List all worktrees:
-{% terminal(cmd="wt list") %}
-&#32;&#32;<b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Remote⇅</b> <b>Commit</b> <b>Age</b> <b>Message</b>
-@ feature-api <span class=c>+</span> <span class=d>↕</span><span class=d>⇡</span> <span class=g>+54</span> <span class=r>-5</span> <span class=g>↑4</span> <span class=d><span class=r>↓1</span></span> <span class=g>+234</span> <span class=r>-24</span> <span class=g>⇡3</span> <span class=d>6814f02</span> <span class=d>30m</span> <span class=d>Add API tests</span>
-^ main <span class=d>^</span><span class=d>⇅</span> <span class=g>⇡1</span> <span class=d><span class=r>⇣1</span></span> <span class=d>41ee083</span> <span class=d>4d</span> <span class=d>Merge fix-auth: h…</span>
-+ fix-auth <span class=d>↕</span><span class=d>|</span> <span class=g>↑2</span> <span class=d><span class=r>↓1</span></span> <span class=g>+25</span> <span class=r>-11</span> <span class=d>|</span> <span class=d>b772e68</span> <span class=d>5h</span> <span class=d>Add secure token…</span>
-+ <span class=d>fix-typos</span> <span class=d>_</span><span class=d>|</span> <span class=d>|</span> <span class=d>41ee083</span> <span class=d>4d</span> <span class=d>Merge fix-auth: h…</span>
+```console
+$ wt list
+ Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 ⇡3 6814f02 30m Add API tests
+^ main ^⇅ ⇡1 ⇣1 41ee083 4d Merge fix-auth: h…
++ fix-auth ↕| ↑2 ↓1 +25 -11 | b772e68 5h Add secure token…
++ fix-typos _| | 41ee083 4d Merge fix-auth: h…
-<span class=d>○</span> <span class=d>Showing 4 worktrees, 1 with changes, 2 ahead, 1 column hidden</span>
-{% end %}
+○ Showing 4 worktrees, 1 with changes, 2 ahead, 1 column hidden
+```
Include CI status and LLM summaries:
-{% terminal(cmd="wt list --full") %}
-&#32;&#32;<b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Summary</b> <b>Remote⇅</b> <b>CI</b> <b>Commit</b>
-@ feature-api <span class=c>+</span> <span class=d>↕</span><span class=d>⇡</span> <span class=g>+54</span> <span class=r>-5</span> <span class=g>↑4</span> <span class=d><span class=r>↓1</span></span> <span class=g>+234</span> <span class=r>-24</span> Refactor API to REST architecture with middleware <span class=g>⇡3</span> <span class=d><span style='color:var(--blue,#00a)'>#412</span></span> <span class=d>6814f02</span>
-^ main <span class=d>^</span><span class=d>⇅</span> <span class=g>⇡1</span> <span class=d><span class=r>⇣1</span></span> <span class=g>#</span> <span class=d>41ee083</span>
-+ fix-auth <span class=d>↕</span><span class=d>|</span> <span class=g>↑2</span> <span class=d><span class=r>↓1</span></span> <span class=g>+25</span> <span class=r>-11</span> Harden auth with constant-time token validation <span class=d>|</span> <span class=g>#408</span> <span class=d>b772e68</span>
-+ <span class=d>fix-typos</span> <span class=d>_</span><span class=d>|</span> <span class=d>|</span> <span class=g>#410</span> <span class=d>41ee083</span>
+```console
+$ wt list --full
+ Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
+^ main ^⇅ ⇡1 ⇣1 # 41ee083
++ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
++ fix-typos _| | #410 41ee083
-<span class=d>○</span> <span class=d>Showing 4 worktrees, 1 with changes, 2 ahead, 3 columns hidden</span>
-{% end %}
+○ Showing 4 worktrees, 1 with changes, 2 ahead, 3 columns hidden
+```
Include branches that don't have worktrees:
-{% terminal(cmd="wt list --branches --full") %}
-&#32;&#32;<b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Summary</b> <b>Remote⇅</b> <b>CI</b> <b>Commit</b>
-@ feature-api <span class=c>+</span> <span class=d>↕</span><span class=d>⇡</span> <span class=g>+54</span> <span class=r>-5</span> <span class=g>↑4</span> <span class=d><span class=r>↓1</span></span> <span class=g>+234</span> <span class=r>-24</span> Refactor API to REST architecture with middleware <span class=g>⇡3</span> <span class=d><span style='color:var(--blue,#00a)'>#412</span></span> <span class=d>6814f02</span>
-^ main <span class=d>^</span><span class=d>⇅</span> <span class=g>⇡1</span> <span class=d><span class=r>⇣1</span></span> <span class=g>#</span> <span class=d>41ee083</span>
-+ fix-auth <span class=d>↕</span><span class=d>|</span> <span class=g>↑2</span> <span class=d><span class=r>↓1</span></span> <span class=g>+25</span> <span class=r>-11</span> Harden auth with constant-time token validation <span class=d>|</span> <span class=g>#408</span> <span class=d>b772e68</span>
-+ <span class=d>fix-typos</span> <span class=d>_</span><span class=d>|</span> <span class=d>|</span> <span class=g>#410</span> <span class=d>41ee083</span>
-<span class=d>/ </span>exp <span class=d>/</span><span class=d>↕</span> <span class=g>↑2</span> <span class=d><span class=r>↓1</span></span> <span class=g>+137</span> Explore GraphQL schema and resolvers <span class=d>9637922</span>
-<span class=d>/ </span>wip <span class=d>/</span><span class=d>↕</span> <span class=g>↑1</span> <span class=d><span class=r>↓1</span></span> <span class=g>+33</span> Start API documentation <span class=d>b40716d</span>
-
-<span class=d>○</span> <span class=d>Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, 3 columns hidden</span>
-{% end %}
+```console
+$ wt list --branches --full
+ Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
+@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
+^ main ^⇅ ⇡1 ⇣1 # 41ee083
++ fix-auth ↕| ↑2 ↓1 +25 -11 Harden auth with constant-time token validation | #408 b772e68
++ fix-typos _| | #410 41ee083
+/ exp /↕ ↑2 ↓1 +137 Explore GraphQL schema and resolvers 9637922
+/ wip /↕ ↑1 ↓1 +33 Start API documentation b40716d
+
+○ Showing 4 worktrees, 2 branches, 1 with changes, 4 ahead, 3 columns hidden
+```
Output as JSON for scripting:
-{{ terminal(cmd="wt list --format=json") }}
+```console
+$ wt list --format=json
+```
## Columns
@@ -79,7 +81,7 @@ Output as JSON for scripting:
| HEAD± | Uncommitted changes: +added -deleted lines |
| main↕ | Commits ahead/behind default branch |
| main…± | Line diffs since the merge-base (three-dot) with the default branch |
-| Summary | LLM-generated branch summary; requires `--full`, `summary = true`, and [`commit.generation`](@/config.md#commit) <span class="badge-experimental"></span> |
+| Summary | LLM-generated branch summary; requires `--full`, `summary = true`, and [`commit.generation`](/config/#commit) <span class="badge-experimental"></span> |
| Remote⇅ | Commits ahead/behind tracking branch |
| CI | PR/MR number colored by pipeline status; `--full` only |
| Path | Worktree directory |
@@ -131,20 +133,20 @@ CI cells are clickable links to the PR or pipeline page, and appear dimmed for a
<span class="badge-experimental"></span>
-Reuses the [`commit.generation`](@/config.md#commit) command — the same LLM that generates commit messages. Enable with `summary = true` in `[list]` config; requires `--full`. Results are cached until the branch's diff changes.
+Reuses the [`commit.generation`](/config/#commit) command — the same LLM that generates commit messages. Enable with `summary = true` in `[list]` config; requires `--full`. Results are cached until the branch's diff changes.
### Custom columns
<span class="badge-experimental"></span>
-Each `[list.custom-columns]` entry in user config adds a column: the key is the header, the template renders each row's cell. Templates read two per-branch namespaces — `{{ vars.* }}`, stored with [`wt config state vars set`](@/config.md#wt-config-state-vars), and `{{ git.branch.* }}`, the branch's own git config under `branch.<name>.*` (a `jira` key you set yourself, or the git-native `description`) — useful for tracking what each of many (often agent-driven) branches is for:
+Each `[list.custom-columns]` entry in user config adds a column: the key is the header, the template renders each row's cell. Templates read two per-branch namespaces — `{{ vars.* }}`, stored with [`wt config state vars set`](/config/#wt-config-state-vars), and `{{ git.branch.* }}`, the branch's own git config under `branch.<name>.*` (a `jira` key you set yourself, or the git-native `description`) — useful for tracking what each of many (often agent-driven) branches is for:
```toml
[list.custom-columns.Ticket]
template = "{{ vars.ticket }}"
```
-A column that renders empty for every row is dropped from the table. Templates, widths, and drop priority: [custom columns config](@/config.md#custom-columns).
+A column that renders empty for every row is dropped from the table. Templates, widths, and drop priority: [custom columns config](/config/#custom-columns).
## Status symbols
@@ -185,14 +187,14 @@ The single highest-priority state describing the branch's relation to the defaul
| `^` | `"is_main"` | The main worktree (the repo's home worktree) |
| `∅` | `"orphan"` | No common ancestor with the default branch |
| `_` | `"empty"` | Same commit as the default branch, working tree clean — safe to remove; row dimmed |
-| `⊂` | `"integrated"` | Content [integrated](@/remove.md#branch-cleanup) into the default branch or merge target via different history; the matching check is in `integration_reason`; row dimmed |
+| `⊂` | `"integrated"` | Content [integrated](/remove/#branch-cleanup) into the default branch or merge target via different history; the matching check is in `integration_reason`; row dimmed |
| `✗` | `"would_conflict"` | Merging into the default branch would conflict (simulated with `git merge-tree`) and the branch isn't already integrated; with `--full`, the check includes uncommitted changes |
| `–` | `"same_commit"` | Same commit as the default branch, but with uncommitted changes |
| `↕` | `"diverged"` | Both ahead of and behind the default branch |
| `↑` | `"ahead"` | Has commits the default branch doesn't |
| `↓` | `"behind"` | Missing commits the default branch has |
-Rows are dimmed when [safe to delete](@/remove.md#branch-cleanup) — `_` (`"empty"`) or `⊂` (`"integrated"`).
+Rows are dimmed when [safe to delete](/remove/#branch-cleanup) — `_` (`"empty"`) or `⊂` (`"integrated"`).
### Remote
@@ -283,7 +285,7 @@ Item fields:
| `checks` | CI pipeline: `{status, source, stale}`; collected with `--full`. `status` is `passed`, `running`, or `failed` — null when a conflicts report masks it |
| `dev_server` | `{url, listening}` from the project's `list.url` template |
| `summary` | LLM branch summary; needs `--full`, `[list] summary = true`, and a `[commit.generation]` command |
-| `vars` | Per-branch variables from [`wt config state vars`](@/config.md#wt-config-state-vars) |
+| `vars` | Per-branch variables from [`wt config state vars`](/config/#wt-config-state-vars) |
| `display` | Rendered strings: `state` (schema 1's `main_state` vocabulary), `symbols`, `statusline` (with ANSI colors and OSC 8 hyperlinks), `columns` (custom-column cells keyed by header) |
Schema 1 names map directly: `commit` → `head`, `working_tree` →
@@ -292,7 +294,19 @@ Schema 1 names map directly: `commit` → `head`, `working_tree` →
`url_active` → `dev_server`, `statusline`/`symbols`/`columns` → `display.*`,
and the per-item `repo` moves to the envelope's `repo.forge`.
-{{ terminal(cmd="# Current worktree path (for scripts)|||wt list --format=json | jq -r '.items[] | select(.worktree.current) | .worktree.path'||||||# Branches with uncommitted changes|||wt list --format=json | jq '.items[] | select(.worktree.changes.modified)'||||||# Integrated branches (safe to remove)|||wt list --format=json | jq '.items[] | select(.display.state == __WT_QUOT__integrated__WT_QUOT__ or .display.state == __WT_QUOT__empty__WT_QUOT__) | .branch'||||||# Worktrees ahead of upstream (needs pushing)|||wt list --format=json | jq '.items[] | select(.upstream.ahead > 0) | .branch'") }}
+```console
+# Current worktree path (for scripts)
+$ wt list --format=json | jq -r '.items[] | select(.worktree.current) | .worktree.path'
+
+# Branches with uncommitted changes
+$ wt list --format=json | jq '.items[] | select(.worktree.changes.modified)'
+
+# Integrated branches (safe to remove)
+$ wt list --format=json | jq '.items[] | select(.display.state == "integrated" or .display.state == "empty") | .branch'
+
+# Worktrees ahead of upstream (needs pushing)
+$ wt list --format=json | jq '.items[] | select(.upstream.ahead > 0) | .branch'
+```
A JSON Schema for the envelope is published at
[worktrunk.dev/schema/list-v2.json](https://worktrunk.dev/schema/list-v2.json).
@@ -303,7 +317,31 @@ optional there rather than required-and-null.
The original bare-array format, and the default while unset:
-{{ terminal(cmd="# Current worktree path (for scripts)|||wt list --format=json | jq -r '.[] | select(.is_current) | .path'||||||# Branches with uncommitted changes|||wt list --format=json | jq '.[] | select(.working_tree.modified)'||||||# Worktrees with merge conflicts|||wt list --format=json | jq '.[] | select(.operation_state == __WT_QUOT__conflicts__WT_QUOT__)'||||||# Branches ahead of main (needs merging)|||wt list --format=json | jq '.[] | select(.main.ahead > 0) | .branch'||||||# Integrated branches (safe to remove)|||wt list --format=json | jq '.[] | select(.main_state == __WT_QUOT__integrated__WT_QUOT__ or .main_state == __WT_QUOT__empty__WT_QUOT__) | .branch'||||||# Branches without worktrees|||wt list --format=json --branches | jq '.[] | select(.kind == __WT_QUOT__branch__WT_QUOT__) | .branch'||||||# Worktrees ahead of remote (needs pushing)|||wt list --format=json | jq '.[] | select(.remote.ahead > 0) | {branch, ahead: .remote.ahead}'||||||# Stale CI (local changes not reflected in CI)|||wt list --format=json --full | jq '.[] | select(.ci.stale) | .branch'") }}
+```console
+# Current worktree path (for scripts)
+$ wt list --format=json | jq -r '.[] | select(.is_current) | .path'
+
+# Branches with uncommitted changes
+$ wt list --format=json | jq '.[] | select(.working_tree.modified)'
+
+# Worktrees with merge conflicts
+$ wt list --format=json | jq '.[] | select(.operation_state == "conflicts")'
+
+# Branches ahead of main (needs merging)
+$ wt list --format=json | jq '.[] | select(.main.ahead > 0) | .branch'
+
+# Integrated branches (safe to remove)
+$ wt list --format=json | jq '.[] | select(.main_state == "integrated" or .main_state == "empty") | .branch'
+
+# Branches without worktrees
+$ wt list --format=json --branches | jq '.[] | select(.kind == "branch") | .branch'
+
+# Worktrees ahead of remote (needs pushing)
+$ wt list --format=json | jq '.[] | select(.remote.ahead > 0) | {branch, ahead: .remote.ahead}'
+
+# Stale CI (local changes not reflected in CI)
+$ wt list --format=json --full | jq '.[] | select(.ci.stale) | .branch'
+```
**Fields:**
@@ -331,7 +369,7 @@ The original bare-array format, and the default while unset:
| `summary` | string | LLM-generated branch summary; `--full` only, then absent when not configured or no summary |
| `statusline` | string | Pre-formatted status with colors and links |
| `symbols` | string | Raw status symbols without colors (e.g., `"!?↓"`) |
-| `vars` | object | Per-branch variables from [`wt config state vars`](@/config.md#wt-config-state-vars) (absent when empty) |
+| `vars` | object | Per-branch variables from [`wt config state vars`](/config/#wt-config-state-vars) (absent when empty) |
| `columns` | object | Rendered [custom column](#custom-columns) values keyed by header; empty cells omitted (absent when none configured) |
### Commit object
@@ -436,63 +474,63 @@ Missing a field that would be generally useful? [Open an issue](https://github.c
## See also
-- [`wt switch`](@/switch.md) — Switch worktrees or open interactive picker
+- [`wt switch`](/switch/) — Switch worktrees or open interactive picker
## Command reference
-{% terminal() %}
+```
wt list - List worktrees and their status
-Usage: <b><span class=c>wt list</span></b> <span class=c>[OPTIONS]</span>
- <b><span class=c>wt list</span></b> <span class=c>&lt;COMMAND&gt;</span>
+Usage: wt list [OPTIONS]
+ wt list <COMMAND>
-<b><span class=g>Commands:</span></b>
- <b><span class=c>statusline</span></b> Single-line status for the current worktree
+Commands:
+ statusline Single-line status for the current worktree
-<b><span class=g>Options:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Options:
+ --format <FORMAT>
Output format
[default: table]
[possible values: table, json]
- <b><span class=c>--branches</span></b>
+ --branches
Include branches without worktrees
- <b><span class=c>--remotes</span></b>
+ --remotes
Include remote branches
- <b><span class=c>--full</span></b>
+ --full
Show CI status and LLM summaries
- <b><span class=c>--progressive</span></b>
+ --progressive
Show fast info immediately, update with slow info
Displays local data (branches, paths, status) first, then updates with remote data (CI,
upstream) as it arrives. Use --no-progressive to force buffered rendering. Auto-enabled
for TTY.
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
# Subcommands
@@ -524,46 +562,46 @@ The CI reference links to its PR/MR, and a dev server URL carrying a port shows
The pace segment appears only when usage is likely to hit a rate limit before its window resets, and shows the higher-risk window: `2.9×(Tue–Tue 5pm)` reads as 2.9× the pace that would exactly fill that window. Above 90% used it shows usage instead of pace — `93%(Tue–Tue 5pm)` — near the cap, how much is left matters more than how fast it's going. "Likely" is a Bayesian forecast; early-window bursts don't trigger it. Its colour deepens with severity — dim, then dim-yellow, then yellow — as the forecast lockout (how much of the window would be spent capped) grows, so a fast pace that would only tip over near the reset stays dim rather than alarming. With `-vv`, each window's inputs and projection are logged to `.git/wt/logs/trace.log`.
-[Claude Code statusline setup](@/claude-code.md#statusline-claude-code-only) has the `~/.claude/settings.json` entry that feeds this mode.
+[Claude Code statusline setup](/claude-code/#statusline-claude-code-only) has the `~/.claude/settings.json` entry that feeds this mode.
### Command reference
-{% terminal() %}
+```
wt list statusline - Single-line status for the current worktree
-Usage: <b><span class=c>wt list statusline</span></b> <span class=c>[OPTIONS]</span>
+Usage: wt list statusline [OPTIONS]
-<b><span class=g>Options:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Options:
+ --format <FORMAT>
Output format
Possible values:
- - <b><span class=c>table</span></b>
- - <b><span class=c>json</span></b>
- - <b><span class=c>claude-code</span></b>: Claude Code statusline mode (reads context from stdin)
+ - table
+ - json
+ - claude-code: Claude Code statusline mode (reads context from stdin)
[default: table]
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
<!-- END AUTO-GENERATED -->
diff --git a/docs/content/llm-commits.md b/docs/src/content/docs/llm-commits.md
similarity index 63%
rename from docs/content/llm-commits.md
rename to docs/src/content/docs/llm-commits.md
index d715cb25c..dc54ca96f 100644
--- a/docs/content/llm-commits.md
+++ b/docs/src/content/docs/llm-commits.md
@@ -1,12 +1,9 @@
-+++
-title = "LLM Commit Messages"
-description = "Generate commit messages from diffs using any LLM. Integrates with wt merge, wt step commit, and wt step squash."
-weight = 22
-
-[extra]
-group = "Reference"
-+++
-
+---
+title: "LLM Commit Messages"
+description: "Generate commit messages from diffs using any LLM. Integrates with wt merge, wt step commit, and wt step squash."
+sidebar:
+ order: 22
+---
Worktrunk generates commit messages by building a templated prompt and piping it to an external command. This integrates with `wt merge`, `wt step commit`, and `wt step squash`.
<figure class="demo">
@@ -61,27 +58,27 @@ Squashes all changes (uncommitted + existing commits) into one commit with an LL
<!-- ⚠️ AUTO-GENERATED from tests/snapshots/integration__integration_tests__merge__docs_merge_squash_llm.snap — edit source to update -->
-{% terminal(cmd="wt merge") %}
-<span class="cmd">wt merge</span>
-<span class=c>◎</span> <span class=c>Squashing 3 commits into a single commit <span style='color:var(--bright-black,#555)'>(5 files, <span class=g>+16</span></span></span><span style='color:var(--bright-black,#555)'>)</span>...
-<span class=c>◎</span> <span class=c>Generating squash commit message...</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>feat(auth): Implement JWT authentication system</b>
-<span style='background:var(--bright-white,#fff)'> </span>
-<span style='background:var(--bright-white,#fff)'> </span> Add comprehensive JWT token handling including validation, refresh
-<span style='background:var(--bright-white,#fff)'> </span> logic, and authentication tests.
-<span class=g>✓</span> <span class=g>Squashed @ a1b2c3d</span>
-<span class=c>◎</span> <span class=c>Merging 1 commit to <b>main</b> @ <span class=d>a1b2c3d</span> (no rebase needed)</span>
-<span style='background:var(--bright-white,#fff)'> </span> * <span style='color:var(--yellow,#a60)'>a1b2c3d</span> feat(auth): Implement JWT authentication system
-<span style='background:var(--bright-white,#fff)'> </span> auth.rs | 2 <span class=g>++</span>
-<span style='background:var(--bright-white,#fff)'> </span> auth_test.rs | 2 <span class=g>++</span>
-<span style='background:var(--bright-white,#fff)'> </span> integration_test.rs | 6 <span class=g>++++++</span>
-<span style='background:var(--bright-white,#fff)'> </span> jwt.rs | 3 <span class=g>+++</span>
-<span style='background:var(--bright-white,#fff)'> </span> jwt_test.rs | 3 <span class=g>+++</span>
-<span style='background:var(--bright-white,#fff)'> </span> 5 files changed, 16 insertions(+)
-<span class=g>✓</span> <span class=g>Merged to <b>main</b> <span style='color:var(--bright-black,#555)'>(1 commit, 5 files, <span class=g>+16</span></span></span><span style='color:var(--bright-black,#555)'>)</span>
-<span class=c>◎</span> <span class=c>Removing <b>feature</b> worktree &amp; branch in background (same commit as <b>main</b>,</span> <span class=d>_</span><span class=c>)</span>
-<span class=d>○</span> Switched to worktree for <b>main</b> @ <b>~/repo</b>
-{% end %}
+```console
+$ wt merge
+◎ Squashing 3 commits into a single commit (5 files, +16)...
+◎ Generating squash commit message...
+ feat(auth): Implement JWT authentication system
+
+ Add comprehensive JWT token handling including validation, refresh
+ logic, and authentication tests.
+✓ Squashed @ a1b2c3d
+◎ Merging 1 commit to main @ a1b2c3d (no rebase needed)
+ * a1b2c3d feat(auth): Implement JWT authentication system
+ auth.rs | 2 ++
+ auth_test.rs | 2 ++
+ integration_test.rs | 6 ++++++
+ jwt.rs | 3 +++
+ jwt_test.rs | 3 +++
+ 5 files changed, 16 insertions(+)
+✓ Merged to main (1 commit, 5 files, +16)
+◎ Removing feature worktree & branch in background (same commit as main, _)
+○ Switched to worktree for main @ ~/repo
+```
<!-- END AUTO-GENERATED -->
@@ -91,12 +88,12 @@ Stages and commits with LLM-generated message:
<!-- ⚠️ AUTO-GENERATED from tests/snapshots/integration__integration_tests__merge__docs_step_commit_llm.snap — edit source to update -->
-{% terminal(cmd="wt step commit") %}
-<span class="cmd">wt step commit</span>
-<span class=c>◎</span> <span class=c>Generating commit message and committing changes... <span style='color:var(--bright-black,#555)'>(2 files, <span class=g>+26</span></span></span><span style='color:var(--bright-black,#555)'>)</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>feat(validation): add input validation utilities</b>
-<span class=g>✓</span> <span class=g>Committed changes @ <span class=d>a1b2c3d</span></span>
-{% end %}
+```console
+$ wt step commit
+◎ Generating commit message and committing changes... (2 files, +26)
+ feat(validation): add input validation utilities
+✓ Committed changes @ a1b2c3d
+```
<!-- END AUTO-GENERATED -->
@@ -106,20 +103,20 @@ Squashes branch commits into one with LLM-generated message:
<!-- ⚠️ AUTO-GENERATED from tests/snapshots/integration__integration_tests__merge__docs_step_squash_llm.snap — edit source to update -->
-{% terminal(cmd="wt step squash") %}
-<span class="cmd">wt step squash</span>
-<span class=c>◎</span> <span class=c>Squashing 3 commits into a single commit <span style='color:var(--bright-black,#555)'>(5 files, <span class=g>+16</span></span></span><span style='color:var(--bright-black,#555)'>)</span>...
-<span class=c>◎</span> <span class=c>Generating squash commit message...</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>feat(auth): Implement JWT authentication system</b>
-<span style='background:var(--bright-white,#fff)'> </span>
-<span style='background:var(--bright-white,#fff)'> </span> Add comprehensive JWT token handling including validation, refresh
-<span style='background:var(--bright-white,#fff)'> </span> logic, and authentication tests.
-<span class=g>✓</span> <span class=g>Squashed @ a1b2c3d</span>
-{% end %}
+```console
+$ wt step squash
+◎ Squashing 3 commits into a single commit (5 files, +16)...
+◎ Generating squash commit message...
+ feat(auth): Implement JWT authentication system
+
+ Add comprehensive JWT token handling including validation, refresh
+ logic, and authentication tests.
+✓ Squashed @ a1b2c3d
+```
<!-- END AUTO-GENERATED -->
-See [`wt merge`](@/merge.md) and [`wt step`](@/step.md) for full documentation.
+See [`wt merge`](/merge/) and [`wt step`](/step/) for full documentation.
## Branch summaries
@@ -129,8 +126,8 @@ With `summary = true` and a `[commit.generation] command` configured, Worktrunk
Summaries appear in:
-- **`wt switch`** [interactive picker](@/switch.md#interactive-picker) — preview tab 5
-- **`wt list --full`** — the Summary column (see [`wt list`](@/list.md#llm-summaries))
+- **`wt switch`** [interactive picker](/switch/#interactive-picker) — preview tab 5
+- **`wt list --full`** — the Summary column (see [`wt list`](/list/#llm-summaries))
Enable in user config:
diff --git a/docs/content/merge.md b/docs/src/content/docs/merge.md
similarity index 55%
rename from docs/content/merge.md
rename to docs/src/content/docs/merge.md
index b2fd99104..1d13329cd 100644
--- a/docs/content/merge.md
+++ b/docs/src/content/docs/merge.md
@@ -1,12 +1,9 @@
-+++
-title = "wt merge"
-description = "Merge current branch into the target branch. Squash & rebase, fast-forward the target branch, remove the worktree."
-weight = 13
-
-[extra]
-group = "Commands"
-+++
-
+---
+title: "wt merge"
+description: "Merge current branch into the target branch. Squash & rebase, fast-forward the target branch, remove the worktree."
+sidebar:
+ order: 13
+---
<!-- ⚠️ AUTO-GENERATED from `wt merge --help-page` — edit src/cli/mod.rs to update -->
Merge current branch into the target branch. Squash & rebase, fast-forward the target branch, remove the worktree.
@@ -24,43 +21,56 @@ Unlike `git merge`, this merges the current branch into the target branch — no
Merge to the default branch:
-{% terminal(cmd="wt merge") %}
-<span class=c>◎</span> <span class=c>Running pre-merge <b>project:test</b></span>
-<span style='background:var(--bright-white,#fff)'> </span> <span class=d><span style='color:var(--blue,#00a)'>cargo</span></span><span class=d> nextest run</span>
+```console
+$ wt merge
+◎ Running pre-merge project:test
+ cargo nextest run
Finished `test` profile [unoptimized + debuginfo] target(s) in 0.02s
Summary [ 0.002s] 2 tests run: 2 passed, 0 skipped
-<span class=c>◎</span> <span class=c>Merging 1 commit to <b>main</b> @ <span class=d>a1b2c3d</span> (no commit/squash/rebase needed)</span>
-<span style='background:var(--bright-white,#fff)'> </span> * <span style='color:var(--yellow,#a60)'>a1b2c3d</span> feat: add hook registration
-<span style='background:var(--bright-white,#fff)'> </span> hook.rs | 31 <span class=g>+++++++++++++++++++++++++++++++</span>
-<span style='background:var(--bright-white,#fff)'> </span> 1 file changed, 31 insertions(+)
-<span class=g>✓</span> <span class=g>Merged to <b>main</b> <span style='color:var(--bright-black,#555)'>(1 commit, 1 file, <span class=g>+31</span></span></span><span style='color:var(--bright-black,#555)'>)</span>
-<span class=c>◎</span> <span class=c>Removing <b>hooks</b> worktree &amp; branch in background (same commit as <b>main</b>,</span> <span class=d>_</span><span class=c>)</span>
-<span class=d>○</span> Switched to worktree for <b>main</b> @ <b>~/repo</b>
-{% end %}
+◎ Merging 1 commit to main @ a1b2c3d (no commit/squash/rebase needed)
+ * a1b2c3d feat: add hook registration
+ hook.rs | 31 +++++++++++++++++++++++++++++++
+ 1 file changed, 31 insertions(+)
+✓ Merged to main (1 commit, 1 file, +31)
+◎ Removing hooks worktree & branch in background (same commit as main, _)
+○ Switched to worktree for main @ ~/repo
+```
Merge to a different branch:
-{{ terminal(cmd="wt merge develop") }}
+```console
+$ wt merge develop
+```
Keep the worktree after merging:
-{{ terminal(cmd="wt merge --no-remove") }}
+```console
+$ wt merge --no-remove
+```
Preserve commit history (no squash):
-{{ terminal(cmd="wt merge --no-squash") }}
+```console
+$ wt merge --no-squash
+```
Create a merge commit — rebased semi-linear history by default:
-{{ terminal(cmd="wt merge --no-ff") }}
+```console
+$ wt merge --no-ff
+```
Skip committing/squashing (rebase still runs unless --no-rebase):
-{{ terminal(cmd="wt merge --no-commit") }}
+```console
+$ wt merge --no-commit
+```
Preserve the exact clean commit graph and tip:
-{{ terminal(cmd="wt merge --no-commit --no-rebase") }}
+```console
+$ wt merge --no-commit --no-rebase
+```
## Pipeline
@@ -68,9 +78,9 @@ Preserve the exact clean commit graph and tip:
1. **Commit** — Pre-commit hooks run, then uncommitted changes are committed. Post-commit hooks run in background. Skipped when squashing (the default) — changes are staged during the squash step instead. With `--no-squash`, this is the only commit step.
2. **Squash** — Combines all commits since target into one (like GitHub's "Squash and merge"). Use `--stage` to control what gets staged: `all` (default), `tracked`, or `none`. Working-tree changes swept into the squash are backed up first to `refs/wt-backup/<branch>`. With `--no-squash`, individual commits are preserved.
-3. **Rebase** — Rebases onto target, skipping when nothing needs replaying ([`wt step rebase`](@/step.md#wt-step-rebase) gives the conditions). A conflict stops the merge with the rebase left open in the worktree, to resolve or abort. With `--no-rebase`, the graph produced by earlier commit/squash steps is preserved and the target must be able to fast-forward to its tip.
-4. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [`wt hook`](@/hook.md).
-5. **Merge** — Fast-forward merge to the target branch ([`wt step push`](@/step.md#wt-step-push)). With `--no-ff`, a merge commit is created instead — semi-linear history after the default rebase, while explicit `--no-rebase` preserves the graph produced by earlier steps before adding the merge commit. Non-fast-forward merges are rejected.
+3. **Rebase** — Rebases onto target, skipping when nothing needs replaying ([`wt step rebase`](/step/#wt-step-rebase) gives the conditions). A conflict stops the merge with the rebase left open in the worktree, to resolve or abort. With `--no-rebase`, the graph produced by earlier commit/squash steps is preserved and the target must be able to fast-forward to its tip.
+4. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [`wt hook`](/hook/).
+5. **Merge** — Fast-forward merge to the target branch ([`wt step push`](/step/#wt-step-push)). With `--no-ff`, a merge commit is created instead — semi-linear history after the default rebase, while explicit `--no-rebase` preserves the graph produced by earlier steps before adding the merge commit. Non-fast-forward merges are rejected.
6. **Pre-remove hooks** — Hooks run before removing worktree. Failures abort.
7. **Cleanup** — Removes the worktree and branch. Use `--no-remove` to keep the worktree. When already on the target branch or in the primary worktree, the worktree is preserved.
8. **Post-remove + post-merge hooks** — Run in background after cleanup.
@@ -95,57 +105,57 @@ lint = "cargo clippy"
## See also
-- [`wt step`](@/step.md) — Run individual operations (commit, squash, rebase, push)
-- [`wt remove`](@/remove.md) — Remove worktrees without merging
-- [`wt switch`](@/switch.md) — Navigate to other worktrees
+- [`wt step`](/step/) — Run individual operations (commit, squash, rebase, push)
+- [`wt remove`](/remove/) — Remove worktrees without merging
+- [`wt switch`](/switch/) — Navigate to other worktrees
## Command reference
-{% terminal() %}
+```
wt merge - Merge current branch into the target branch
-Squash &amp; rebase, fast-forward the target branch, remove the worktree.
+Squash & rebase, fast-forward the target branch, remove the worktree.
-Usage: <b><span class=c>wt merge</span></b> <span class=c>[OPTIONS]</span> <span class=c>[TARGET]</span>
+Usage: wt merge [OPTIONS] [TARGET]
-<b><span class=g>Arguments:</span></b>
- <span class=c>[TARGET]</span>
+Arguments:
+ [TARGET]
Target branch
Defaults to default branch.
-<b><span class=g>Options:</span></b>
- <b><span class=c>--no-squash</span></b>
+Options:
+ --no-squash
Skip commit squashing
- <b><span class=c>--no-commit</span></b>
+ --no-commit
Skip commit and squash
- <b><span class=c>--no-rebase</span></b>
+ --no-rebase
Skip rebase; require the target to fast-forward to the resulting tip
- <b><span class=c>--no-remove</span></b>
+ --no-remove
Keep worktree after merge
- <b><span class=c>--no-ff</span></b>
+ --no-ff
Create a merge commit (no fast-forward)
- <b><span class=c>--stage</span></b><span class=c> &lt;STAGE&gt;</span>
+ --stage <STAGE>
What to stage before committing [default: all]
Possible values:
- - <b><span class=c>all</span></b>: Stage everything: untracked files + unstaged tracked changes
- - <b><span class=c>tracked</span></b>: Stage tracked changes only (like <b>git add -u</b>)
- - <b><span class=c>none</span></b>: Stage nothing, commit only what&#39;s already in the index
+ - all: Stage everything: untracked files + unstaged tracked changes
+ - tracked: Stage tracked changes only (like git add -u)
+ - none: Stage nothing, commit only what's already in the index
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Automation:</span></b>
- <b><span class=c>--no-hooks</span></b>
+Automation:
+ --no-hooks
Skip hooks
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+ --format <FORMAT>
Output format
JSON prints structured result to stdout after merge completes.
@@ -153,23 +163,23 @@ Usage: <b><span class=c>wt merge</span></b> <span class=c>[OPTIONS]</span> <span
[default: text]
[possible values: text, json]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
<!-- END AUTO-GENERATED -->
diff --git a/docs/content/remove.md b/docs/src/content/docs/remove.md
similarity index 73%
rename from docs/content/remove.md
rename to docs/src/content/docs/remove.md
index 6b14753f4..d33275cbf 100644
--- a/docs/content/remove.md
+++ b/docs/src/content/docs/remove.md
@@ -1,12 +1,9 @@
-+++
-title = "wt remove"
-description = "Remove worktree; delete branch if merged. Defaults to the current worktree."
-weight = 12
-
-[extra]
-group = "Commands"
-+++
-
+---
+title: "wt remove"
+description: "Remove worktree; delete branch if merged. Defaults to the current worktree."
+sidebar:
+ order: 12
+---
<!-- ⚠️ AUTO-GENERATED from `wt remove --help-page` — edit src/cli/mod.rs to update -->
Remove worktree; delete branch if merged. Defaults to the current worktree.
@@ -15,25 +12,33 @@ Remove worktree; delete branch if merged. Defaults to the current worktree.
Remove current worktree:
-{% terminal(cmd="wt remove") %}
-<span class=c>◎</span> <span class=c>Running pre-remove <b>project:cleanup</b></span>
-<span style='background:var(--bright-white,#fff)'> </span> <span class=d><span style='color:var(--blue,#00a)'>flyctl</span></span><span class=d> scale count 0</span>
+```console
+$ wt remove
+◎ Running pre-remove project:cleanup
+ flyctl scale count 0
Scaling app to 0 machines
-<span class=c>◎</span> <span class=c>Removing <b>api</b> worktree &amp; branch in background (same commit as <b>main</b>,</span> <span class=d>_</span><span class=c>)</span>
-<span class=d>○</span> Switched to worktree for <b>main</b> @ <b>~/repo</b>
-{% end %}
+◎ Removing api worktree & branch in background (same commit as main, _)
+○ Switched to worktree for main @ ~/repo
+```
Remove specific worktrees / branches:
-{{ terminal(cmd="wt remove feature-branch|||wt remove old-feature another-branch") }}
+```console
+$ wt remove feature-branch
+$ wt remove old-feature another-branch
+```
Keep the branch:
-{{ terminal(cmd="wt remove --no-delete-branch feature-branch") }}
+```console
+$ wt remove --no-delete-branch feature-branch
+```
Force-delete an unmerged branch:
-{{ terminal(cmd="wt remove -D experimental") }}
+```console
+$ wt remove -D experimental
+```
## Branch cleanup
@@ -65,7 +70,11 @@ Worktrunk has two force flags for different situations:
| `--force` (`-f`) | Worktree | Worktree has uncommitted changes |
| `--force-delete` (`-D`) | Branch | Branch has unmerged commits |
-{{ terminal(cmd="wt remove feature --force # Remove dirty worktree|||wt remove feature -D # Delete unmerged branch|||wt remove feature --force -D # Both") }}
+```console
+$ wt remove feature --force # Remove dirty worktree
+$ wt remove feature -D # Delete unmerged branch
+$ wt remove feature --force -D # Both
+```
Use `--no-delete-branch` to keep the branch regardless of merge status.
@@ -81,18 +90,19 @@ After each `wt remove`, entries in `.git/wt/trash/` older than 24 hours are swep
`--reap` terminates processes left running in the worktree before it is removed — a `post-start` dev server, a file watcher, a language server — freeing the ports and file handles they hold. Processes are discovered by working directory: any process whose current directory is at or under the worktree path (`SIGTERM`, then `SIGKILL` for survivors).
-{% terminal(cmd="wt remove --reap feature") %}
+```console
+$ wt remove --reap feature
◎ Reaping 2 processes under feature worktree
┃ 51234 node
┃ 51240 esbuild
✓ Reaped 2 processes
◎ Removing feature worktree & branch in background (same commit as main, _)
-{% end %}
+```
To avoid killing work the user did not mean to kill, two guards keep `--reap` conservative:
- **Interactive processes are spared.** A process holding a controlling terminal — an interactive shell, or a terminal editor such as `vim` with unsaved buffers — is never reaped. Only detached processes remain candidates.
-- **Discovery is by working directory only.** A process that started in the worktree and later changed directory, or a daemon that reparented to `init`, no longer reports a directory under the worktree and is not found. To reliably reap those, launch them with [`wt step tether`](@/step.md#wt-step-tether), which kills the whole process group when the worktree is removed.
+- **Discovery is by working directory only.** A process that started in the worktree and later changed directory, or a daemon that reparented to `init`, no longer reports a directory under the worktree and is not found. To reliably reap those, launch them with [`wt step tether`](/step/#wt-step-tether), which kills the whole process group when the worktree is removed.
Reaping runs before the worktree directory is touched, so it is independent of foreground/background removal and the `--force` flag. Unix only; on Windows `--reap` is rejected.
@@ -114,7 +124,7 @@ Reaping runs before the worktree directory is touched, so it is independent of f
## Hooks
-`pre-remove` hooks run before the worktree is deleted (with access to worktree files). `post-remove` hooks run after removal. See [`wt hook`](@/hook.md) for configuration.
+`pre-remove` hooks run before the worktree is deleted (with access to worktree files). `post-remove` hooks run after removal. See [`wt hook`](/hook/) for configuration.
## Detached HEAD worktrees
@@ -122,53 +132,53 @@ Detached worktrees have no branch name. Pass the worktree path instead: `wt remo
## See also
-- [`wt merge`](@/merge.md) — Remove worktree after merging
-- [`wt list`](@/list.md) — View all worktrees
+- [`wt merge`](/merge/) — Remove worktree after merging
+- [`wt list`](/list/) — View all worktrees
## Command reference
-{% terminal() %}
+```
wt remove - Remove worktree; delete branch if merged
Defaults to the current worktree.
-Usage: <b><span class=c>wt remove</span></b> <span class=c>[OPTIONS]</span> <span class=c>[BRANCHES]...</span>
+Usage: wt remove [OPTIONS] [BRANCHES]...
-<b><span class=g>Arguments:</span></b>
- <span class=c>[BRANCHES]...</span>
+Arguments:
+ [BRANCHES]...
Branch name or worktree path [default: current]
-<b><span class=g>Options:</span></b>
- <b><span class=c>--no-delete-branch</span></b>
+Options:
+ --no-delete-branch
Keep branch after removal
- <b><span class=c>-D</span></b>, <b><span class=c>--force-delete</span></b>
+ -D, --force-delete
Delete unmerged branches
- <b><span class=c>--foreground</span></b>
+ --foreground
Run removal in foreground (block until complete)
- <b><span class=c>--reap</span></b>
+ --reap
Kill processes started in the worktree [experimental]
Before removal, terminate processes whose working directory is under the worktree — dev
servers, watchers, language servers. Processes holding a controlling terminal (interactive
shells, terminal editors) are left alone. Unix only.
- <b><span class=c>-f</span></b>, <b><span class=c>--force</span></b>
+ -f, --force
Force worktree removal
Remove a dirty worktree, including staged, modified, and untracked files. Without this
flag, removal fails if the worktree has any uncommitted changes.
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Automation:</span></b>
- <b><span class=c>--no-hooks</span></b>
+Automation:
+ --no-hooks
Skip hooks
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+ --format <FORMAT>
Output format
JSON prints structured result to stdout after removal completes.
@@ -176,23 +186,23 @@ Usage: <b><span class=c>wt remove</span></b> <span class=c>[OPTIONS]</span> <spa
[default: text]
[possible values: text, json]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
<!-- END AUTO-GENERATED -->
diff --git a/docs/content/step.md b/docs/src/content/docs/step.md
similarity index 60%
rename from docs/content/step.md
rename to docs/src/content/docs/step.md
index ab46cefef..53e883be2 100644
--- a/docs/content/step.md
+++ b/docs/src/content/docs/step.md
@@ -1,12 +1,9 @@
-+++
-title = "wt step"
-description = "Run individual operations. The building blocks of wt merge — commit, squash, rebase, push — plus standalone utilities."
-weight = 16
-
-[extra]
-group = "Commands"
-+++
-
+---
+title: "wt step"
+description: "Run individual operations. The building blocks of wt merge — commit, squash, rebase, push — plus standalone utilities."
+sidebar:
+ order: 16
+---
<!-- ⚠️ AUTO-GENERATED from `wt step --help-page` — edit src/cli/mod.rs to update -->
Run individual operations. The building blocks of wt merge — commit, squash, rebase, push — plus standalone utilities.
@@ -15,20 +12,26 @@ Run individual operations. The building blocks of wt merge — commit, squash, r
Commit with LLM-generated message:
-{% terminal(cmd="wt step commit") %}
-<span class=c>◎</span> <span class=c>Generating commit message and committing changes... <span style='color:var(--bright-black,#555)'>(2 files, <span class=g>+26</span></span></span><span style='color:var(--bright-black,#555)'>)</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>feat(validation): add input validation utilities</b>
-<span class=g>✓</span> <span class=g>Committed changes @ <span class=d>a1b2c3d</span></span>
-{% end %}
+```console
+$ wt step commit
+◎ Generating commit message and committing changes... (2 files, +26)
+ feat(validation): add input validation utilities
+✓ Committed changes @ a1b2c3d
+```
Manual merge workflow with review between steps:
-{{ terminal(cmd="wt step commit|||wt step squash|||wt step rebase|||wt step push") }}
+```console
+$ wt step commit
+$ wt step squash
+$ wt step rebase
+$ wt step push
+```
## Operations
-- [`commit`](#wt-step-commit) — Stage and commit with [LLM-generated message](@/llm-commits.md)
-- [`squash`](#wt-step-squash) — Squash all branch commits into one with [LLM-generated message](@/llm-commits.md)
+- [`commit`](#wt-step-commit) — Stage and commit with [LLM-generated message](/llm-commits/)
+- [`squash`](#wt-step-squash) — Squash all branch commits into one with [LLM-generated message](/llm-commits/)
- [`rebase`](#wt-step-rebase) — Rebase onto target branch
- [`push`](#wt-step-push) — Fast-forward target to current branch
- [`diff`](#wt-step-diff) — Show all changes since branching (committed, staged, unstaged, untracked)
@@ -39,60 +42,60 @@ Manual merge workflow with review between steps:
- [`prune`](#wt-step-prune) — Remove worktrees and branches merged into the default branch
- [`relocate`](#wt-step-relocate) — <span class="badge-experimental"></span> Move worktrees to expected paths
- [`tether`](#wt-step-tether) — <span class="badge-experimental"></span> Run a command; kill its whole process tree when its worktree is removed
-- [`<alias>`](@/extending.md#aliases) — Run a configured command alias
+- [`<alias>`](/extending/#aliases) — Run a configured command alias
## See also
-- [`wt merge`](@/merge.md) — Runs commit → squash → rebase → hooks → push → cleanup automatically
-- [`wt hook`](@/hook.md) — Run configured hooks
-- [Aliases](@/extending.md#aliases) — Custom command templates run as `wt <name>`
+- [`wt merge`](/merge/) — Runs commit → squash → rebase → hooks → push → cleanup automatically
+- [`wt hook`](/hook/) — Run configured hooks
+- [Aliases](/extending/#aliases) — Custom command templates run as `wt <name>`
## Command reference
-{% terminal() %}
+```
wt step - Run individual operations
-The building blocks of <b>wt merge</b> — commit, squash, rebase, push — plus standalone utilities.
-
-Usage: <b><span class=c>wt step</span></b> <span class=c>[OPTIONS]</span> <span class=c>&lt;COMMAND&gt;</span>
-
-<b><span class=g>Commands:</span></b>
- <b><span class=c>commit</span></b> Stage and commit with LLM-generated message
- <b><span class=c>squash</span></b> Squash commits since branching
- <b><span class=c>rebase</span></b> Rebase onto target
- <b><span class=c>push</span></b> Fast-forward target to current branch
- <b><span class=c>diff</span></b> Show all changes since branching
- <b><span class=c>copy-ignored</span></b> Copy gitignored files to another worktree
- <b><span class=c>eval</span></b> [experimental] Evaluate a template expression
- <b><span class=c>for-each</span></b> [experimental] Run command in each worktree
- <b><span class=c>promote</span></b> [experimental] Swap a branch into the main worktree
- <b><span class=c>prune</span></b> [experimental] Remove worktrees merged into the default branch
- <b><span class=c>relocate</span></b> [experimental] Move worktrees to expected paths
- <b><span class=c>tether</span></b> [experimental] Run a command; kill its whole process tree when its worktree is
+The building blocks of wt merge — commit, squash, rebase, push — plus standalone utilities.
+
+Usage: wt step [OPTIONS] <COMMAND>
+
+Commands:
+ commit Stage and commit with LLM-generated message
+ squash Squash commits since branching
+ rebase Rebase onto target
+ push Fast-forward target to current branch
+ diff Show all changes since branching
+ copy-ignored Copy gitignored files to another worktree
+ eval [experimental] Evaluate a template expression
+ for-each [experimental] Run command in each worktree
+ promote [experimental] Swap a branch into the main worktree
+ prune [experimental] Remove worktrees merged into the default branch
+ relocate [experimental] Move worktrees to expected paths
+ tether [experimental] Run a command; kill its whole process tree when its worktree is
removed
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
# Subcommands
@@ -100,7 +103,7 @@ Usage: <b><span class=c>wt step</span></b> <span class=c>[OPTIONS]</span> <span
Stage and commit with LLM-generated message.
-See [LLM-generated commit messages](@/llm-commits.md) for configuration and prompt customization.
+See [LLM-generated commit messages](/llm-commits/) for configuration and prompt customization.
### Options
@@ -114,7 +117,9 @@ Controls what to stage before committing:
| `tracked` | Stage only modified tracked files |
| `none` | Don't stage anything, commit only what's already staged |
-{{ terminal(cmd="wt step commit --stage=tracked") }}
+```console
+$ wt step commit --stage=tracked
+```
Configure the default in user config:
@@ -127,40 +132,42 @@ stage = "tracked"
Render the prompt, print the LLM command, generate the message, and exit without staging, running hooks, or committing:
-{{ terminal(cmd="wt step commit --dry-run") }}
+```console
+$ wt step commit --dry-run
+```
Three sections are printed: the rendered prompt, the shell command that would invoke the LLM, and the message returned. The LLM call still happens — only the commit is skipped.
### Command reference
-{% terminal() %}
+```
wt step commit - Stage and commit with LLM-generated message
-Usage: <b><span class=c>wt step commit</span></b> <span class=c>[OPTIONS]</span>
+Usage: wt step commit [OPTIONS]
-<b><span class=g>Options:</span></b>
- <b><span class=c>-b</span></b>, <b><span class=c>--branch</span></b><span class=c> &lt;BRANCH&gt;</span>
+Options:
+ -b, --branch <BRANCH>
Branch to operate on (defaults to current worktree)
- <b><span class=c>--stage</span></b><span class=c> &lt;STAGE&gt;</span>
+ --stage <STAGE>
What to stage before committing [default: all]
Possible values:
- - <b><span class=c>all</span></b>: Stage everything: untracked files + unstaged tracked changes
- - <b><span class=c>tracked</span></b>: Stage tracked changes only (like <b>git add -u</b>)
- - <b><span class=c>none</span></b>: Stage nothing, commit only what&#39;s already in the index
+ - all: Stage everything: untracked files + unstaged tracked changes
+ - tracked: Stage tracked changes only (like git add -u)
+ - none: Stage nothing, commit only what's already in the index
- <b><span class=c>--dry-run</span></b>
+ --dry-run
Preview prompt, command, and generated message without committing
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Automation:</span></b>
- <b><span class=c>--no-hooks</span></b>
+Automation:
+ --no-hooks
Skip hooks
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+ --format <FORMAT>
Output format
JSON prints structured result to stdout after the commit completes.
@@ -168,30 +175,30 @@ Usage: <b><span class=c>wt step commit</span></b> <span class=c>[OPTIONS]</span>
[default: text]
[possible values: text, json]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt step squash
Squash commits since branching. Stages changes and generates message with LLM.
-See [LLM-generated commit messages](@/llm-commits.md) for configuration and prompt customization.
+See [LLM-generated commit messages](/llm-commits/) for configuration and prompt customization.
### Options
@@ -205,7 +212,9 @@ Controls what to stage before squashing:
| `tracked` | Stage only modified tracked files |
| `none` | Don't stage anything, squash only committed changes |
-{{ terminal(cmd="wt step squash --stage=none") }}
+```console
+$ wt step squash --stage=none
+```
Configure the default in user config:
@@ -218,45 +227,47 @@ stage = "tracked"
Render the prompt, print the LLM command, generate the squash message, and exit without resetting, running hooks, or committing:
-{{ terminal(cmd="wt step squash --dry-run") }}
+```console
+$ wt step squash --dry-run
+```
Three sections are printed: the rendered prompt, the shell command that would invoke the LLM, and the message returned. The LLM call still happens — only the squash and commit are skipped.
### Command reference
-{% terminal() %}
+```
wt step squash - Squash commits since branching
Stages changes and generates message with LLM.
-Usage: <b><span class=c>wt step squash</span></b> <span class=c>[OPTIONS]</span> <span class=c>[TARGET]</span>
+Usage: wt step squash [OPTIONS] [TARGET]
-<b><span class=g>Arguments:</span></b>
- <span class=c>[TARGET]</span>
+Arguments:
+ [TARGET]
Target branch
Defaults to default branch.
-<b><span class=g>Options:</span></b>
- <b><span class=c>--stage</span></b><span class=c> &lt;STAGE&gt;</span>
+Options:
+ --stage <STAGE>
What to stage before committing [default: all]
Possible values:
- - <b><span class=c>all</span></b>: Stage everything: untracked files + unstaged tracked changes
- - <b><span class=c>tracked</span></b>: Stage tracked changes only (like <b>git add -u</b>)
- - <b><span class=c>none</span></b>: Stage nothing, commit only what&#39;s already in the index
+ - all: Stage everything: untracked files + unstaged tracked changes
+ - tracked: Stage tracked changes only (like git add -u)
+ - none: Stage nothing, commit only what's already in the index
- <b><span class=c>--dry-run</span></b>
+ --dry-run
Preview prompt, command, and generated message without squashing
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Automation:</span></b>
- <b><span class=c>--no-hooks</span></b>
+Automation:
+ --no-hooks
Skip hooks
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+ --format <FORMAT>
Output format
JSON prints structured result to stdout after the squash completes.
@@ -264,24 +275,24 @@ Usage: <b><span class=c>wt step squash</span></b> <span class=c>[OPTIONS]</span>
[default: text]
[possible values: text, json]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt step rebase
@@ -293,7 +304,11 @@ The target is any commit: a branch, a tag, a SHA.
### Examples
-{{ terminal(cmd="wt step rebase # Rebase onto default branch|||wt step rebase develop # Rebase onto develop|||wt step rebase v1.2.0 # Rebase onto a tag") }}
+```console
+$ wt step rebase # Rebase onto default branch
+$ wt step rebase develop # Rebase onto develop
+$ wt step rebase v1.2.0 # Rebase onto a tag
+```
### Outcomes
@@ -307,7 +322,7 @@ The first matching row wins:
A branch that merged the target into itself still rebases: the target is its ancestor, but the merge commit in between keeps the first row from applying.
-When the target's local ref lags its upstream, the rows are measured against that upstream, which the result then names in place of the argument. [`wt merge`](@/merge.md) covers why.
+When the target's local ref lags its upstream, the rows are measured against that upstream, which the result then names in place of the argument. [`wt merge`](/merge/) covers why.
### Conflicts
@@ -315,23 +330,23 @@ A conflicting commit leaves the rebase open rather than undoing it. The worktree
### Command reference
-{% terminal() %}
+```
wt step rebase - Rebase onto target
-Usage: <b><span class=c>wt step rebase</span></b> <span class=c>[OPTIONS]</span> <span class=c>[TARGET]</span>
+Usage: wt step rebase [OPTIONS] [TARGET]
-<b><span class=g>Arguments:</span></b>
- <span class=c>[TARGET]</span>
+Arguments:
+ [TARGET]
Target branch, tag, or commit
Defaults to default branch.
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Automation:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Automation:
+ --format <FORMAT>
Output format
JSON prints structured result to stdout after the rebase completes.
@@ -339,24 +354,24 @@ Usage: <b><span class=c>wt step rebase</span></b> <span class=c>[OPTIONS]</span>
[default: text]
[possible values: text, json]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt step push
@@ -368,7 +383,11 @@ The target is a branch, and must already be an ancestor of the current branch. O
### Examples
-{{ terminal(cmd="wt step push # Fast-forward main to current branch|||wt step push develop # Fast-forward develop instead|||wt step push --no-ff # Merge commit instead of a fast-forward") }}
+```console
+$ wt step push # Fast-forward main to current branch
+$ wt step push develop # Fast-forward develop instead
+$ wt step push --no-ff # Merge commit instead of a fast-forward
+```
### Target worktree
@@ -378,26 +397,26 @@ A worktree that is still registered but whose directory is gone is refused as we
### Command reference
-{% terminal() %}
+```
wt step push - Fast-forward target to current branch
-Usage: <b><span class=c>wt step push</span></b> <span class=c>[OPTIONS]</span> <span class=c>[TARGET]</span>
+Usage: wt step push [OPTIONS] [TARGET]
-<b><span class=g>Arguments:</span></b>
- <span class=c>[TARGET]</span>
+Arguments:
+ [TARGET]
Target branch
Defaults to default branch.
-<b><span class=g>Options:</span></b>
- <b><span class=c>--no-ff</span></b>
+Options:
+ --no-ff
Create a merge commit (no fast-forward)
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Automation:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Automation:
+ --format <FORMAT>
Output format
JSON prints structured result to stdout after the push completes.
@@ -405,24 +424,24 @@ Usage: <b><span class=c>wt step push</span></b> <span class=c>[OPTIONS]</span> <
[default: text]
[possible values: text, json]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt step diff
@@ -434,7 +453,9 @@ This is what `wt merge` would include — a single diff against the merge base.
`--branch` diffs another worktree's branch without leaving the current one:
-{{ terminal(cmd="wt step diff --branch feature") }}
+```console
+$ wt step diff --branch feature
+```
The branch must have a checked-out worktree.
@@ -442,63 +463,73 @@ The branch must have a checked-out worktree.
Arguments after `--` are forwarded to `git diff`:
-{{ terminal(cmd="wt step diff -- --stat|||wt step diff -- --name-only|||wt step diff -- -- '*.rs'") }}
+```console
+$ wt step diff -- --stat
+$ wt step diff -- --name-only
+$ wt step diff -- -- '*.rs'
+```
The diff is pipeable to tools like `delta`:
-{{ terminal(cmd="wt step diff | delta") }}
+```console
+$ wt step diff | delta
+```
### How it works
Equivalent to:
-{{ terminal(cmd="cp __WT_QUOT__$(git rev-parse --git-dir)/index__WT_QUOT__ /tmp/idx|||GIT_INDEX_FILE=/tmp/idx git add --intent-to-add .|||GIT_INDEX_FILE=/tmp/idx git diff $(git merge-base HEAD $(wt config state default-branch))") }}
+```console
+$ cp "$(git rev-parse --git-dir)/index" /tmp/idx
+$ GIT_INDEX_FILE=/tmp/idx git add --intent-to-add .
+$ GIT_INDEX_FILE=/tmp/idx git diff $(git merge-base HEAD $(wt config state default-branch))
+```
`git diff` ignores untracked files. `git add --intent-to-add .` registers them in the index without staging their content, making them visible to `git diff`. This runs against a copy of the real index so the original is never modified.
### Command reference
-{% terminal() %}
+```
wt step diff - Show all changes since branching
Includes committed, staged, unstaged, and untracked files.
-Usage: <b><span class=c>wt step diff</span></b> <span class=c>[OPTIONS]</span> <span class=c>[TARGET]</span> <b><span class=c>[--</span></b> <span class=c>&lt;EXTRA_ARGS&gt;...</span><b><span class=c>]</span></b>
+Usage: wt step diff [OPTIONS] [TARGET] [-- <EXTRA_ARGS>...]
-<b><span class=g>Arguments:</span></b>
- <span class=c>[TARGET]</span>
+Arguments:
+ [TARGET]
Target branch
Defaults to default branch.
- <span class=c>[EXTRA_ARGS]...</span>
- Extra arguments forwarded to <b>git diff</b>
+ [EXTRA_ARGS]...
+ Extra arguments forwarded to git diff
-<b><span class=g>Options:</span></b>
- <b><span class=c>-b</span></b>, <b><span class=c>--branch</span></b><span class=c> &lt;BRANCH&gt;</span>
+Options:
+ -b, --branch <BRANCH>
Branch to operate on (defaults to current worktree)
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt step copy-ignored
@@ -536,7 +567,9 @@ exclude = [".cache/", ".turbo/"]
To copy nothing unless `.worktreeinclude` exists — matching Claude Code desktop, where the file is required — pass `--require-include`:
-{{ terminal(cmd="wt step copy-ignored --require-include") }}
+```console
+$ wt step copy-ignored --require-include
+```
Without `.worktreeinclude`, the command is a no-op (it reports that nothing was copied and why). With the file present, only matching files copy as above. To apply this across every repository, put the flag in a user-config hook: `post-start = "wt step copy-ignored --require-include"`.
@@ -597,38 +630,38 @@ The `.worktreeinclude` pattern is shared with [Claude Code on desktop](https://c
### Command reference
-{% terminal() %}
+```
wt step copy-ignored - Copy gitignored files to another worktree
Eliminates cold starts by copying build caches and dependencies.
-Usage: <b><span class=c>wt step copy-ignored</span></b> <span class=c>[OPTIONS]</span>
+Usage: wt step copy-ignored [OPTIONS]
-<b><span class=g>Options:</span></b>
- <b><span class=c>--from</span></b><span class=c> &lt;FROM&gt;</span>
+Options:
+ --from <FROM>
Source worktree branch
Defaults to main worktree.
- <b><span class=c>--to</span></b><span class=c> &lt;TO&gt;</span>
+ --to <TO>
Destination worktree branch
Defaults to current worktree.
- <b><span class=c>--dry-run</span></b>
+ --dry-run
Show what would be copied
- <b><span class=c>--force</span></b>
+ --force
Overwrite existing files in destination
- <b><span class=c>--require-include</span></b>
+ --require-include
Require .worktreeinclude to copy anything
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Automation:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Automation:
+ --format <FORMAT>
Output format
JSON prints structured result to stdout after the copy completes.
@@ -636,24 +669,24 @@ Usage: <b><span class=c>wt step copy-ignored</span></b> <span class=c>[OPTIONS]<
[default: text]
[possible values: text, json]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt step eval
@@ -661,35 +694,41 @@ Usage: <b><span class=c>wt step copy-ignored</span></b> <span class=c>[OPTIONS]<
Evaluate a template expression. Prints the result to stdout for use in scripts and shell substitutions.
-All [hook template variables and filters](@/hook.md#template-variables) are available.
+All [hook template variables and filters](/hook/#template-variables) are available.
### Examples
Get the port for the current branch:
-{% terminal(cmd="wt step eval '__WT_OPEN__ branch | hash_port __WT_CLOSE__'") %}
+```console
+$ wt step eval '{{ branch | hash_port }}'
16066
-{% end %}
+```
Use in shell substitution:
-{{ terminal(cmd="curl http://localhost:$(wt step eval '__WT_OPEN__ branch | hash_port __WT_CLOSE__')/health") }}
+```console
+$ curl http://localhost:$(wt step eval '{{ branch | hash_port }}')/health
+```
Combine multiple values:
-{% terminal(cmd="wt step eval '__WT_OPEN__ branch | hash_port __WT_CLOSE__,__WT_OPEN__ (__WT_QUOT__supabase-api-__WT_QUOT__ ~ branch) | hash_port __WT_CLOSE__'") %}
+```console
+$ wt step eval '{{ branch | hash_port }},{{ ("supabase-api-" ~ branch) | hash_port }}'
16066,16739
-{% end %}
+```
Use conditionals and filters:
-{% terminal(cmd="wt step eval '__WT_OPEN__ branch | sanitize_db __WT_CLOSE__'") %}
+```console
+$ wt step eval '{{ branch | sanitize_db }}'
feature_auth_oauth2_a1b
-{% end %}
+```
List the available template variables with `-v` (alongside the expansion, on stderr):
-{% terminal(cmd="wt step eval -v '__WT_OPEN__ branch __WT_CLOSE__'") %}
+```console
+$ wt step eval -v '{{ branch }}'
○ eval template variables:
branch = feature/auth-oauth2
worktree_path = /home/user/projects/myapp-feature-auth-oauth2
@@ -699,52 +738,52 @@ List the available template variables with `-v` (alongside the expansion, on std
feature/auth-oauth2
feature/auth-oauth2
-{% end %}
+```
### Command reference
-{% terminal() %}
+```
wt step eval - [experimental] Evaluate a template expression
Prints the result to stdout for use in scripts and shell substitutions.
-Usage: <b><span class=c>wt step eval</span></b> <span class=c>[OPTIONS]</span> <span class=c>&lt;TEMPLATE&gt;</span>
+Usage: wt step eval [OPTIONS] <TEMPLATE>
-<b><span class=g>Arguments:</span></b>
- <span class=c>&lt;TEMPLATE&gt;</span>
+Arguments:
+ <TEMPLATE>
Template expression to evaluate
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Automation:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Automation:
+ --format <FORMAT>
Output format
- JSON prints <b>{name, template, result}</b> to stdout instead of the bare result.
+ JSON prints {name, template, result} to stdout instead of the bare result.
[default: text]
[possible values: text, json]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt step for-each
@@ -758,67 +797,77 @@ A summary of successes and failures is shown at the end. A template-expansion er
Arguments after `--` are the program and its arguments — run directly, no shell.
-{{ terminal(cmd="wt step for-each -- git status --short|||wt step for-each -- npm install") }}
+```console
+$ wt step for-each -- git status --short
+$ wt step for-each -- npm install
+```
For pipes, redirects, variables, or globs, wrap in `sh -c`:
-{{ terminal(cmd="wt step for-each -- sh -c 'git status | wc -l'|||wt step for-each -- sh -c 'echo $HOME && git pull'") }}
+```console
+$ wt step for-each -- sh -c 'git status | wc -l'
+$ wt step for-each -- sh -c 'echo $HOME && git pull'
+```
### Template variables
-Variables substitute into each argv element before exec. See [`wt hook` template variables](@/hook.md#template-variables) for the complete list and filters.
+Variables substitute into each argv element before exec. See [`wt hook` template variables](/hook/#template-variables) for the complete list and filters.
-{{ terminal(cmd="wt step for-each -- echo 'Branch: __WT_OPEN__ branch __WT_CLOSE__'") }}
+```console
+$ wt step for-each -- echo 'Branch: {{ branch }}'
+```
-Each element is expanded fresh in every worktree, so `{{ branch }}` is that worktree's branch. An alias wrapping for-each renders templates earlier, in the invoking worktree; [deferring expansion in an alias](@/extending.md#deferring-expansion-to-a-nested-wt-command) shows how to keep a variable per-worktree.
+Each element is expanded fresh in every worktree, so `{{ branch }}` is that worktree's branch. An alias wrapping for-each renders templates earlier, in the invoking worktree; [deferring expansion in an alias](/extending/#deferring-expansion-to-a-nested-wt-command) shows how to keep a variable per-worktree.
### Examples
Pull updates in worktrees with upstreams (skips others):
-{{ terminal(cmd="git fetch --prune && wt step for-each -- sh -c '[ __WT_QUOT__$(git rev-parse @{u} 2>/dev/null)__WT_QUOT__ ] || exit 0; git pull --autostash'") }}
+```console
+$ git fetch --prune && wt step for-each -- sh -c '[ "$(git rev-parse @{u} 2>/dev/null)" ] || exit 0; git pull --autostash'
+```
### Command reference
-{% terminal() %}
+```
wt step for-each - [experimental] Run command in each worktree
Executes sequentially with real-time output; continues past command failures.
-Usage: <b><span class=c>wt step for-each</span></b> <span class=c>[OPTIONS]</span> <b><span class=c>--</span></b> <span class=c>&lt;ARGS&gt;...</span>
+Usage: wt step for-each [OPTIONS] -- <ARGS>...
-<b><span class=g>Arguments:</span></b>
- <span class=c>&lt;ARGS&gt;...</span>
+Arguments:
+ <ARGS>...
Command template (see --help for all variables)
-<b><span class=g>Options:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Options:
+ --format <FORMAT>
Output format
[default: text]
[possible values: text, json]
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt step promote
@@ -830,7 +879,10 @@ Swap a branch into the main worktree. Exchanges branches and gitignored files be
### Example
-{{ terminal(cmd="# from ~/project (main worktree)|||wt step promote feature") }}
+```console
+# from ~/project (main worktree)
+$ wt step promote feature
+```
Before:
@@ -865,25 +917,25 @@ The swap uses `rename()` for each entry — fast regardless of entry size, since
### Command reference
-{% terminal() %}
+```
wt step promote - [experimental] Swap a branch into the main worktree
Exchanges branches and gitignored files between two worktrees.
-Usage: <b><span class=c>wt step promote</span></b> <span class=c>[OPTIONS]</span> <span class=c>[BRANCH]</span>
+Usage: wt step promote [OPTIONS] [BRANCH]
-<b><span class=g>Arguments:</span></b>
- <span class=c>[BRANCH]</span>
+Arguments:
+ [BRANCH]
Branch to promote to main worktree
Defaults to current branch, or default branch from main worktree.
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Automation:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Automation:
+ --format <FORMAT>
Output format
JSON prints structured result to stdout after the promote completes. The mismatch warning
@@ -892,24 +944,24 @@ Usage: <b><span class=c>wt step promote</span></b> <span class=c>[OPTIONS]</span
[default: text]
[possible values: text, json]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt step prune
@@ -927,68 +979,75 @@ Locked worktrees and the main worktree are always skipped. The current worktree
Worktrees younger than `--min-age` (default: 1 day) are skipped. This prevents removing a worktree just created from the default branch — it looks "merged" because its branch points at the same commit.
-{{ terminal(cmd="wt step prune --min-age=0s # no age guard|||wt step prune --min-age=2d # skip worktrees younger than 2 days") }}
+```console
+$ wt step prune --min-age=0s # no age guard
+$ wt step prune --min-age=2d # skip worktrees younger than 2 days
+```
### JSON output
-`--format=json` prints one object per candidate to stdout. The two modes report different things, and name their fields accordingly: a live run reports `branch_outcome`, the executed outcome, using the vocabulary [`wt remove`](@/remove.md#json-output) documents; `--dry-run` reports `branch_deleted`, its prediction of whether the removal would take the branch, since it runs nothing to have an outcome. A dry run also carries `reason` and `target` (why the candidate qualifies, and what it was measured against).
+`--format=json` prints one object per candidate to stdout. The two modes report different things, and name their fields accordingly: a live run reports `branch_outcome`, the executed outcome, using the vocabulary [`wt remove`](/remove/#json-output) documents; `--dry-run` reports `branch_deleted`, its prediction of whether the removal would take the branch, since it runs nothing to have an outcome. A dry run also carries `reason` and `target` (why the candidate qualifies, and what it was measured against).
### Examples
Preview what would be removed:
-{{ terminal(cmd="wt step prune --dry-run") }}
+```console
+$ wt step prune --dry-run
+```
Remove all merged worktrees:
-{{ terminal(cmd="wt step prune") }}
+```console
+$ wt step prune
+```
### Command reference
-{% terminal() %}
+```
wt step prune - [experimental] Remove worktrees merged into the default branch
-Usage: <b><span class=c>wt step prune</span></b> <span class=c>[OPTIONS]</span>
+Usage: wt step prune [OPTIONS]
-<b><span class=g>Options:</span></b>
- <b><span class=c>--dry-run</span></b>
+Options:
+ --dry-run
Show what would be removed
- <b><span class=c>--min-age</span></b><span class=c> &lt;MIN_AGE&gt;</span>
+ --min-age <MIN_AGE>
Skip worktrees younger than this
[default: 1d]
- <b><span class=c>--foreground</span></b>
+ --foreground
Run removal in foreground (block until complete)
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+ --format <FORMAT>
Output format
[default: text]
[possible values: text, json]
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt step relocate
@@ -1000,19 +1059,27 @@ Move worktrees to expected paths. Relocates worktrees whose path doesn't match t
Preview what would be moved:
-{{ terminal(cmd="wt step relocate --dry-run") }}
+```console
+$ wt step relocate --dry-run
+```
Move all mismatched worktrees:
-{{ terminal(cmd="wt step relocate") }}
+```console
+$ wt step relocate
+```
Auto-commit and clobber blockers (never fails):
-{{ terminal(cmd="wt step relocate --commit --clobber") }}
+```console
+$ wt step relocate --commit --clobber
+```
Move specific worktrees:
-{{ terminal(cmd="wt step relocate feature bugfix") }}
+```console
+$ wt step relocate feature bugfix
+```
### Swap handling
@@ -1048,35 +1115,35 @@ refuses), unless `--commit` is passed.
### Command reference
-{% terminal() %}
+```
wt step relocate - [experimental] Move worktrees to expected paths
-Relocates worktrees whose path doesn&#39;t match the <b>worktree-path</b> template.
+Relocates worktrees whose path doesn't match the worktree-path template.
-Usage: <b><span class=c>wt step relocate</span></b> <span class=c>[OPTIONS]</span> <span class=c>[BRANCHES]...</span>
+Usage: wt step relocate [OPTIONS] [BRANCHES]...
-<b><span class=g>Arguments:</span></b>
- <span class=c>[BRANCHES]...</span>
+Arguments:
+ [BRANCHES]...
Worktrees to relocate (defaults to all mismatched)
-<b><span class=g>Options:</span></b>
- <b><span class=c>--dry-run</span></b>
+Options:
+ --dry-run
Show what would be moved
- <b><span class=c>--commit</span></b>
+ --commit
Commit uncommitted changes before relocating
- <b><span class=c>--clobber</span></b>
+ --clobber
Backup non-worktree paths at target locations
- Moves blocking paths to <b>&lt;path&gt;.bak.&lt;timestamp&gt;</b>. If that name is taken, counts up (<b>…-2</b>, <b>…-3</b>
+ Moves blocking paths to <path>.bak.<timestamp>. If that name is taken, counts up (…-2, …-3
, …) to a free name.
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Automation:</span></b>
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+Automation:
+ --format <FORMAT>
Output format
JSON prints structured result to stdout after the relocate completes.
@@ -1084,24 +1151,24 @@ Usage: <b><span class=c>wt step relocate</span></b> <span class=c>[OPTIONS]</spa
[default: text]
[possible values: text, json]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
## wt step tether
@@ -1124,17 +1191,23 @@ worktree is gone.
Arguments after `--` are the program and its arguments, run directly, no shell.
-{{ terminal(cmd="wt step tether -- npm run dev") }}
+```console
+$ wt step tether -- npm run dev
+```
For pipes, redirects, variables, or globs, wrap in `sh -c`:
-{{ terminal(cmd="wt step tether -- sh -c 'PORT=$P npm run dev | tee dev.log'") }}
+```console
+$ wt step tether -- sh -c 'PORT=$P npm run dev | tee dev.log'
+```
To run the command from a subdirectory, pass the global `-C` flag (teardown
still watches the worktree root, so a server launched with a relative `-C` is
torn down with the worktree):
-{{ terminal(cmd="wt step tether -C frontend -- npm run dev") }}
+```console
+$ wt step tether -C frontend -- npm run dev
+```
### Examples
@@ -1148,38 +1221,38 @@ server = "wt step tether -- npm run dev -- --port {{ branch | hash_port }}"
### Command reference
-{% terminal() %}
+```
wt step tether - [experimental] Run a command; kill its whole process tree when its worktree is removed
-Teardown is automatic and needs no <b>pre-remove</b> hook; the group gets <b>SIGTERM</b> then <b>SIGKILL</b>.
+Teardown is automatic and needs no pre-remove hook; the group gets SIGTERM then SIGKILL.
-Usage: <b><span class=c>wt step tether</span></b> <span class=c>[OPTIONS]</span> <b><span class=c>--</span></b> <span class=c>&lt;COMMAND&gt;...</span>
+Usage: wt step tether [OPTIONS] -- <COMMAND>...
-<b><span class=g>Arguments:</span></b>
- <span class=c>&lt;COMMAND&gt;...</span>
- Command to run (after <b>--</b>, run directly, no shell)
+Arguments:
+ <COMMAND>...
+ Command to run (after --, run directly, no shell)
-<b><span class=g>Options:</span></b>
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+Options:
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
<!-- END AUTO-GENERATED -->
diff --git a/docs/content/switch.md b/docs/src/content/docs/switch.md
similarity index 64%
rename from docs/content/switch.md
rename to docs/src/content/docs/switch.md
index 32f1d9d2d..3736f2b87 100644
--- a/docs/content/switch.md
+++ b/docs/src/content/docs/switch.md
@@ -1,12 +1,9 @@
-+++
-title = "wt switch"
-description = "Switch to a worktree; create if needed."
-weight = 10
-
-[extra]
-group = "Commands"
-+++
-
+---
+title: "wt switch"
+description: "Switch to a worktree; create if needed."
+sidebar:
+ order: 10
+---
<!-- ⚠️ AUTO-GENERATED from `wt switch --help-page` — edit src/cli/mod.rs to update -->
Switch to a worktree; create if needed.
@@ -22,7 +19,14 @@ Worktrees are addressed by branch name; paths are computed from a configurable t
## Examples
-{{ terminal(cmd="wt switch feature-auth # Switch to worktree|||wt switch - # Previous worktree (like cd -)|||wt switch --create new-feature # Create new branch and worktree|||wt switch --create hotfix --base production|||wt switch pr:123 # Switch to PR #123's branch|||wt switch https://github.com/owner/repo/pull/123 # ...or paste the PR's URL") }}
+```console
+$ wt switch feature-auth # Switch to worktree
+$ wt switch - # Previous worktree (like cd -)
+$ wt switch --create new-feature # Create new branch and worktree
+$ wt switch --create hotfix --base production
+$ wt switch pr:123 # Switch to PR #123's branch
+$ wt switch https://github.com/owner/repo/pull/123 # ...or paste the PR's URL
+```
## Creating a branch
@@ -32,13 +36,18 @@ The `--create` flag creates a new branch from `--base` — the default branch un
If the branch already has a worktree, `wt switch` changes directories to it. Otherwise, it creates one:
-1. Runs [pre-switch hooks](@/hook.md#hook-types), blocking until complete
+1. Runs [pre-switch hooks](/hook/#hook-types), blocking until complete
2. Creates worktree at configured path
3. Switches to new directory
-4. Runs [pre-start hooks](@/hook.md#hook-types), blocking until complete
-5. Spawns [post-start](@/hook.md#hook-types) and [post-switch hooks](@/hook.md#hook-types) in the background
-
-{{ terminal(cmd="wt switch feature # Existing branch → creates worktree|||wt switch --create feature # New branch and worktree|||wt switch --create fix --base release # New branch from release|||wt switch --create temp --no-hooks # Skip hooks") }}
+4. Runs [pre-start hooks](/hook/#hook-types), blocking until complete
+5. Spawns [post-start](/hook/#hook-types) and [post-switch hooks](/hook/#hook-types) in the background
+
+```console
+$ wt switch feature # Existing branch → creates worktree
+$ wt switch --create feature # New branch and worktree
+$ wt switch --create fix --base release # New branch from release
+$ wt switch --create temp --no-hooks # Skip hooks
+```
## Naming a worktree
@@ -54,7 +63,14 @@ Worktrees are addressed by branch name, and every argument that takes one also a
| `pr:{N}` | GitHub PR #N's branch |
| `mr:{N}` | GitLab MR !N's branch |
-{{ terminal(cmd="wt switch - # Back to previous|||wt switch ^ # Default branch worktree|||wt switch --create fix --base=@ # Branch from current HEAD|||wt switch --create fix --base=pr:123 # Branch from PR #123's head|||wt switch pr:123 # PR #123's branch|||wt switch mr:101 # MR !101's branch") }}
+```console
+$ wt switch - # Back to previous
+$ wt switch ^ # Default branch worktree
+$ wt switch --create fix --base=@ # Branch from current HEAD
+$ wt switch --create fix --base=pr:123 # Branch from PR #123's head
+$ wt switch pr:123 # PR #123's branch
+$ wt switch mr:101 # MR !101's branch
+```
Shortcuts also apply to `--base`. For a fork PR/MR, the head commit is fetched and used as the base SHA without creating a tracking branch.
@@ -62,7 +78,7 @@ Shortcuts also apply to `--base`. For a fork PR/MR, the head commit is fetched a
When called without arguments, `wt switch` opens an interactive picker to browse and select worktrees with live preview. The candidate set widens with `--branches` (local branches without worktrees), `--remotes` (remote branches), and `--prs` (open PRs/MRs — see below).
-The CI column shows each row's PR/MR CI and review status, the same as [`wt list --full`](@/list.md).
+The CI column shows each row's PR/MR CI and review status, the same as [`wt list --full`](/list/).
<figure class="demo">
<picture>
@@ -104,7 +120,7 @@ Typing a gutter sigil filters by row kind: `+` narrows to linked worktrees and `
3. **committed** — Committed changes since the comparison base
4. **log** — Recent commits; commits already on the default branch have dimmed hashes
5. **remote⇅** — Ahead/behind diff vs upstream tracking branch
-6. **summary** — LLM-generated branch summary; requires `[list] summary = true` and [`commit.generation`](@/config.md#commit)
+6. **summary** — LLM-generated branch summary; requires `[list] summary = true` and [`commit.generation`](/config/#commit)
7. **pr** — The selected row's PR/MR, for any row whose branch has one
8. **comments** — The PR/MR's comment thread, fetched from the forge for any row whose branch has one
@@ -123,7 +139,13 @@ pager = "delta --paging=never --width=$COLUMNS"
The `pr:<number>` / `mr:<number>` shortcut and the PR/MR's web URL both resolve to its branch. For same-repo PRs/MRs, worktrunk switches to the branch directly. For fork PRs/MRs, it fetches the ref (`refs/pull/N/head` or `refs/merge-requests/N/head`) and configures `pushRemote` to the fork URL.
-{{ terminal(cmd="wt switch pr:101 # GitHub PR #101|||wt switch https://github.com/owner/repo/pull/101 # ...the same PR, by URL|||wt switch mr:101 # GitLab MR !101|||wt switch https://gitlab.com/owner/repo/-/merge_requests/101 # ...the same MR, by URL|||wt switch --prs # Browse open PRs/MRs in the picker") }}
+```console
+$ wt switch pr:101 # GitHub PR #101
+$ wt switch https://github.com/owner/repo/pull/101 # ...the same PR, by URL
+$ wt switch mr:101 # GitLab MR !101
+$ wt switch https://gitlab.com/owner/repo/-/merge_requests/101 # ...the same MR, by URL
+$ wt switch --prs # Browse open PRs/MRs in the picker
+```
Both work anywhere a branch is accepted, including `--base`. The `--create` flag cannot be used with a PR/MR reference since the branch already exists.
@@ -131,7 +153,7 @@ If the PR or MR is on a fork, the local branch uses its branch name directly, so
The `--prs` flag adds the repository's open PRs (GitHub) or MRs (GitLab) to the interactive picker — only the ones not already there: a PR whose branch is already shown (as a worktree, or a local or remote branch) isn't listed twice, so `--prs` only adds the rest and the two pickers differ solely by those extra rows. Each added row resolves to the same `pr:`/`mr:` shortcut, so selecting one fetches the ref and switches to its branch. A `--prs` row has no local worktree, so its `pr` and `comments` preview tabs load the PR/MR's metadata and comments from the forge in the background. The `log` tab uses a local `git log` — graph and merge-base dimming included — whenever the head commit is already in the object store (a same-repo PR off a fetched remote), falling back to a flat forge-fetched commit list otherwise.
-Requires `gh` (GitHub), `glab` (GitLab), or an equivalent CLI installed and authenticated; see [forge platform](@/config.md#forge-platform) for Gitea, Azure DevOps, and other supported platforms.
+Requires `gh` (GitHub), `glab` (GitLab), or an equivalent CLI installed and authenticated; see [forge platform](/config/#forge-platform) for Gitea, Azure DevOps, and other supported platforms.
## When wt switch fails
@@ -143,93 +165,93 @@ To change which branch a worktree is on, use `git switch` inside that worktree.
## See also
-- [`wt list`](@/list.md) — View all worktrees
-- [`wt remove`](@/remove.md) — Delete worktrees when done
-- [`wt merge`](@/merge.md) — Integrate changes back to the default branch
+- [`wt list`](/list/) — View all worktrees
+- [`wt remove`](/remove/) — Delete worktrees when done
+- [`wt merge`](/merge/) — Integrate changes back to the default branch
## Command reference
-{% terminal() %}
+```
wt switch - Switch to a worktree; create if needed
-Usage: <b><span class=c>wt switch</span></b> <span class=c>[OPTIONS]</span> <span class=c>[BRANCH]</span> <b><span class=c>[--</span></b> <span class=c>&lt;EXECUTE_ARGS&gt;...</span><b><span class=c>]</span></b>
+Usage: wt switch [OPTIONS] [BRANCH] [-- <EXECUTE_ARGS>...]
-<b><span class=g>Arguments:</span></b>
- <span class=c>[BRANCH]</span>
+Arguments:
+ [BRANCH]
Branch, worktree path, shortcut, or PR/MR URL
- Opens interactive picker if omitted. Shortcuts: <b>^</b> (default branch), <b>-</b> (previous), <b>@</b>
- (current), <b>pr:{N}</b> (GitHub PR), <b>mr:{N}</b> (GitLab MR)
+ Opens interactive picker if omitted. Shortcuts: ^ (default branch), - (previous), @
+ (current), pr:{N} (GitHub PR), mr:{N} (GitLab MR)
- <span class=c>[EXECUTE_ARGS]...</span>
+ [EXECUTE_ARGS]...
Additional arguments for --execute command (after --)
- Arguments after <b>--</b> are appended to the execute command. Each argument is expanded for
+ Arguments after -- are appended to the execute command. Each argument is expanded for
templates, then POSIX shell-escaped.
-<b><span class=g>Options:</span></b>
- <b><span class=c>-c</span></b>, <b><span class=c>--create</span></b>
+Options:
+ -c, --create
Create a new branch
- <b><span class=c>-b</span></b>, <b><span class=c>--base</span></b><span class=c> &lt;BASE&gt;</span>
+ -b, --base <BASE>
Base branch
- Defaults to default branch. Supports the same shortcuts as the branch argument: <b>^</b>, <b>@</b>, <b>-</b>,
-<b> pr:{N}</b>, <b>mr:{N}</b>.
+ Defaults to default branch. Supports the same shortcuts as the branch argument: ^, @, -,
+ pr:{N}, mr:{N}.
- <b><span class=c>-x</span></b>, <b><span class=c>--execute</span></b><span class=c> &lt;EXECUTE&gt;</span>
+ -x, --execute <EXECUTE>
Command to run after switch
Replaces the wt process with the command after switching, giving it full terminal control.
Useful for launching editors, AI agents, or other interactive tools.
Without a branch argument, the interactive picker opens and the command runs against the
- selected worktree — so <b>wt switch -x claude</b> picks a worktree, then launches Claude Code
+ selected worktree — so wt switch -x claude picks a worktree, then launches Claude Code
there.
- Supports <u>hook template variables</u> (<b>{{ branch }}</b>, <b>{{ worktree_path }}</b>, etc.) and filters. <b>{{</b>
-<b> base }}</b> and <b>{{ base_worktree_path }}</b> describe the source: the selected base with <b>--create</b>,
+ Supports hook template variables ({{ branch }}, {{ worktree_path }}, etc.) and filters. {{
+ base }} and {{ base_worktree_path }} describe the source: the selected base with --create,
or the invoking worktree when switching to an existing worktree.
Especially useful with shell aliases:
- <b><b>alias wsc=&#39;wt switch --create -x claude&#39;</b></b>
- <b>wsc feature-branch -- &#39;Fix GH #322&#39;</b>
+ alias wsc='wt switch --create -x claude'
+ wsc feature-branch -- 'Fix GH #322'
- Then <b>wsc feature-branch</b> creates the worktree and launches Claude Code. Arguments after <b>--</b>
- are passed to the command, so <b>wsc feature -- &#39;Fix GH #322&#39;</b> runs <b>claude &#39;Fix GH #322&#39;</b>,
+ Then wsc feature-branch creates the worktree and launches Claude Code. Arguments after --
+ are passed to the command, so wsc feature -- 'Fix GH #322' runs claude 'Fix GH #322',
starting Claude with a prompt.
- Template example: <b>-x code -- &#39;{{ worktree_path }}&#39;</b> opens VS Code at the worktree, <b>-x tmux</b>
-<b> -- new -s &#39;{{ branch | sanitize }}&#39;</b> starts a tmux session named after the branch.
+ Template example: -x code -- '{{ worktree_path }}' opens VS Code at the worktree, -x tmux
+ -- new -s '{{ branch | sanitize }}' starts a tmux session named after the branch.
- <b><span class=c>--clobber</span></b>
+ --clobber
Remove stale paths at target
- <b><span class=c>--no-cd</span></b>
+ --no-cd
Skip directory change after switching
Hooks still run normally. Useful when hooks handle navigation (e.g., tmux workflows) or
for CI/automation. Use --cd to override.
- <b><span class=c>-h</span></b>, <b><span class=c>--help</span></b>
- Print help (see a summary with &#39;-h&#39;)
+ -h, --help
+ Print help (see a summary with '-h')
-<b><span class=g>Picker Options:</span></b>
- <b><span class=c>--branches</span></b>
+Picker Options:
+ --branches
Include branches without worktrees
- <b><span class=c>--remotes</span></b>
+ --remotes
Include remote branches
- <b><span class=c>--prs</span></b>
+ --prs
Include open PRs/MRs
-<b><span class=g>Automation:</span></b>
- <b><span class=c>--no-hooks</span></b>
+Automation:
+ --no-hooks
Skip hooks
- <b><span class=c>--format</span></b><span class=c> &lt;FORMAT&gt;</span>
+ --format <FORMAT>
Output format
JSON prints structured result to stdout. Designed for tool integration (e.g., Claude Code
@@ -238,23 +260,23 @@ Usage: <b><span class=c>wt switch</span></b> <span class=c>[OPTIONS]</span> <spa
[default: text]
[possible values: text, json]
-<b><span class=g>Global Options:</span></b>
- <b><span class=c>-C</span></b><span class=c> &lt;path&gt;</span>
+Global Options:
+ -C <path>
Working directory for this command
- <b><span class=c>--config</span></b><span class=c> &lt;path&gt;</span>
+ --config <path>
User config file path
- <b><span class=c>--config-set</span></b><span class=c> &lt;toml&gt;</span>
+ --config-set <toml>
Override config with inline TOML, e.g. --config-set list.full=true (repeatable)
- <b><span class=c>-v</span></b>, <b><span class=c>--verbose</span></b><span class=c>...</span>
+ -v, --verbose...
Verbose output (-v: info logs + hook/alias template variables on stderr; -vv: also debug
logs and raw subprocess output written to .git/wt/logs/). Set WORKTRUNK_VERBOSE=0|1|2 to
apply the same level everywhere — including shell completion, which no flag can reach
- <b><span class=c>-y</span></b>, <b><span class=c>--yes</span></b>
+ -y, --yes
Skip approval prompts
-{% end %}
+```
<!-- END AUTO-GENERATED -->
diff --git a/docs/content/tips-patterns.md b/docs/src/content/docs/tips-patterns.md
similarity index 72%
rename from docs/content/tips-patterns.md
rename to docs/src/content/docs/tips-patterns.md
index cdc69d5f3..b00c9f2af 100644
--- a/docs/content/tips-patterns.md
+++ b/docs/src/content/docs/tips-patterns.md
@@ -1,23 +1,24 @@
-+++
-title = "Tips & Patterns"
-description = "Practical recipes for Worktrunk workflows: aliases, shell integration, Zellij layouts, and parallel agent patterns."
-weight = 24
-
-[extra]
-group = "Reference"
-+++
-
+---
+title: "Tips & Patterns"
+description: "Practical recipes for Worktrunk workflows: aliases, shell integration, Zellij layouts, and parallel agent patterns."
+sidebar:
+ order: 24
+---
Practical recipes for common Worktrunk workflows.
## Shell alias for new worktree + agent
Create a worktree and launch Claude in one command:
-{{ terminal(cmd="alias wsc='wt switch --create --execute=claude'|||wsc new-feature # Creates worktree, runs hooks, launches Claude|||wsc feature -- 'Fix GH #322' # Runs `claude 'Fix GH #322'`") }}
+```bash
+alias wsc='wt switch --create --execute=claude'
+wsc new-feature # Creates worktree, runs hooks, launches Claude
+wsc feature -- 'Fix GH #322' # Runs `claude 'Fix GH #322'`
+```
## `wt` aliases
-Compose with template filters and [vars](@/tips-patterns.md#per-branch-variables):
+Compose with template filters and [vars](/tips-patterns/#per-branch-variables):
```toml
# .config/wt.toml
@@ -32,17 +33,17 @@ test = "cargo test --features {{ vars.features | default('default') }}"
pick = "wt switch --format=json | jq -r '.branch'"
```
-See [Aliases](@/extending.md#aliases) for scoping, approval, and reference.
+See [Aliases](/extending/#aliases) for scoping, approval, and reference.
## Per-branch variables
`wt config state vars` holds state per branch, accessible from templates (`{{ vars.key }}`) and the CLI. Some uses:
-- **Coordinate state across pipeline steps** — see [Database per worktree](@/tips-patterns.md#database-per-worktree) below for a full recipe
+- **Coordinate state across pipeline steps** — see [Database per worktree](/tips-patterns/#database-per-worktree) below for a full recipe
- **Stick a branch to an environment** — `wt config state vars set env=staging`, then `{{ vars.env | default('dev') }}` in hooks
-- **Parametrize aliases per branch** — see [`wt` aliases above](@/tips-patterns.md#wt-aliases)
+- **Parametrize aliases per branch** — see [`wt` aliases above](/tips-patterns/#wt-aliases)
-See [`wt config state vars`](@/config.md#wt-config-state-vars) for storage format, JSON support, and reference.
+See [`wt config state vars`](/config/#wt-config-state-vars) for storage format, JSON support, and reference.
## Dev server per worktree
@@ -57,22 +58,22 @@ server = "wt step tether -- npm run dev -- --port {{ branch | hash_port }}"
url = "http://localhost:{{ branch | hash_port }}"
```
-[`wt step tether`](@/step.md#wt-step-tether) runs the server in its own process group and tears the whole group down when the worktree is removed, so no `pre-remove` hook is needed. See the [`wt step tether`](@/step.md#wt-step-tether) docs for the full rationale and platform behavior.
+[`wt step tether`](/step/#wt-step-tether) runs the server in its own process group and tears the whole group down when the worktree is removed, so no `pre-remove` hook is needed. See the [`wt step tether`](/step/#wt-step-tether) docs for the full rationale and platform behavior.
The URL column in `wt list` shows each worktree's dev server:
<!-- ⚠️ AUTO-GENERATED from tests/snapshots/integration__integration_tests__list__tips_dev_server_workflow.snap — edit source to update -->
-{% terminal(cmd="wt list") %}
-<span class="cmd">wt list</span>
- <b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Remote⇅</b> <b>URL</b> <b>Commit</b>
-@ main <span class=c>?</span> <span class=d>^</span><span class=d>⇅</span> <span class=g>⇡1</span> <span class=d><span class=r>⇣1</span></span> <span class=d>http://localhost:12107</span> <span class=d>41ee083</span>
-+ feature-api <span class=c>+</span> <span class=d>↕</span><span class=d>⇡</span> <span class=g>+54</span> <span class=r>-5</span> <span class=g>↑4</span> <span class=d><span class=r>↓1</span></span> <span class=g>+234</span> <span class=r>-24</span> <span class=g>⇡3</span> <span class=d>http://localhost:10703</span> <span class=d>6814f02</span>
-+ fix-auth <span class=d>↕</span><span class=d>|</span> <span class=g>↑2</span> <span class=d><span class=r>↓1</span></span> <span class=g>+25</span> <span class=r>-11</span> <span class=d>|</span> <span class=d>http://localhost:16460</span> <span class=d>b772e68</span>
-+ <span class=d>fix-typos</span> <span class=d>_</span><span class=d>|</span> <span class=d>|</span> <span class=d>http://localhost:14301</span> <span class=d>41ee083</span>
+```console
+$ wt list
+ Branch Status HEAD± main↕ main…± Remote⇅ URL Commit
+@ main ? ^⇅ ⇡1 ⇣1 http://localhost:12107 41ee083
++ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 ⇡3 http://localhost:10703 6814f02
++ fix-auth ↕| ↑2 ↓1 +25 -11 | http://localhost:16460 b772e68
++ fix-typos _| | http://localhost:14301 41ee083
-<span class=d>○</span> <span class=d>Showing 4 worktrees, 2 with changes, 2 ahead, 3 columns hidden</span>
-{% end %}
+○ Showing 4 worktrees, 2 with changes, 2 ahead, 3 columns hidden
+```
<!-- END AUTO-GENERATED -->
@@ -80,7 +81,7 @@ The URL column in `wt list` shows each worktree's dev server:
## Database per worktree
-Each worktree can have its own isolated database. A pipeline sets up names and ports as [vars](@/config.md#wt-config-state-vars), then later steps and hooks reference them:
+Each worktree can have its own isolated database. A pipeline sets up names and ports as [vars](/config/#wt-config-state-vars), then later steps and hooks reference them:
```toml
[[post-start]]
@@ -111,7 +112,9 @@ The `('db-' ~ branch)` concatenation hashes differently than plain `branch`, so
The connection string is accessible anywhere — not just in hooks:
-{{ terminal(cmd="DATABASE_URL=$(wt config state vars get db_url) npm start") }}
+```bash
+DATABASE_URL=$(wt config state vars get db_url) npm start
+```
## Per-worktree env vars
@@ -138,7 +141,7 @@ Both set real environment variables in the shell session, so every child process
## Eliminate cold starts
-Use [`wt step copy-ignored`](@/step.md#wt-step-copy-ignored) to copy gitignored files (caches, dependencies, `.env`) between worktrees:
+Use [`wt step copy-ignored`](/step/#wt-step-copy-ignored) to copy gitignored files (caches, dependencies, `.env`) between worktrees:
```toml
[post-start]
@@ -157,7 +160,7 @@ install = "pnpm install"
Use `pre-start` instead when an `--execute` command needs the copied files immediately.
-All gitignored files are copied by default. To limit what gets copied, create `.worktreeinclude` with patterns — files must be both gitignored and listed. See [`wt step copy-ignored`](@/step.md#wt-step-copy-ignored) for details.
+All gitignored files are copied by default. To limit what gets copied, create `.worktreeinclude` with patterns — files must be both gitignored and listed. See [`wt step copy-ignored`](/step/#wt-step-copy-ignored) for details.
## Manual commit messages
@@ -171,7 +174,7 @@ command = '''f=$(mktemp); printf '\n\n' > "$f"; sed 's/^/# /' >> "$f"; ${EDITOR:
This comments out the rendered prompt (diff, branch name, stats) with `#` prefixes, opens your editor, and strips comment lines on save. A couple of blank lines at the top give you space to type; the prompt context is visible below for reference.
-To keep the LLM as default but use the editor for a specific merge, add a [worktrunk alias](@/extending.md#aliases):
+To keep the LLM as default but use the editor for a specific merge, add a [worktrunk alias](/extending/#aliases):
```toml
# ~/.config/worktrunk/config.toml
@@ -183,7 +186,7 @@ Then `wt mc` opens an editor for the commit message while plain `wt merge` conti
## Track agent status
-Custom emoji markers show agent state in `wt list`. The [Claude Code](@/claude-code.md) plugin and [OpenCode plugin](https://github.com/max-sixty/worktrunk/tree/main/dev/opencode-plugin.ts) set these automatically:
+Custom emoji markers show agent state in `wt list`. The [Claude Code](/claude-code/) plugin and [OpenCode plugin](https://github.com/max-sixty/worktrunk/tree/main/dev/opencode-plugin.ts) set these automatically:
```
+ feature-api ↑ 🤖 ↑1 ./repo.feature-api
@@ -195,19 +198,25 @@ Custom emoji markers show agent state in `wt list`. The [Claude Code](@/claude-c
Set status manually for any workflow:
-{{ terminal(cmd="wt config state marker set __WT_QUOT__🚧__WT_QUOT__ # Current branch|||wt config state marker set __WT_QUOT__✅__WT_QUOT__ --branch feature # Specific branch|||git config worktrunk.state.feature.marker '{__WT_QUOT__marker__WT_QUOT__:__WT_QUOT__💬__WT_QUOT__,__WT_QUOT__set_at__WT_QUOT__:0}' # Direct") }}
+```bash
+wt config state marker set "🚧" # Current branch
+wt config state marker set "✅" --branch feature # Specific branch
+git config worktrunk.state.feature.marker '{"marker":"💬","set_at":0}' # Direct
+```
-See [Claude Code Integration](@/claude-code.md#installation) for plugin installation.
+See [Claude Code Integration](/claude-code/#installation) for plugin installation.
## Monitor CI across branches
-{{ terminal(cmd="wt list --full --branches") }}
+```bash
+wt list --full --branches
+```
Shows PR/CI status for all branches, including those without worktrees. CI indicators are clickable links to the PR page.
## LLM branch summaries
-With `summary = true` and [`commit.generation`](@/config.md#commit) configured, `wt list --full` shows an LLM-generated one-line summary for each branch. The same summaries appear in the `wt switch` picker (tab 5).
+With `summary = true` and [`commit.generation`](/config/#commit) configured, `wt list --full` shows an LLM-generated one-line summary for each branch. The same summaries appear in the `wt switch` picker (tab 5).
```toml
# ~/.config/worktrunk/config.toml
@@ -215,21 +224,25 @@ With `summary = true` and [`commit.generation`](@/config.md#commit) configured,
summary = true
```
-See [LLM Commits](@/llm-commits.md#branch-summaries) for details.
+See [LLM Commits](/llm-commits/#branch-summaries) for details.
## JSON API
-{{ terminal(cmd="wt list --format=json") }}
+```bash
+wt list --format=json
+```
-Structured output for dashboards, statuslines, and scripts. See [`wt list`](@/list.md) for query examples.
+Structured output for dashboards, statuslines, and scripts. See [`wt list`](/list/) for query examples.
## Reuse `default-branch`
-Default branch [detection](@/config.md#wt-config-state-default-branch) means scripts work on any repo — no need to hardcode `main` or `master`:
+Default branch [detection](/config/#wt-config-state-default-branch) means scripts work on any repo — no need to hardcode `main` or `master`:
-{{ terminal(cmd="git rebase $(wt config state default-branch)") }}
+```bash
+git rebase $(wt config state default-branch)
+```
-In hooks and aliases, the same value is the `{{ default_branch }}` [template variable](@/hook.md#template-variables); reserve this command for plain shell scripts.
+In hooks and aliases, the same value is the `{{ default_branch }}` [template variable](/hook/#template-variables); reserve this command for plain shell scripts.
## Task runners in hooks
@@ -277,29 +290,41 @@ fi
## Shortcuts
-Special arguments work across all commands—see [`wt switch`](@/switch.md#shortcuts) for the full list.
+Special arguments work across all commands—see [`wt switch`](/switch/#shortcuts) for the full list.
-{{ terminal(cmd="wt switch --create hotfix --base=@ # Branch from current HEAD|||wt switch - # Switch to previous worktree|||wt remove @ # Remove current worktree") }}
+```bash
+wt switch --create hotfix --base=@ # Branch from current HEAD
+wt switch - # Switch to previous worktree
+wt remove @ # Remove current worktree
+```
## Stacked branches
Branch from current HEAD instead of the default branch:
-{{ terminal(cmd="wt switch --create feature-part2 --base=@") }}
+```bash
+wt switch --create feature-part2 --base=@
+```
## Agent handoffs
Spawn a worktree with an agent CLI running in the background. Examples below use `claude`; for OpenCode, replace `claude` with `'opencode run'`.
**tmux** (new detached session):
-{{ terminal(cmd="tmux new-session -d -s fix-auth-bug __WT_QUOT__wt switch --create fix-auth-bug -x claude -- \||| 'The login session expires after 5 minutes. Find the session timeout config and extend it to 24 hours.'__WT_QUOT__") }}
+```bash
+tmux new-session -d -s fix-auth-bug "wt switch --create fix-auth-bug -x claude -- \
+ 'The login session expires after 5 minutes. Find the session timeout config and extend it to 24 hours.'"
+```
**Zellij** (new pane in current session):
-{{ terminal(cmd="zellij run -- wt switch --create fix-auth-bug -x claude -- \||| 'The login session expires after 5 minutes. Find the session timeout config and extend it to 24 hours.'") }}
+```bash
+zellij run -- wt switch --create fix-auth-bug -x claude -- \
+ 'The login session expires after 5 minutes. Find the session timeout config and extend it to 24 hours.'
+```
This lets one agent session hand off work to another that runs in the background. Hooks run inside the multiplexer session/pane.
-The [worktrunk skill](@/claude-code.md) includes guidance for Claude Code (and other agent CLIs that load it) to execute this pattern. To enable it, request it explicitly ("spawn a parallel worktree for...") or add to your project instructions (`CLAUDE.md` or `AGENTS.md`):
+The [worktrunk skill](/claude-code/) includes guidance for Claude Code (and other agent CLIs that load it) to execute this pattern. To enable it, request it explicitly ("spawn a parallel worktree for...") or add to your project instructions (`CLAUDE.md` or `AGENTS.md`):
```markdown
When I ask you to spawn parallel worktrees, use the agent handoff pattern
@@ -338,9 +363,9 @@ tmux = "tmux kill-session -t {{ branch | sanitize }} 2>/dev/null || true"
To create a worktree and immediately attach:
-{% terminal() %}
-<span class="cmd">wt switch --create feature -x tmux -- attach -t '{{ branch | sanitize }}'</span>
-{% end %}
+```console
+$ wt switch --create feature -x tmux -- attach -t '{{ branch | sanitize }}'
+```
## cmux workspace per worktree
@@ -434,13 +459,17 @@ url = "http://{{ branch | sanitize }}.{{ repo }}.localhost:8080"
Follow background hook output:
-{{ terminal(cmd="tail -f __WT_QUOT__$(wt config state logs get --hook=user:post-start:server)__WT_QUOT__") }}
+```bash
+tail -f "$(wt config state logs get --hook=user:post-start:server)"
+```
The `--hook` format is `source:hook-type:name` — e.g., `project:post-start:build` for project-defined hooks. Use `wt config state logs get` to list all available logs.
Create an alias for frequent use:
-{{ terminal(cmd="alias wtlog='f() { tail -f __WT_QUOT__$(wt config state logs get --hook=__WT_QUOT__$1__WT_QUOT__)__WT_QUOT__; }; f'") }}
+```bash
+alias wtlog='f() { tail -f "$(wt config state logs get --hook="$1")"; }; f'
+```
## Bare repository layout
@@ -448,7 +477,10 @@ A [bare repository](https://git-scm.com/docs/gitrepository-layout) has no workin
Cloning a bare repo into `<project>/.git` puts all worktrees under one directory:
-{{ terminal(cmd="git clone --bare <url> myproject/.git|||cd myproject") }}
+```bash
+git clone --bare <url> myproject/.git
+cd myproject
+```
With `worktree-path = "{{ repo_path }}/../{{ branch | sanitize }}"`, worktrees become subdirectories of `myproject/`:
@@ -481,7 +513,9 @@ Run `wt config show` from inside any worktree to find the project identifier (`I
### Create the first worktree
-{{ terminal(cmd="wt switch main") }}
+```bash
+wt switch main
+```
For a freshly cloned bare repo the default branch already exists, so `wt switch main` (without `--create`) is enough. Use `wt switch --create <branch>` for new branches.
@@ -491,6 +525,9 @@ Now `wt switch --create feature` creates `myproject/feature/`.
The project config (`.config/wt.toml`) must live inside a worktree — the bare `.git` directory has no tracked files. Once the first worktree exists, create it from there:
-{{ terminal(cmd="cd myproject/main|||wt config create --project") }}
+```bash
+cd myproject/main
+wt config create --project
+```
Commit the file and it will appear in every worktree automatically.
diff --git a/docs/src/content/docs/worktrunk.md b/docs/src/content/docs/worktrunk.md
new file mode 100644
index 000000000..058e90c0b
--- /dev/null
+++ b/docs/src/content/docs/worktrunk.md
@@ -0,0 +1,254 @@
+---
+title: "Worktrunk"
+description: "CLI for Git worktree management, designed for parallel AI agent workflows."
+sidebar:
+ order: 1
+pagefind: false
+head:
+ - tag: link
+ attrs:
+ rel: canonical
+ href: "https://worktrunk.dev/"
+ - tag: meta
+ attrs:
+ name: robots
+ content: noindex
+ - tag: meta
+ attrs:
+ property: og:url
+ content: "https://worktrunk.dev/"
+---
+Worktrunk is a CLI for Git worktree management, designed for **parallel AI agent
+workflows**.
+
+Worktrunk's three core commands make worktrees as easy as branches.
+Plus, Worktrunk has a bunch of quality-of-life features to simplify working
+with many parallel changes, including hooks to automate local workflows.
+
+A quick demo:
+
+<figure class="demo">
+<picture>
+ <source srcset="/assets/docs/dark/wt-core-mobile.gif" media="(prefers-color-scheme: dark) and (max-width: 42rem)" data-demo-theme="dark" data-demo-media="(max-width: 42rem)">
+ <source srcset="/assets/docs/light/wt-core-mobile.gif" media="(max-width: 42rem)" data-demo-theme="light" data-demo-media="(max-width: 42rem)">
+ <source srcset="/assets/docs/dark/wt-core.gif" media="(prefers-color-scheme: dark)" data-demo-theme="dark">
+ <img src="/assets/docs/light/wt-core.gif" alt="Worktrunk demo showing wt list, wt switch, and hooks" width="1600" height="900">
+</picture>
+<figcaption>Listing worktrees, switching, cleaning up</figcaption>
+</figure>
+
+## Context: git worktrees
+
+AI agents like Claude Code and Codex can handle longer tasks without
+supervision, such that it's possible to manage 5-10+ in parallel. Git's native
+worktree feature give each agent its own working directory, so they don't step
+on each other's changes.
+
+But the git worktree UX is clunky. Even a task as small as starting a new
+worktree requires typing the branch name three times: `git worktree add -b feat
+../repo.feat`, then `cd ../repo.feat`.
+
+## Worktrunk makes git worktrees as easy as branches
+
+Worktrees are addressed by branch name; paths are computed from a configurable template. Commands that take a branch also accept the path of the worktree it is checked out in.
+
+<p class="workflow-stage">Start with the core commands</p>
+
+**Core commands:**
+
+<table class="cmd-compare">
+ <thead>
+ <tr>
+ <th>Task</th>
+ <th>Worktrunk</th>
+ <th>Plain git</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>Switch worktrees</td>
+ <td data-label="Worktrunk"><code>wt switch feat</code></td>
+ <td data-label="Plain git"><code>cd ../repo.feat</code></td>
+ </tr>
+ <tr>
+ <td>Create + start Claude</td>
+ <td data-label="Worktrunk"><code>wt switch -c -x claude feat</code></td>
+ <td data-label="Plain git"><pre><code>git worktree add -b feat ../repo.feat && \
+cd ../repo.feat && \
+claude</code></pre></td>
+ </tr>
+ <tr>
+ <td>Clean up</td>
+ <td data-label="Worktrunk"><code>wt remove</code></td>
+ <td data-label="Plain git"><pre><code>cd ../repo && \
+git worktree remove ../repo.feat && \
+git branch -d feat</code></pre></td>
+ </tr>
+ <tr>
+ <td>List with status</td>
+ <td data-label="Worktrunk"><code>wt list</code></td>
+ <td data-label="Plain git"><span class="cmd-compare-value"><code>git worktree list</code> (paths only)</span></td>
+ </tr>
+ </tbody>
+</table>
+
+<p class="workflow-stage">Expand into the more advanced commands as needed</p>
+
+<p class="workflow-heading"><strong>Workflow automation:</strong></p>
+
+- **[Hooks](/hook/)** — run commands on create, pre-merge, post-merge, etc
+- **[LLM commit messages](/llm-commits/)** — generate commit messages from diffs
+- **[Merge workflow](/merge/)** — squash, rebase, merge, clean up in one command
+- **[Interactive picker](/switch/#interactive-picker)** — browse worktrees with live diff and log previews
+- **[Copy build caches](/step/#wt-step-copy-ignored)** — skip cold starts by sharing `target/`, `node_modules/`, etc between worktrees
+- **[`wt list --full`](/list/#full-mode)** — [CI status](/list/#ci-status) and [AI-generated summaries](/list/#llm-summaries) per branch
+- **[PR checkout](/switch/#pull-requests-and-merge-requests)** — `wt switch pr:123` to jump straight to a PR's branch
+- **[Dev server per worktree](/tips-patterns/#dev-server-per-worktree)** — `hash_port` template filter gives each worktree a unique port
+- **[Aliases](/extending/#aliases) & [per-branch variables](/config/#wt-config-state-vars)** — custom `wt <name>` commands and branch-scoped state for hook templates
+- ...and **[lots more](#next-steps)**
+
+Multiple parallel agents, same simple commands:
+
+<figure class="demo">
+<picture>
+ <source srcset="/assets/docs/dark/wt-zellij-omnibus.gif" media="(prefers-color-scheme: dark)">
+ <img src="/assets/docs/light/wt-zellij-omnibus.gif" alt="Worktrunk omnibus demo: multiple Claude agents in Zellij tabs with hooks, LLM commits, and merge workflow" width="1600" height="900">
+</picture>
+<figcaption>Multiple Claude agents in parallel with interactive picker, hooks, LLM commits, and merge</figcaption>
+</figure>
+
+## Install
+
+**Homebrew (macOS & Linux):**
+
+```bash
+brew install worktrunk && wt config shell install
+```
+
+Shell integration allows commands to change directories.
+
+**Cargo:**
+
+```bash
+cargo install worktrunk && wt config shell install
+```
+
+<details>
+<summary><strong>Windows & other</strong></summary>
+
+**Windows.** `wt` defaults to Windows Terminal's command, so Winget additionally installs Worktrunk as `git-wt` to avoid the conflict:
+
+```bash
+winget install max-sixty.worktrunk
+git-wt config shell install
+```
+
+Alternatively, disable Windows Terminal's alias (Settings → Apps → Advanced app settings → App execution aliases → "Terminal"/"Terminal Preview") to use `wt` directly.
+
+> Free code signing provided by [SignPath.io](https://signpath.io/), certificate by [SignPath Foundation](https://signpath.org/) — [policy](/code-signing/).
+
+**Arch Linux:**
+
+```bash
+sudo pacman -S worktrunk && wt config shell install
+```
+
+**Conda / Pixi** (community-maintained [feedstock](https://github.com/conda-forge/worktrunk-feedstock)):
+
+```bash
+conda install -c conda-forge worktrunk && wt config shell install
+```
+
+Or with [Pixi](https://pixi.sh): `pixi global install worktrunk && wt config shell install`.
+
+</details>
+
+## Quick start
+
+Create a worktree for a new feature:
+
+<!-- ⚠️ AUTO-GENERATED from tests/snapshots/integration__integration_tests__list__quickstart_switch.snap — edit source to update -->
+
+```console
+$ wt switch --create feature-auth
+✓ Created branch feature-auth from main and worktree @ ~/repo.feature-auth
+```
+
+<!-- END AUTO-GENERATED -->
+
+This creates a new branch and worktree, then switches to it. Do your work, then check all worktrees with [`wt list`](/list/):
+
+<!-- ⚠️ AUTO-GENERATED from tests/snapshots/integration__integration_tests__list__quickstart_list.snap — edit source to update -->
+
+```console
+$ wt list
+ Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
+@ feature-auth + ↑ +27 -8 ↑1 +31 4bc72dc 2h Add authenticati…
+^ main ^⇡ ⇡1 0e631ad 1d Initial commit
+
+○ Showing 2 worktrees, 1 with changes, 1 ahead, 1 column hidden
+```
+
+<!-- END AUTO-GENERATED -->
+
+The `@` marks the current worktree. `+` means staged changes, `↑1` means 1 commit ahead of main, `⇡` means unpushed commits.
+
+When done, either:
+
+**PR workflow** — commit, push, open a PR, merge via GitHub/GitLab, then clean up:
+
+```bash
+wt step commit # commit staged changes
+gh pr create # or glab mr create
+wt remove # after PR is merged
+```
+
+**Local merge** — squash, rebase onto main, fast-forward merge, clean up:
+
+<!-- ⚠️ AUTO-GENERATED from tests/snapshots/integration__integration_tests__list__quickstart_merge.snap — edit source to update -->
+
+```console
+$ wt merge main
+◎ Generating commit message and committing changes... (2 files, +53, no squashing needed)
+ Add authentication module
+✓ Committed changes @ a1b2c3d
+◎ Merging 1 commit to main @ a1b2c3d (no rebase needed)
+ * a1b2c3d Add authentication module
+ auth.rs | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
+ lib.rs | 2 ++
+ 2 files changed, 53 insertions(+)
+✓ Merged to main (1 commit, 2 files, +53)
+◎ Removing feature-auth worktree & branch in background (same commit as main, _)
+○ Switched to worktree for main @ ~/repo
+```
+
+<!-- END AUTO-GENERATED -->
+
+For parallel agents, create multiple worktrees and launch an agent in each:
+
+```bash
+wt switch -x claude -c feature-a -- 'Add user authentication'
+wt switch -x claude -c feature-b -- 'Fix the pagination bug'
+wt switch -x claude -c feature-c -- 'Write tests for the API'
+```
+
+The `-x` flag runs a command after switching; arguments after `--` are passed to it. Configure [post-start hooks](/hook/#hook-types) to automate setup (install deps, start dev servers).
+
+## Next steps
+
+- Learn the core commands: [`wt switch`](/switch/), [`wt list`](/list/), [`wt merge`](/merge/), [`wt remove`](/remove/)
+- Set up [hooks](/hook/) for automated setup
+- Explore [LLM commit messages](/llm-commits/), [interactive
+ picker](/switch/#interactive-picker), [Claude Code integration](/claude-code/), [CI
+ status & PR links](/list/#ci-status)
+- Browse [tips & patterns](/tips-patterns/) for recipes: aliases, dev servers, databases, agent handoffs, and more
+- [Extending Worktrunk](/extending/) — customize workflows with hooks & aliases
+- Run `wt --help` or `wt <command> --help` for quick CLI reference
+
+## Further reading
+
+- [Claude Code: Best practices for agentic coding](https://www.anthropic.com/engineering/claude-code-best-practices) — Anthropic's official guide, including the worktree pattern
+- [Shipping faster with Claude Code and Git Worktrees](https://incident.io/blog/shipping-faster-with-claude-code-and-git-worktrees) — incident.io's workflow for parallel agents
+- [Git worktree pattern discussion](https://github.com/anthropics/claude-code/issues/1052) — Community discussion in the Claude Code repo
+- [@DevOpsToolbox's video on Worktrunk](https://youtu.be/WBQiqr6LevQ?t=345)
+- [git-worktree documentation](https://git-scm.com/docs/git-worktree) — Official git reference
diff --git a/docs/src/pages/404.astro b/docs/src/pages/404.astro
new file mode 100644
index 000000000..95ad58659
--- /dev/null
+++ b/docs/src/pages/404.astro
@@ -0,0 +1,23 @@
+---
+import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
+---
+
+<StarlightPage
+ frontmatter={{
+ title: 'Page not found',
+ description: 'The requested page could not be found.',
+ editUrl: false,
+ pagefind: false,
+ template: 'splash',
+ head: [
+ { tag: 'meta', attrs: { name: 'robots', content: 'noindex' } },
+ ],
+ hero: {
+ title: 'Page not found',
+ tagline: 'That page isn’t here.',
+ actions: [
+ { text: 'Return to Worktrunk', link: '/', icon: 'left-arrow', variant: 'primary' },
+ ],
+ },
+ }}
+/>
diff --git a/docs/src/pages/index.astro b/docs/src/pages/index.astro
new file mode 100644
index 000000000..98758915a
--- /dev/null
+++ b/docs/src/pages/index.astro
@@ -0,0 +1,30 @@
+---
+import { getEntry, render } from 'astro:content';
+import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
+
+const entry = await getEntry('docs', 'worktrunk');
+if (!entry) throw new Error('Missing Worktrunk overview page');
+
+const { Content, headings } = await render(entry);
+---
+
+<StarlightPage
+ headings={headings}
+ hasSidebar={true}
+ frontmatter={{
+ title: 'Worktrunk',
+ description: entry.data.description,
+ tableOfContents: false,
+ editUrl: 'https://github.com/max-sixty/worktrunk/edit/main/docs/src/content/docs/worktrunk.md',
+ head: [
+ {
+ tag: 'title',
+ content: 'Worktrunk — Git worktree management for parallel AI agent workflows',
+ },
+ ],
+ }}
+>
+ <div class="wt-home" data-contract="home-content-rail">
+ <Content />
+ </div>
+</StarlightPage>
diff --git a/docs/src/plugins/pagefind-command-references.mjs b/docs/src/plugins/pagefind-command-references.mjs
new file mode 100644
index 000000000..eccdc8f78
--- /dev/null
+++ b/docs/src/plugins/pagefind-command-references.mjs
@@ -0,0 +1,59 @@
+const fragmentTitleClass = 'wt-pagefind-fragment-title';
+
+function nodeText(node) {
+ if (node.type === 'text') return node.value;
+ return node.children?.map(nodeText).join('') ?? '';
+}
+
+function isCommandHeading(text) {
+ return /^wt\s+\S/u.test(text.trim());
+}
+
+function escapeHtml(text) {
+ return text.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
+}
+
+function annotateCommandReference(heading, command) {
+ const alreadyAnnotated = heading.children?.some((child) => (
+ child.type === 'raw' && child.value.includes(`class="${fragmentTitleClass}"`)
+ ));
+ if (alreadyAnnotated) return;
+
+ heading.children ??= [];
+ heading.children.unshift({
+ // Starlight computes its anchor-link label before Astro parses raw HTML.
+ // Keeping this as raw HTML prevents search context changing that label.
+ type: 'raw',
+ value: `<span class="${fragmentTitleClass}" hidden aria-hidden="true">${escapeHtml(command)} — </span>`,
+ });
+}
+
+/**
+ * Gives repeated command-reference fragments unique Pagefind titles.
+ *
+ * Pagefind derives sub-result titles from heading text and includes hidden HTML.
+ * Browsers omit this hidden, aria-hidden prefix from rendering, selection, and the
+ * accessibility tree, so the visible heading remains exactly "Command reference".
+ */
+export function rehypePagefindCommandReferences() {
+ return (tree) => {
+ let command;
+
+ function visit(node) {
+ if (node.type === 'element' && node.tagName === 'h2') {
+ const text = nodeText(node).trim();
+ command = isCommandHeading(text) ? text : undefined;
+ } else if (
+ command
+ && node.type === 'element'
+ && node.tagName === 'h3'
+ && nodeText(node).trim() === 'Command reference'
+ ) {
+ annotateCommandReference(node, command);
+ }
+ node.children?.forEach(visit);
+ }
+
+ visit(tree);
+ };
+}
diff --git a/docs/src/plugins/responsive-tables.mjs b/docs/src/plugins/responsive-tables.mjs
new file mode 100644
index 000000000..ecf821028
--- /dev/null
+++ b/docs/src/plugins/responsive-tables.mjs
@@ -0,0 +1,100 @@
+const recordClass = 'wt-responsive-records';
+const labelClass = 'wt-responsive-record-label';
+
+function elementChildren(node, tagName) {
+ return (node.children ?? []).filter((child) => (
+ child.type === 'element' && (!tagName || child.tagName === tagName)
+ ));
+}
+
+function nodeText(node) {
+ if (node.type === 'text') return node.value;
+ return node.children?.map(nodeText).join('') ?? '';
+}
+
+function classNames(node) {
+ const classes = node.properties?.className ?? [];
+ return Array.isArray(classes) ? classes : String(classes).split(/\s+/u).filter(Boolean);
+}
+
+function hasComplexSpan(cell) {
+ return ['colSpan', 'colspan', 'rowSpan', 'rowspan'].some((property) => (
+ property in (cell.properties ?? {}) && Number(cell.properties[property]) !== 1
+ ));
+}
+
+function recordTableParts(table) {
+ if (classNames(table).includes('cmd-compare')) return;
+
+ const sections = elementChildren(table);
+ if (
+ sections.length !== 2
+ || sections[0].tagName !== 'thead'
+ || sections[1].tagName !== 'tbody'
+ ) return;
+
+ const headerRows = elementChildren(sections[0], 'tr');
+ const bodyRows = elementChildren(sections[1], 'tr');
+ if (headerRows.length !== 1 || bodyRows.length < 1 || bodyRows.length > 3) return;
+
+ const headers = elementChildren(headerRows[0]);
+ if (
+ headers.length < 3
+ || headers.some((cell) => cell.tagName !== 'th' || hasComplexSpan(cell))
+ ) return;
+
+ const labels = headers.map((cell) => nodeText(cell).trim());
+ if (labels.some((label) => !label) || new Set(labels).size !== labels.length) return;
+
+ const rows = bodyRows.map((row) => elementChildren(row));
+ if (rows.some((cells) => (
+ cells.length !== headers.length
+ || cells.some((cell) => cell.tagName !== 'td' || hasComplexSpan(cell))
+ ))) return;
+
+ return { labels, rows };
+}
+
+function annotateRecordTable(table) {
+ const parts = recordTableParts(table);
+ if (!parts) return;
+
+ table.properties ??= {};
+ const classes = classNames(table);
+ if (!classes.includes(recordClass)) table.properties.className = [...classes, recordClass];
+ table.properties.dataRecordColumns = String(parts.labels.length);
+
+ for (const cells of parts.rows) {
+ for (const [index, cell] of cells.entries()) {
+ const alreadyLabeled = cell.children?.some((child) => (
+ child.type === 'element' && classNames(child).includes(labelClass)
+ ));
+ if (alreadyLabeled) continue;
+ cell.children ??= [];
+ cell.children.unshift({
+ type: 'element',
+ tagName: 'span',
+ properties: {
+ ariaHidden: 'true',
+ className: [labelClass],
+ },
+ children: [{ type: 'text', value: parts.labels[index] }],
+ });
+ }
+ }
+}
+
+/**
+ * Turns only short, unambiguous Markdown tables into responsive record groups.
+ * Dense references and matrices retain their native horizontal table layout.
+ */
+export function rehypeResponsiveTables() {
+ return (tree) => {
+ function visit(node) {
+ if (node.type === 'element' && node.tagName === 'table') annotateRecordTable(node);
+ node.children?.forEach(visit);
+ }
+
+ visit(tree);
+ };
+}
diff --git a/docs/src/plugins/sitemap-compatibility.mjs b/docs/src/plugins/sitemap-compatibility.mjs
new file mode 100644
index 000000000..3e708eb94
--- /dev/null
+++ b/docs/src/plugins/sitemap-compatibility.mjs
@@ -0,0 +1,16 @@
+import { copyFile } from 'node:fs/promises';
+
+/** Keeps the sitemap URL published by the previous site generator working. */
+export function sitemapCompatibility() {
+ return {
+ name: 'worktrunk-sitemap-compatibility',
+ hooks: {
+ 'astro:build:done': async ({ dir }) => {
+ await copyFile(
+ new URL('sitemap-index.xml', dir),
+ new URL('sitemap.xml', dir),
+ );
+ },
+ },
+ };
+}
diff --git a/docs/src/plugins/stable-heading-ids.mjs b/docs/src/plugins/stable-heading-ids.mjs
new file mode 100644
index 000000000..3560fcd2a
--- /dev/null
+++ b/docs/src/plugins/stable-heading-ids.mjs
@@ -0,0 +1,32 @@
+function nodeText(node) {
+ if (node.type === 'text') return node.value;
+ return node.children?.map(nodeText).join('') ?? '';
+}
+
+/** Preserve the heading-anchor scheme used by Worktrunk's original site. */
+export function slugHeading(text) {
+ return text
+ .normalize('NFKD')
+ .toLowerCase()
+ .replace(/[^\p{Letter}\p{Number}]+/gu, '-')
+ .replace(/^-|-$/g, '');
+}
+
+export function rehypeStableHeadingIds() {
+ return (tree) => {
+ const slugs = new Map();
+
+ function visit(node) {
+ if (node.type === 'element' && /^h[1-6]$/.test(node.tagName)) {
+ const base = slugHeading(nodeText(node));
+ const occurrence = slugs.get(base) ?? 0;
+ slugs.set(base, occurrence + 1);
+ node.properties ??= {};
+ node.properties.id = occurrence === 0 ? base : `${base}-${occurrence}`;
+ }
+ node.children?.forEach(visit);
+ }
+
+ visit(tree);
+ };
+}
diff --git a/docs/src/plugins/worktrunk-terminal.mjs b/docs/src/plugins/worktrunk-terminal.mjs
new file mode 100644
index 000000000..715e55865
--- /dev/null
+++ b/docs/src/plugins/worktrunk-terminal.mjs
@@ -0,0 +1,181 @@
+const terminalBlocks = new WeakMap();
+
+// Bare `+` is a status only at a line edge or between wide table columns;
+// ordinary prose such as `[unoptimized + debuginfo]` stays neutral.
+const semanticMarker = /([+↑⇡]\d+|[↑⇡]|(?<!\s)\+|\+(?!\s)|(?<=^|\s\s)\+(?=\s\s|\s*$)|[-↓⇣]\d+|✓|✗|(?<=^|\s)[!?](?=\s|$))/gmu;
+
+function addClass(node, className) {
+ const classes = node.properties.className ?? [];
+ node.properties.className = Array.isArray(classes)
+ ? [...classes, className]
+ : [classes, className];
+}
+
+function findCodeElement(node) {
+ if (
+ node?.type === 'element'
+ && node.tagName === 'div'
+ && node.properties?.className?.includes('code')
+ ) return node;
+ for (const child of node?.children ?? []) {
+ const code = findCodeElement(child);
+ if (code) return code;
+ }
+}
+
+function removeCopyControl(blockAst) {
+ blockAst.children = blockAst.children.filter((child) => (
+ child?.type !== 'element'
+ || !child.properties?.className?.includes('copy')
+ ));
+}
+
+function setCopyText(blockAst, copyText) {
+ const copy = blockAst.children.find((child) => (
+ child?.type === 'element' && child.properties?.className?.includes('copy')
+ ));
+ const button = copy?.children?.find((child) => (
+ child?.type === 'element' && child.tagName === 'button'
+ ));
+ if (!button) return;
+ button.properties ??= {};
+ button.properties['data-code'] = copyText;
+}
+
+function removeTitlelessHeader(blockAst) {
+ blockAst.children = blockAst.children.filter((child) => {
+ if (
+ child?.type !== 'element'
+ || child.tagName !== 'figcaption'
+ || !child.properties?.className?.includes('header')
+ ) return true;
+
+ const title = child.children?.find((element) => (
+ element?.type === 'element'
+ && element.properties?.className?.includes('title')
+ ));
+ return Boolean(
+ title?.children?.some((element) => element.type !== 'text' || element.value.trim()),
+ );
+ });
+}
+
+function markerTone(marker) {
+ if (/^[+↑⇡✓]/u.test(marker)) return 'positive';
+ if (/^[-↓⇣✗]/u.test(marker)) return 'negative';
+ return 'warning';
+}
+
+/** Split captured output into neutral text and semantically colored markers. */
+export function semanticOutputSegments(text) {
+ const segments = [];
+ let cursor = 0;
+ for (const match of text.matchAll(semanticMarker)) {
+ if (match.index > cursor) segments.push({ text: text.slice(cursor, match.index) });
+ segments.push({ text: match[0], tone: markerTone(match[0]) });
+ cursor = match.index + match[0].length;
+ }
+ if (cursor < text.length) segments.push({ text: text.slice(cursor) });
+ return segments;
+}
+
+function renderSemanticOutput(lineAst, text) {
+ const segments = semanticOutputSegments(text);
+ if (!segments.some(({ tone }) => tone)) return;
+ const code = findCodeElement(lineAst);
+ if (!code) return;
+ code.children = segments.map(({ text: value, tone }) => tone
+ ? {
+ type: 'element',
+ tagName: 'span',
+ properties: { className: [`wt-${tone}`] },
+ children: [{ type: 'text', value }],
+ }
+ : { type: 'text', value });
+}
+
+/**
+ * Keeps terminal examples as ordinary Markdown while removing untitled frame
+ * chrome, adding command prompts, and copying commands rather than output.
+ */
+export function pluginWorktrunkTerminal() {
+ return {
+ name: 'Worktrunk terminal prompts',
+ baseStyles: `
+ .expressive-code .frame.is-terminal .ec-line.wt-command .code::before {
+ content: '$ ';
+ color: var(--sl-color-accent-high);
+ font-weight: 650;
+ user-select: none;
+ }
+ .expressive-code .frame.is-terminal .ec-line.wt-output .code {
+ color: var(--sl-color-gray-2);
+ }
+ .expressive-code .frame.is-terminal .ec-line.wt-copyable .code {
+ color: var(--sl-color-gray-3);
+ }
+ .expressive-code .frame.is-terminal .wt-positive {
+ color: var(--sl-color-green-high);
+ font-weight: 650;
+ }
+ .expressive-code .frame.is-terminal .wt-negative {
+ color: var(--sl-color-red-high);
+ font-weight: 650;
+ }
+ .expressive-code .frame.is-terminal .wt-warning {
+ color: var(--sl-color-orange-high);
+ font-weight: 650;
+ }
+ `,
+ hooks: {
+ preprocessCode({ codeBlock }) {
+ if (codeBlock.language !== 'console') return;
+
+ const lines = [...codeBlock.getLines()];
+ const commandLines = new Set();
+ const copyableLines = new Set();
+ const hasOutput = lines.some((line) => (
+ line.text !== '' && !line.text.startsWith('$ ') && !line.text.startsWith('#')
+ ));
+ for (const [lineIndex, line] of lines.entries()) {
+ if (line.text.startsWith('$ ')) {
+ commandLines.add(lineIndex);
+ line.editText(0, 2, '');
+ } else if (line.text.startsWith('#') || (line.text === '' && !hasOutput)) {
+ copyableLines.add(lineIndex);
+ }
+ }
+ terminalBlocks.set(codeBlock, { commandLines, copyableLines });
+ },
+ postprocessRenderedLine({ codeBlock, line, lineIndex, renderData }) {
+ const terminal = terminalBlocks.get(codeBlock);
+ if (!terminal) return;
+ const className = terminal.commandLines.has(lineIndex)
+ ? 'wt-command'
+ : terminal.copyableLines.has(lineIndex)
+ ? 'wt-copyable'
+ : 'wt-output';
+ addClass(renderData.lineAst, className);
+ if (className === 'wt-output') {
+ renderSemanticOutput(renderData.lineAst, line?.text ?? codeBlock.getLines()[lineIndex].text);
+ }
+ },
+ postprocessRenderedBlock({ codeBlock, renderData }) {
+ removeTitlelessHeader(renderData.blockAst);
+ const terminal = terminalBlocks.get(codeBlock);
+ if (!terminal) return;
+ if (terminal.commandLines.size === 0 && terminal.copyableLines.size === 0) {
+ removeCopyControl(renderData.blockAst);
+ return;
+ }
+ const copyText = [...codeBlock.getLines()]
+ .filter((_, lineIndex) => (
+ terminal.commandLines.has(lineIndex) || terminal.copyableLines.has(lineIndex)
+ ))
+ .map((line) => line.text)
+ .join('\u007f');
+ setCopyText(renderData.blockAst, copyText);
+ },
+ },
+ };
+}
diff --git a/docs/src/site-navigation.mjs b/docs/src/site-navigation.mjs
new file mode 100644
index 000000000..e1dd79fda
--- /dev/null
+++ b/docs/src/site-navigation.mjs
@@ -0,0 +1,25 @@
+export const sidebar = [
+ { label: 'Overview', link: '/' },
+ {
+ label: 'Commands',
+ items: [
+ { label: 'wt switch', link: '/switch/' },
+ { label: 'wt list', link: '/list/' },
+ { label: 'wt remove', link: '/remove/' },
+ { label: 'wt merge', link: '/merge/' },
+ { label: 'wt config', link: '/config/' },
+ { label: 'wt step', link: '/step/' },
+ { label: 'wt hook', link: '/hook/' },
+ ],
+ },
+ {
+ label: 'Guides',
+ items: [
+ { label: 'Agent integration', link: '/claude-code/' },
+ { label: 'Extending Worktrunk', link: '/extending/' },
+ { label: 'LLM commit messages', link: '/llm-commits/' },
+ { label: 'Tips & patterns', link: '/tips-patterns/' },
+ { label: 'FAQ', link: '/faq/' },
+ ],
+ },
+];
diff --git a/docs/src/styles/custom.css b/docs/src/styles/custom.css
new file mode 100644
index 000000000..1b08bef84
--- /dev/null
+++ b/docs/src/styles/custom.css
@@ -0,0 +1,657 @@
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600&family=Newsreader:opsz,[email protected],400;6..72,500;6..72,600&display=swap');
+
+/* Worktrunk's original warm-workbench palette, mapped onto Starlight by role. */
+:root {
+ --wt-paper: #f7f2e9;
+ --wt-paper-raised: #fcfaf5;
+ --wt-paper-soft: #efe7da;
+ --wt-ink: #282019;
+ --wt-ink-muted: #6d6258;
+ --wt-gold: #be842d;
+ --wt-copper: #9f4f2a;
+ --wt-craft: #7e6247;
+ --wt-gold-wash: #ead9bb;
+ --wt-line: #d9cab7;
+ --wt-focus: var(--wt-copper);
+ --wt-font-display: 'Newsreader', ui-serif, 'Iowan Old Style', 'Palatino Linotype', Palatino,
+ Georgia, serif;
+
+ --sl-font: 'Inter', system-ui, sans-serif;
+ --sl-font-mono: 'JetBrains Mono', ui-monospace, monospace;
+ --sl-color-accent-low: var(--wt-gold-wash);
+ --sl-color-accent: var(--wt-copper);
+ --sl-color-accent-high: #78350f;
+ --sl-color-text-accent: var(--wt-copper);
+ --sl-color-white: var(--wt-ink);
+ --sl-color-gray-1: #403a35;
+ --sl-color-gray-2: #5d554e;
+ --sl-color-gray-3: var(--wt-ink-muted);
+ --sl-color-gray-4: #a8a29e;
+ --sl-color-gray-5: var(--wt-line);
+ --sl-color-gray-6: var(--wt-paper-soft);
+ --sl-color-black: var(--wt-paper);
+ --sl-color-bg: var(--wt-paper);
+ --sl-color-bg-nav: var(--wt-paper-raised);
+ --sl-color-bg-sidebar: var(--wt-paper);
+ --sl-color-bg-inline-code: var(--wt-paper-soft);
+ --sl-color-hairline-light: var(--wt-line);
+ --sl-color-hairline: var(--wt-line);
+ --sl-color-hairline-shade: var(--wt-line);
+ --sl-content-width: 50rem;
+ --sl-sidebar-width: 17rem;
+}
+
+:root[data-theme='dark'] {
+ --wt-paper: #1d1916;
+ --wt-paper-raised: #241e1a;
+ --wt-paper-soft: #2c241e;
+ --wt-ink: #eee5d8;
+ --wt-ink-muted: #b9ab9c;
+ --wt-gold: #d8a553;
+ --wt-copper: #dd8555;
+ --wt-craft: #b99776;
+ --wt-gold-wash: #44311e;
+ --wt-line: #493a2e;
+ --sl-color-accent-low: var(--wt-gold-wash);
+ --sl-color-accent: var(--wt-copper);
+ --sl-color-accent-high: #fcd34d;
+ --sl-color-text-accent: var(--wt-copper);
+ --sl-color-white: var(--wt-ink);
+ --sl-color-gray-1: #dedbd7;
+ --sl-color-gray-2: #b8b1aa;
+ --sl-color-gray-3: var(--wt-ink-muted);
+ --sl-color-gray-4: #78716a;
+ --sl-color-gray-5: var(--wt-line);
+ --sl-color-gray-6: var(--wt-paper-raised);
+ --sl-color-black: var(--wt-paper);
+}
+
+body {
+ background-color: var(--wt-paper);
+ background-image: radial-gradient(
+ circle at 20% 0%,
+ color-mix(in srgb, var(--wt-gold) 4%, transparent),
+ transparent 31rem
+ );
+ color: var(--wt-ink);
+ font-feature-settings: 'ss01', 'cv11';
+ -webkit-font-smoothing: antialiased;
+}
+
+@media (forced-colors: none) {
+ :where(a, button, input, select, textarea, summary, .sl-markdown-content table):focus-visible {
+ outline: 2px solid var(--wt-focus);
+ }
+
+ .expressive-code {
+ --ec-focusBrd: var(--wt-focus);
+ }
+}
+
+h1,
+h2,
+h3,
+h4 {
+ font-family: var(--wt-font-display);
+ font-weight: 500;
+ letter-spacing: -0.025em;
+}
+
+/* Page sequence is quiet editorial navigation, not a pair of feature cards. */
+.pagination-links {
+ grid-template-columns: repeat(2, minmax(0, 1fr));
+ gap: 1rem;
+ border-block-start: 1px solid var(--wt-line);
+ padding-block-start: 0.9rem;
+}
+
+.pagination-links:empty {
+ display: none;
+}
+
+.pagination-links a {
+ min-width: 0;
+ border: 0;
+ border-radius: 0;
+ padding: 0.25rem 0;
+ background: transparent;
+ color: var(--wt-ink-muted);
+ font-family: var(--sl-font-mono);
+ font-size: 0.66rem;
+ font-weight: 500;
+ letter-spacing: 0.08em;
+ line-height: 1.35;
+ text-transform: uppercase;
+ box-shadow: none;
+}
+
+.pagination-links a:hover {
+ color: var(--wt-copper);
+}
+
+.pagination-links .link-title {
+ color: var(--wt-ink);
+ font-family: var(--sl-font);
+ font-size: 0.92rem;
+ font-weight: 500;
+ letter-spacing: 0;
+ line-height: 1.3;
+ text-transform: none;
+}
+
+.pagination-links svg {
+ width: 1rem;
+ color: var(--wt-copper);
+}
+
+.site-title {
+ color: var(--wt-ink);
+ font-family: 'Inter', system-ui, sans-serif;
+ font-size: 1.18rem;
+ font-weight: 600;
+ letter-spacing: -0.02em;
+}
+
+.site-title:hover {
+ color: var(--wt-ink);
+}
+
+.site-title img {
+ width: 2rem;
+ height: 2rem;
+}
+
+header.header {
+ border-block-end-color: color-mix(in srgb, var(--wt-line) 75%, transparent);
+ background: color-mix(in srgb, var(--wt-paper-raised) 92%, transparent);
+}
+
+.right-group .social-icons::after {
+ display: none;
+}
+
+.sidebar-pane {
+ background: color-mix(in srgb, var(--wt-paper) 88%, var(--wt-paper-soft));
+}
+
+.right-sidebar-panel {
+ border-inline-start-color: color-mix(in srgb, var(--wt-line) 75%, transparent);
+}
+
+.sidebar-content a[aria-current='page'] {
+ border-radius: 0;
+ box-shadow: inset 2px 0 var(--wt-copper);
+ background: transparent;
+ color: var(--wt-copper);
+}
+
+.sl-markdown-content {
+ font-size: 0.98rem;
+ line-height: 1.74;
+}
+
+.sl-markdown-content > h1,
+.content-panel h1 {
+ font-size: clamp(2.8rem, 5vw, 3.55rem);
+ line-height: 0.98;
+}
+
+.sl-markdown-content h2 {
+ margin-block-start: 2.8rem;
+ font-size: 2.05rem;
+ line-height: 1.08;
+}
+
+.sl-markdown-content h3 {
+ font-size: 1.5rem;
+ line-height: 1.15;
+}
+
+.sl-markdown-content :is(p, li):not(:where(.not-content *)) {
+ max-width: 68ch;
+}
+
+.sl-markdown-content a:not(:where(.not-content *)) {
+ color: var(--wt-copper);
+ text-decoration-color: color-mix(in srgb, var(--wt-copper) 55%, transparent);
+ text-decoration-thickness: 1px;
+ text-underline-offset: 0.18em;
+}
+
+.sl-markdown-content :is(p, li, td, th, summary) code:not(:where(.not-content *)) {
+ border: 1px solid var(--wt-line);
+ border-radius: 0.2rem;
+ background: color-mix(in srgb, var(--wt-paper-soft) 72%, transparent);
+ color: #96502f;
+}
+
+:root[data-theme='dark']
+ .sl-markdown-content
+ :is(p, li, td, th, summary)
+ code:not(:where(.not-content *)) {
+ color: #e4a079;
+}
+
+/* Ordinary tables are complete primitives; no Starlight edge spacing leaks in. */
+.sl-markdown-content table:not(.cmd-compare):not(:where(.not-content *)) {
+ display: block;
+ width: fit-content;
+ max-width: 100%;
+ overflow-x: auto;
+ border-block: 1px solid var(--wt-craft);
+ border-collapse: separate;
+ border-spacing: 0;
+ background: transparent;
+}
+
+.sl-markdown-content table:not(.cmd-compare) :is(th, td) {
+ min-width: 0;
+ border: 0;
+ border-block-end: 1px solid var(--wt-line);
+ padding: 0.65rem 0.85rem;
+ text-align: start;
+ vertical-align: top;
+}
+
+.sl-markdown-content table:not(.cmd-compare) :is(th, td):first-child {
+ min-width: 7rem;
+}
+
+.sl-markdown-content table:not(.cmd-compare) th {
+ background: transparent;
+ color: var(--wt-craft);
+ font-family: var(--sl-font-mono);
+ font-size: 0.7rem;
+ font-weight: 600;
+ letter-spacing: 0.04em;
+ text-transform: uppercase;
+}
+
+.sl-markdown-content table:not(.cmd-compare) tr:last-child td {
+ border-block-end: 0;
+}
+
+.sl-markdown-content table:not(.cmd-compare) td:first-child {
+ color: var(--wt-copper);
+ font-weight: 550;
+}
+
+.sl-markdown-content table:not(.cmd-compare) td code {
+ white-space: nowrap;
+}
+
+.sl-markdown-content .wt-responsive-record-label {
+ display: none;
+}
+
+@media (max-width: 42rem) {
+ .sl-markdown-content
+ table:not(.cmd-compare):has(> thead > tr > th:nth-child(2):last-child) {
+ display: table;
+ width: 100%;
+ table-layout: fixed;
+ overflow: visible;
+ background-image: none;
+ }
+
+ .sl-markdown-content
+ table:not(.cmd-compare):has(> thead > tr > th:nth-child(2):last-child)
+ :is(th, td):first-child {
+ width: 38%;
+ min-width: 0;
+ }
+
+ .sl-markdown-content
+ table:not(.cmd-compare):has(> thead > tr > th:nth-child(2):last-child)
+ td
+ code {
+ border: 0;
+ padding: 0;
+ background: transparent;
+ overflow-wrap: anywhere;
+ white-space: normal;
+ }
+
+ .sl-markdown-content table.wt-responsive-records:not(.cmd-compare) {
+ width: 100%;
+ max-width: 100%;
+ overflow: visible;
+ border: 0;
+ background-image: none;
+ line-height: 1.45;
+ }
+
+ .sl-markdown-content table.wt-responsive-records thead {
+ position: absolute;
+ width: 1px;
+ height: 1px;
+ margin: -1px;
+ padding: 0;
+ overflow: hidden;
+ clip-path: inset(50%);
+ white-space: nowrap;
+ }
+
+ .sl-markdown-content table.wt-responsive-records tbody {
+ display: block;
+ }
+
+ .sl-markdown-content table.wt-responsive-records tbody tr {
+ display: grid;
+ grid-template-columns: repeat(2, minmax(0, 1fr));
+ gap: 0.15rem 0.6rem;
+ border-block-start: 1px solid var(--wt-line);
+ padding-block: 0.2rem;
+ }
+
+ .sl-markdown-content table.wt-responsive-records[data-record-columns='3'] tbody tr {
+ grid-template-columns: fit-content(30%) fit-content(30%) minmax(0, 1fr);
+ }
+
+ .sl-markdown-content table.wt-responsive-records[data-record-columns='4'] tbody td:nth-child(-n + 2) {
+ grid-column: 1 / -1;
+ }
+
+ .sl-markdown-content table.wt-responsive-records tbody tr:last-child {
+ border-block-end: 1px solid var(--wt-line);
+ }
+
+ .sl-markdown-content table.wt-responsive-records tbody td {
+ display: block;
+ width: auto;
+ min-width: 0;
+ margin: 0;
+ border: 0;
+ padding: 0.1rem 0.05rem 0.18rem;
+ overflow-wrap: anywhere;
+ }
+
+ .sl-markdown-content table.wt-responsive-records .wt-responsive-record-label {
+ display: block;
+ position: static;
+ width: auto;
+ margin-block-end: 0.05rem;
+ color: var(--wt-ink-muted);
+ font-size: 0.7rem;
+ font-weight: 600;
+ letter-spacing: 0.04em;
+ line-height: 1.35;
+ text-transform: uppercase;
+ }
+
+ .sl-markdown-content table.wt-responsive-records td code {
+ overflow-wrap: anywhere;
+ white-space: normal;
+ }
+}
+
+/* The homepage comparison keeps task adjacency without becoming a card grid. */
+.sl-markdown-content .cmd-compare:not(:where(.not-content *)) {
+ display: block;
+ width: 100%;
+ overflow: hidden;
+ border-block: 1px solid var(--wt-line);
+}
+
+.sl-markdown-content .cmd-compare :is(thead, tbody) {
+ display: block;
+}
+
+.sl-markdown-content .cmd-compare tr {
+ display: grid;
+ grid-template-columns: minmax(8rem, 0.7fr) minmax(14rem, 1fr) minmax(19rem, 1.4fr);
+}
+
+.sl-markdown-content .cmd-compare :is(th, td) {
+ min-width: 0;
+ margin: 0;
+ border: 0;
+ padding: 0.85rem 1rem;
+ text-align: start;
+ vertical-align: top;
+}
+
+.sl-markdown-content .cmd-compare thead {
+ background: var(--wt-paper-soft);
+}
+
+.sl-markdown-content .cmd-compare th:nth-child(2),
+.sl-markdown-content .cmd-compare td:nth-child(2) {
+ background: color-mix(in srgb, var(--wt-gold) 7%, transparent);
+}
+
+.sl-markdown-content .cmd-compare tbody tr + tr {
+ border-block-start: 1px solid var(--wt-line);
+}
+
+.sl-markdown-content .cmd-compare tbody td:first-child {
+ color: var(--wt-ink-muted);
+ font-weight: 600;
+}
+
+.sl-markdown-content .cmd-compare pre {
+ min-width: 0;
+ margin: 0;
+ border: 0;
+ padding: 0;
+ overflow: visible;
+ background: transparent;
+ white-space: pre-wrap;
+}
+
+.sl-markdown-content .cmd-compare td:nth-child(n + 2) code {
+ border: 0;
+ padding: 0;
+ background: transparent;
+ color: var(--wt-ink);
+ font-size: 0.82rem;
+ line-height: 1.5;
+ overflow-wrap: anywhere;
+ white-space: pre-wrap;
+}
+
+@media (max-width: 44rem) {
+ .sl-markdown-content .cmd-compare:not(:where(.not-content *)) {
+ overflow: visible;
+ border: 0;
+ }
+
+ .sl-markdown-content .cmd-compare thead {
+ position: absolute;
+ width: 1px;
+ height: 1px;
+ margin: -1px;
+ padding: 0;
+ overflow: hidden;
+ clip-path: inset(50%);
+ white-space: nowrap;
+ }
+
+ .sl-markdown-content .cmd-compare tbody {
+ display: grid;
+ gap: 1rem;
+ }
+
+ .sl-markdown-content .cmd-compare tbody tr {
+ display: grid;
+ grid-template-columns: minmax(0, 1fr);
+ border-block: 1px solid var(--wt-line);
+ }
+
+ .sl-markdown-content .cmd-compare tbody td {
+ border: 0;
+ }
+
+ .sl-markdown-content .cmd-compare tbody td:first-child {
+ padding-block: 0.65rem;
+ background: var(--wt-paper-soft);
+ color: var(--wt-ink);
+ }
+
+ .sl-markdown-content .cmd-compare tbody td:nth-child(n + 2) {
+ display: grid;
+ grid-template-columns: 5.25rem minmax(0, 1fr);
+ gap: 0.75rem;
+ align-items: baseline;
+ }
+
+ .sl-markdown-content .cmd-compare tbody td:nth-child(3) {
+ border-block-start: 1px solid var(--wt-line);
+ }
+
+ .sl-markdown-content .cmd-compare tbody td:nth-child(n + 2)::before {
+ content: attr(data-label);
+ color: var(--wt-ink-muted);
+ font-size: 0.72rem;
+ font-weight: 600;
+ line-height: 1.5rem;
+ }
+}
+
+/* Code is content, not a simulated application window. */
+.expressive-code .frame {
+ margin-block: 1.25rem;
+}
+
+.expressive-code .frame pre {
+ --wt-scroll-surface: color-mix(in srgb, var(--wt-paper-raised) 58%, var(--wt-paper));
+ border: 0;
+ border-inline-start: 2px solid color-mix(in srgb, var(--wt-copper) 72%, var(--wt-line));
+ border-radius: 0;
+ background-color: var(--wt-scroll-surface);
+ box-shadow: none;
+}
+
+/* A local cover hides the stationary edge shade once the inline scroll reaches its end. */
+.sl-markdown-content table:not(.cmd-compare):not(:where(.not-content *)),
+.expressive-code .frame pre {
+ background-image:
+ linear-gradient(
+ var(--wt-scroll-surface, var(--wt-paper)),
+ var(--wt-scroll-surface, var(--wt-paper))
+ ),
+ linear-gradient(to right, transparent, color-mix(in srgb, var(--wt-ink) 18%, transparent));
+ background-position: right center;
+ background-size: 2rem 100%, 0.8rem 100%;
+ background-repeat: no-repeat;
+ background-attachment: local, scroll;
+}
+
+.badge-experimental::after {
+ content: 'experimental';
+ display: inline-flex;
+ margin-inline-start: 0.35rem;
+ border-block: 1px solid var(--wt-craft);
+ padding: 0.05rem 0.2rem;
+ color: var(--wt-craft);
+ font-family: var(--sl-font-mono);
+ font-size: 0.65rem;
+ font-weight: 500;
+ letter-spacing: 0.08em;
+ line-height: 1.4;
+ text-transform: uppercase;
+ vertical-align: 0.12em;
+}
+
+figure.demo {
+ margin: 1.75rem 0;
+}
+
+.wt-home > p + figure.demo {
+ margin-block-start: 0.75rem;
+}
+
+.wt-home figure.demo figcaption {
+ margin-block-start: 0.65rem;
+ color: var(--wt-ink-muted);
+ font-family: var(--wt-font-display);
+ font-size: 0.9rem;
+ font-style: italic;
+ line-height: 1.5;
+ text-align: center;
+}
+
+figure.demo img {
+ display: block;
+ width: 100%;
+ height: auto;
+ border: 1px solid var(--wt-line);
+ border-radius: 0.25rem;
+ background: var(--wt-paper-raised);
+}
+
+.wt-home {
+ scroll-margin-top: calc(var(--sl-nav-height) + 1rem);
+}
+
+.wt-home > p:first-of-type {
+ color: var(--wt-ink);
+ font-family: var(--wt-font-display);
+ font-size: 1.35rem;
+ line-height: 1.55;
+}
+
+.wt-home > p:first-of-type strong {
+ color: var(--wt-copper);
+ font-weight: 500;
+}
+
+.sl-markdown-content .wt-home > * {
+ box-sizing: border-box;
+ width: 100%;
+ max-width: none;
+ margin-inline: 0;
+}
+
+.wt-home .workflow-stage {
+ margin-block-start: 3rem;
+ color: var(--wt-copper);
+ font-family: var(--sl-font-mono);
+ font-size: 0.7rem;
+ font-weight: 500;
+ letter-spacing: 0.12em;
+ text-transform: uppercase;
+}
+
+.wt-home .workflow-heading {
+ margin-block-end: 0;
+}
+
+.wt-home > .workflow-heading + ul {
+ max-width: none;
+ margin-block-start: 0.75rem;
+ columns: 2;
+ column-gap: 3rem;
+ font-size: 0.95rem;
+ line-height: 1.6;
+}
+
+.wt-home > .workflow-heading + ul > li {
+ break-inside: avoid;
+ margin-block: 0 0.4rem;
+}
+
+@media (max-width: 42rem) {
+ .wt-home > .workflow-heading + ul {
+ columns: 1;
+ }
+}
+
+@media (min-width: 72rem) {
+ html:has(.wt-home) .main-pane {
+ --sl-content-margin-inline: auto 0;
+ width: min(
+ calc(100% - var(--sl-sidebar-width)),
+ calc(
+ var(--sl-content-width) +
+ (100% - var(--sl-content-width) - var(--sl-sidebar-width)) / 2
+ )
+ );
+ }
+}
+
+@media (max-width: 49.99rem) {
+ .sl-markdown-content h2 {
+ font-size: 1.8rem;
+ }
+}
diff --git a/docs/static/code-copy.js b/docs/static/code-copy.js
deleted file mode 100644
index 14d0ceded..000000000
--- a/docs/static/code-copy.js
+++ /dev/null
@@ -1,51 +0,0 @@
-// Copy-to-clipboard for code blocks
-// Strips leading `$ ` from bash/shell blocks (detected via data-lang or syntect classes)
-//
-// Split into two phases to prevent layout jump on page load:
-// 1. Wrapper script (inline, sync) - wraps <pre> elements before first paint
-// 2. Button script (deferred) - adds copy buttons after DOM ready
-
-document.addEventListener('DOMContentLoaded', function() {
- // Find all code blocks that were wrapped by the inline script
- const wrappers = document.querySelectorAll('.code-block-wrapper');
-
- wrappers.forEach(function(wrapper) {
- const block = wrapper.querySelector('pre');
- if (!block) return;
-
- const button = document.createElement('button');
- button.className = 'code-copy-btn';
- button.setAttribute('aria-label', 'Copy code');
- button.innerHTML = '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"/></svg>';
-
- button.addEventListener('click', function() {
- // Check if this is a bash/shell code block
- const codeEl = block.querySelector('code');
- const isBash = codeEl && (
- codeEl.dataset.lang === 'bash' ||
- codeEl.dataset.lang === 'console' ||
- /z-shell|z-bash/.test(codeEl.innerHTML)
- );
- const isTerminal = block.classList.contains('terminal');
- let text = block.textContent;
-
- if (isBash || isTerminal) {
- // Strip leading `$ ` from each line
- text = text.split('\n').map(function(line) {
- return line.replace(/^\$ /, '');
- }).join('\n');
- }
-
- navigator.clipboard.writeText(text.trim()).then(function() {
- button.innerHTML = '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="20 6 9 17 4 12"/></svg>';
- button.classList.add('copied');
- setTimeout(function() {
- button.innerHTML = '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1"/></svg>';
- button.classList.remove('copied');
- }, 2000);
- });
- });
-
- wrapper.appendChild(button);
- });
-});
diff --git a/docs/static/mobile-menu.js b/docs/static/mobile-menu.js
deleted file mode 100644
index c16d91769..000000000
--- a/docs/static/mobile-menu.js
+++ /dev/null
@@ -1,72 +0,0 @@
-// Mobile menu toggle functionality
-(function() {
- const toggle = document.querySelector('.mobile-menu-toggle');
- const menu = document.querySelector('.mobile-menu');
- const overlay = document.querySelector('.mobile-menu-overlay');
-
- if (!toggle || !menu || !overlay) return;
-
- function openMenu() {
- toggle.setAttribute('aria-expanded', 'true');
- toggle.setAttribute('aria-label', 'Close menu');
- menu.classList.add('active');
- menu.setAttribute('aria-hidden', 'false');
- overlay.classList.add('active');
- overlay.setAttribute('aria-hidden', 'false');
- document.body.classList.add('mobile-menu-open');
- // Move focus to first menu link
- var firstLink = menu.querySelector('a');
- if (firstLink) firstLink.focus();
- }
-
- function closeMenu() {
- toggle.setAttribute('aria-expanded', 'false');
- toggle.setAttribute('aria-label', 'Open menu');
- menu.classList.remove('active');
- menu.setAttribute('aria-hidden', 'true');
- overlay.classList.remove('active');
- overlay.setAttribute('aria-hidden', 'true');
- document.body.classList.remove('mobile-menu-open');
- }
-
- function toggleMenu() {
- var isOpen = toggle.getAttribute('aria-expanded') === 'true';
- if (isOpen) {
- closeMenu();
- } else {
- openMenu();
- }
- }
-
- // Toggle button click
- toggle.addEventListener('click', toggleMenu);
-
- // Close on overlay click
- overlay.addEventListener('click', closeMenu);
-
- // Close on escape key
- document.addEventListener('keydown', function(e) {
- if (e.key === 'Escape' && toggle.getAttribute('aria-expanded') === 'true') {
- closeMenu();
- toggle.focus();
- }
- });
-
- // Close menu when clicking a link (using event delegation)
- menu.addEventListener('click', function(e) {
- if (e.target.tagName === 'A') {
- closeMenu();
- }
- });
-
- // Close menu on window resize if viewport becomes larger
- var resizeTimer;
- window.addEventListener('resize', function() {
- clearTimeout(resizeTimer);
- resizeTimer = setTimeout(function() {
- if (window.innerWidth > 768 && toggle.getAttribute('aria-expanded') === 'true') {
- closeMenu();
- }
- }, 100);
- });
-})();
diff --git a/docs/static/normalize.css b/docs/static/normalize.css
deleted file mode 100644
index 192eb9ce4..000000000
--- a/docs/static/normalize.css
+++ /dev/null
@@ -1,349 +0,0 @@
-/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */
-
-/* Document
- ========================================================================== */
-
-/**
- * 1. Correct the line height in all browsers.
- * 2. Prevent adjustments of font size after orientation changes in iOS.
- */
-
-html {
- line-height: 1.15; /* 1 */
- -webkit-text-size-adjust: 100%; /* 2 */
-}
-
-/* Sections
- ========================================================================== */
-
-/**
- * Remove the margin in all browsers.
- */
-
-body {
- margin: 0;
-}
-
-/**
- * Render the `main` element consistently in IE.
- */
-
-main {
- display: block;
-}
-
-/**
- * Correct the font size and margin on `h1` elements within `section` and
- * `article` contexts in Chrome, Firefox, and Safari.
- */
-
-h1 {
- font-size: 2em;
- margin: 0.67em 0;
-}
-
-/* Grouping content
- ========================================================================== */
-
-/**
- * 1. Add the correct box sizing in Firefox.
- * 2. Show the overflow in Edge and IE.
- */
-
-hr {
- box-sizing: content-box; /* 1 */
- height: 0; /* 1 */
- overflow: visible; /* 2 */
-}
-
-/**
- * 1. Correct the inheritance and scaling of font size in all browsers.
- * 2. Correct the odd `em` font sizing in all browsers.
- */
-
-pre {
- font-family: monospace, monospace; /* 1 */
- font-size: 1em; /* 2 */
-}
-
-/* Text-level semantics
- ========================================================================== */
-
-/**
- * Remove the gray background on active links in IE 10.
- */
-
-a {
- background-color: transparent;
-}
-
-/**
- * 1. Remove the bottom border in Chrome 57-
- * 2. Add the correct text decoration in Chrome, Edge, IE, Opera, and Safari.
- */
-
-abbr[title] {
- border-bottom: none; /* 1 */
- text-decoration: underline; /* 2 */
- text-decoration: underline dotted; /* 2 */
-}
-
-/**
- * Add the correct font weight in Chrome, Edge, and Safari.
- */
-
-b,
-strong {
- font-weight: bolder;
-}
-
-/**
- * 1. Correct the inheritance and scaling of font size in all browsers.
- * 2. Correct the odd `em` font sizing in all browsers.
- */
-
-code,
-kbd,
-samp {
- font-family: monospace, monospace; /* 1 */
- font-size: 1em; /* 2 */
-}
-
-/**
- * Add the correct font size in all browsers.
- */
-
-small {
- font-size: 80%;
-}
-
-/**
- * Prevent `sub` and `sup` elements from affecting the line height in
- * all browsers.
- */
-
-sub,
-sup {
- font-size: 75%;
- line-height: 0;
- position: relative;
- vertical-align: baseline;
-}
-
-sub {
- bottom: -0.25em;
-}
-
-sup {
- top: -0.5em;
-}
-
-/* Embedded content
- ========================================================================== */
-
-/**
- * Remove the border on images inside links in IE 10.
- */
-
-img {
- border-style: none;
-}
-
-/* Forms
- ========================================================================== */
-
-/**
- * 1. Change the font styles in all browsers.
- * 2. Remove the margin in Firefox and Safari.
- */
-
-button,
-input,
-optgroup,
-select,
-textarea {
- font-family: inherit; /* 1 */
- font-size: 100%; /* 1 */
- line-height: 1.15; /* 1 */
- margin: 0; /* 2 */
-}
-
-/**
- * Show the overflow in IE.
- * 1. Show the overflow in Edge.
- */
-
-button,
-input { /* 1 */
- overflow: visible;
-}
-
-/**
- * Remove the inheritance of text transform in Edge, Firefox, and IE.
- * 1. Remove the inheritance of text transform in Firefox.
- */
-
-button,
-select { /* 1 */
- text-transform: none;
-}
-
-/**
- * Correct the inability to style clickable types in iOS and Safari.
- */
-
-button,
-[type="button"],
-[type="reset"],
-[type="submit"] {
- -webkit-appearance: button;
-}
-
-/**
- * Remove the inner border and padding in Firefox.
- */
-
-button::-moz-focus-inner,
-[type="button"]::-moz-focus-inner,
-[type="reset"]::-moz-focus-inner,
-[type="submit"]::-moz-focus-inner {
- border-style: none;
- padding: 0;
-}
-
-/**
- * Restore the focus styles unset by the previous rule.
- */
-
-button:-moz-focusring,
-[type="button"]:-moz-focusring,
-[type="reset"]:-moz-focusring,
-[type="submit"]:-moz-focusring {
- outline: 1px dotted ButtonText;
-}
-
-/**
- * Correct the padding in Firefox.
- */
-
-fieldset {
- padding: 0.35em 0.75em 0.625em;
-}
-
-/**
- * 1. Correct the text wrapping in Edge and IE.
- * 2. Correct the color inheritance from `fieldset` elements in IE.
- * 3. Remove the padding so developers are not caught out when they zero out
- * `fieldset` elements in all browsers.
- */
-
-legend {
- box-sizing: border-box; /* 1 */
- color: inherit; /* 2 */
- display: table; /* 1 */
- max-width: 100%; /* 1 */
- padding: 0; /* 3 */
- white-space: normal; /* 1 */
-}
-
-/**
- * Add the correct vertical alignment in Chrome, Firefox, and Opera.
- */
-
-progress {
- vertical-align: baseline;
-}
-
-/**
- * Remove the default vertical scrollbar in IE 10+.
- */
-
-textarea {
- overflow: auto;
-}
-
-/**
- * 1. Add the correct box sizing in IE 10.
- * 2. Remove the padding in IE 10.
- */
-
-[type="checkbox"],
-[type="radio"] {
- box-sizing: border-box; /* 1 */
- padding: 0; /* 2 */
-}
-
-/**
- * Correct the cursor style of increment and decrement buttons in Chrome.
- */
-
-[type="number"]::-webkit-inner-spin-button,
-[type="number"]::-webkit-outer-spin-button {
- height: auto;
-}
-
-/**
- * 1. Correct the odd appearance in Chrome and Safari.
- * 2. Correct the outline style in Safari.
- */
-
-[type="search"] {
- -webkit-appearance: textfield; /* 1 */
- outline-offset: -2px; /* 2 */
-}
-
-/**
- * Remove the inner padding in Chrome and Safari on macOS.
- */
-
-[type="search"]::-webkit-search-decoration {
- -webkit-appearance: none;
-}
-
-/**
- * 1. Correct the inability to style clickable types in iOS and Safari.
- * 2. Change font properties to `inherit` in Safari.
- */
-
-::-webkit-file-upload-button {
- -webkit-appearance: button; /* 1 */
- font: inherit; /* 2 */
-}
-
-/* Interactive
- ========================================================================== */
-
-/*
- * Add the correct display in Edge, IE 10+, and Firefox.
- */
-
-details {
- display: block;
-}
-
-/*
- * Add the correct display in all browsers.
- */
-
-summary {
- display: list-item;
-}
-
-/* Misc
- ========================================================================== */
-
-/**
- * Add the correct display in IE 10+.
- */
-
-template {
- display: none;
-}
-
-/**
- * Add the correct display in IE 10.
- */
-
-[hidden] {
- display: none;
-}
diff --git a/docs/static/search.js b/docs/static/search.js
deleted file mode 100644
index 2e1d7fce6..000000000
--- a/docs/static/search.js
+++ /dev/null
@@ -1,195 +0,0 @@
-// Search functionality adapted from Adidoks theme
-// Uses Zola's built-in elasticlunr search index
-
-var suggestions = document.getElementById('suggestions');
-var userinput = document.getElementById('userinput');
-
-// Focus search on '/' key, blur on Escape
-document.addEventListener('keydown', function(e) {
- if (e.key === '/' && document.activeElement.tagName !== 'INPUT' && document.activeElement.tagName !== 'TEXTAREA') {
- e.preventDefault();
- userinput.focus();
- }
- if (e.key === 'Escape') {
- userinput.blur();
- suggestions.style.display = 'none';
- }
-});
-
-// Hide suggestions when clicking outside
-document.addEventListener('click', function(event) {
- if (!suggestions.contains(event.target) && event.target !== userinput) {
- suggestions.style.display = 'none';
- }
-});
-
-// Arrow key navigation through results
-document.addEventListener('keydown', function(e) {
- const focusable = suggestions.querySelectorAll('a');
- if (suggestions.style.display === 'none' || focusable.length === 0) return;
-
- const index = Array.from(focusable).indexOf(document.activeElement);
-
- if (e.key === 'ArrowUp') {
- e.preventDefault();
- const nextIndex = index > 0 ? index - 1 : 0;
- focusable[nextIndex].focus();
- } else if (e.key === 'ArrowDown') {
- e.preventDefault();
- const nextIndex = index + 1 < focusable.length ? index + 1 : index;
- focusable[nextIndex].focus();
- }
-});
-
-// Main search functionality
-(function() {
- var index = elasticlunr.Index.load(window.searchIndex);
-
- userinput.addEventListener('input', function() {
- var value = this.value.trim();
-
- if (!value) {
- suggestions.style.display = 'none';
- suggestions.innerHTML = '';
- return;
- }
-
- var results = index.search(value, {
- bool: "OR",
- expand: true,
- fields: {
- title: { boost: 2 },
- body: { boost: 1 }
- }
- });
-
- var items = value.split(/\s+/);
- suggestions.innerHTML = '';
-
- if (results.length === 0) {
- suggestions.style.display = 'none';
- return;
- }
-
- suggestions.style.display = 'block';
-
- results.slice(0, 8).forEach(function(page) {
- if (page.doc.body !== '') {
- var entry = document.createElement('a');
- entry.href = page.ref;
- entry.className = 'search-result';
- entry.innerHTML = '<span class="search-title">' + escapeHtml(page.doc.title) + '</span>' +
- '<span class="search-excerpt">' + makeTeaser(page.doc.body, items) + '</span>';
- suggestions.appendChild(entry);
- }
- });
- });
-
- // Only hide suggestions on modifier-click (opens in new tab).
- // Normal clicks navigate away, so the page resets naturally.
- // Clearing during navigation causes layout shift during the view transition.
- suggestions.addEventListener('click', function(e) {
- if (e.ctrlKey || e.metaKey || e.shiftKey) {
- suggestions.innerHTML = '';
- suggestions.style.display = 'none';
- }
- });
-
- function escapeHtml(text) {
- var div = document.createElement('div');
- div.textContent = text;
- return div.innerHTML;
- }
-
- // Generate search excerpt with highlighted terms (adapted from mdbook/Adidoks)
- function makeTeaser(body, terms) {
- var TERM_WEIGHT = 40;
- var NORMAL_WORD_WEIGHT = 2;
- var FIRST_WORD_WEIGHT = 8;
- var TEASER_MAX_WORDS = 30;
-
- var stemmedTerms = terms.map(function(w) {
- return elasticlunr.stemmer(w.toLowerCase());
- });
- var termFound = false;
- var index = 0;
- var weighted = [];
-
- var sentences = body.toLowerCase().split(". ");
- for (var i in sentences) {
- var words = sentences[i].split(/[\s\n]/);
- var value = FIRST_WORD_WEIGHT;
- for (var j in words) {
- var word = words[j];
- if (word.length > 0) {
- for (var k in stemmedTerms) {
- if (elasticlunr.stemmer(word).startsWith(stemmedTerms[k])) {
- value = TERM_WEIGHT;
- termFound = true;
- }
- }
- weighted.push([word, value, index]);
- value = NORMAL_WORD_WEIGHT;
- }
- index += word.length + 1;
- }
- index += 1;
- }
-
- if (weighted.length === 0) {
- return body.length > TEASER_MAX_WORDS * 10
- ? escapeHtml(body.substring(0, TEASER_MAX_WORDS * 10)) + '...'
- : escapeHtml(body);
- }
-
- var windowSize = Math.min(weighted.length, TEASER_MAX_WORDS);
- var windowWeights = [];
- var curSum = 0;
-
- for (var i = 0; i < windowSize; i++) {
- curSum += weighted[i][1];
- }
- windowWeights.push(curSum);
-
- for (var i = 0; i < weighted.length - windowSize; i++) {
- curSum -= weighted[i][1];
- curSum += weighted[i + windowSize][1];
- windowWeights.push(curSum);
- }
-
- var maxSumIndex = 0;
- if (termFound) {
- var maxFound = 0;
- for (var i = windowWeights.length - 1; i >= 0; i--) {
- if (windowWeights[i] > maxFound) {
- maxFound = windowWeights[i];
- maxSumIndex = i;
- }
- }
- }
-
- var teaser = [];
- var startIndex = weighted[maxSumIndex][2];
-
- for (var i = maxSumIndex; i < maxSumIndex + windowSize; i++) {
- var word = weighted[i];
- if (startIndex < word[2]) {
- teaser.push(escapeHtml(body.substring(startIndex, word[2])));
- startIndex = word[2];
- }
-
- if (word[1] === TERM_WEIGHT) {
- teaser.push('<b>');
- }
-
- startIndex = word[2] + word[0].length;
- teaser.push(escapeHtml(body.substring(word[2], startIndex)));
-
- if (word[1] === TERM_WEIGHT) {
- teaser.push('</b>');
- }
- }
- teaser.push('...');
- return teaser.join('');
- }
-})();
diff --git a/docs/templates/404.html b/docs/templates/404.html
deleted file mode 100644
index 6a4a031f4..000000000
--- a/docs/templates/404.html
+++ /dev/null
@@ -1,92 +0,0 @@
-{% extends "base.html" %}
-
-{% block hero %}
-<style>
- .error-404 {
- display: flex;
- flex-direction: column;
- align-items: center;
- justify-content: center;
- text-align: center;
- padding: 0 2rem;
- min-height: calc(50vh - var(--wt-header-height));
- }
-
- .error-code {
- font-family: var(--wt-font-mono);
- font-size: clamp(4rem, 15vw, 8rem);
- font-weight: 700;
- color: var(--wt-color-accent);
- line-height: 1;
- margin-bottom: 0.5rem;
- letter-spacing: -0.02em;
- }
-
- .error-title {
- font-family: var(--wt-font-head);
- font-size: clamp(1.25rem, 4vw, 1.75rem);
- font-weight: 600;
- color: var(--wt-color-text);
- margin-bottom: 1rem;
- }
-
- .error-message {
- color: var(--wt-color-text-muted);
- font-size: 1rem;
- max-width: 28rem;
- margin-bottom: 2rem;
- line-height: 1.6;
- }
-
- .error-actions {
- display: flex;
- gap: 1rem;
- flex-wrap: wrap;
- justify-content: center;
- }
-
- .error-actions a {
- padding: 0.625rem 1.25rem;
- border-radius: 6px;
- font-weight: 500;
- text-decoration: none;
- transition: background-color 0.15s ease, border-color 0.15s ease;
- }
-
- .error-actions .primary {
- background: var(--wt-color-accent);
- color: white;
- }
-
- .error-actions .primary:hover {
- background: var(--wt-color-accent-strong);
- }
-
- .error-actions .secondary {
- background: transparent;
- color: var(--wt-color-text);
- border: 1px solid var(--wt-color-border-subtle);
- }
-
- .error-actions .secondary:hover {
- border-color: var(--wt-color-text-muted);
- }
-</style>
-<section class="error-404">
- <div class="error-code">404</div>
- <h1 class="error-title">Worktree not found</h1>
- <p class="error-message">
- This worktree has been pruned or never existed.
- </p>
- <div class="error-actions">
- <a href="/" class="primary">Back to Docs</a>
- <a href="https://github.com/max-sixty/worktrunk" class="secondary">View on GitHub</a>
- </div>
-</section>
-{% endblock hero %}
-
-{% block toc %}
-{% endblock toc %}
-
-{% block content %}
-{% endblock content %}
diff --git a/docs/templates/_variables.html b/docs/templates/_variables.html
deleted file mode 100644
index edc787246..000000000
--- a/docs/templates/_variables.html
+++ /dev/null
@@ -1,142 +0,0 @@
-<style>
- /* Fallback fonts with adjusted metrics to prevent layout shift on font swap.
- * These match the metrics of the custom fonts so text doesn't reflow.
- * Values from: https://developer.chrome.com/blog/font-fallbacks
- * Inter values: https://github.com/rsms/inter/discussions/632
- */
- @font-face {
- font-family: "Inter Fallback";
- src: local("Arial"), local("ArialMT");
- ascent-override: 90.2%;
- descent-override: 22.5%;
- line-gap-override: 0%;
- size-adjust: 107.4%;
- }
- @font-face {
- font-family: "Plus Jakarta Sans Fallback";
- src: local("Arial"), local("ArialMT");
- /* Plus Jakarta Sans has similar metrics to Inter (geometric sans-serif) */
- ascent-override: 94%;
- descent-override: 23%;
- line-gap-override: 0%;
- size-adjust: 104%;
- }
- @font-face {
- font-family: "JetBrains Mono Fallback";
- src: local("Menlo"), local("Consolas"), local("Monaco");
- ascent-override: 102%;
- descent-override: 30%;
- line-gap-override: 0%;
- size-adjust: 98%;
- }
-
- :root {
- /* Warm Workbench Theme - Light Mode */
-
- /* Backgrounds */
- --wt-color-bg: #faf9f7; /* near-white with warmth */
- --wt-color-bg-elevated: #ffffff; /* pure white content cards */
- --wt-color-bg-soft: #f5f3f0; /* subtle warm gray for header/sections */
-
- /* Borders */
- --wt-color-border-subtle: #e8e6e3;
-
- /* Text */
- --wt-color-text: #2d2926; /* warm charcoal */
- --wt-color-text-muted: #6b635b; /* warm gray */
- --wt-color-text-soft: #78716a; /* lighter warm gray, WCAG AA compliant */
-
- /* Accents */
- --wt-color-accent: #d97706; /* amber */
- --wt-color-accent-soft: #fef3c7;
- --wt-color-accent-strong: #b45309;
- --wt-color-link: #b45309;
-
- /* Craft details */
- --wt-color-craft-brown: #8b7355; /* h2 underlines */
-
- /* Code */
- --wt-color-code-bg: #f8f7f6;
- --wt-color-code-border: #e5e3e0;
- --wt-color-code-inline-text: #b45309; /* amber text for inline code */
-
- /* Shadows - using oklch for proper alpha blending */
- --wt-shadow-soft: oklch(0% 0 0 / 0.03);
- --wt-shadow-medium: oklch(0% 0 0 / 0.06);
- --wt-shadow-accent: oklch(from var(--wt-color-accent) l c h / 0.15);
- --wt-shadow-accent-strong: oklch(from var(--wt-color-accent) l c h / 0.25);
-
- /* Terminal output colors (used by terminal shortcode) */
- --cyan: #0a8080;
- --green: #1b7f4b;
- --bright-white: #ece9e6; /* gutter background - subtle on light theme */
- --red: #dc2626;
- --yellow: #ca8a04;
- --blue: #2563eb;
- --magenta: #9333ea;
- --bright-black: #6b7280;
-
- /* Layout */
- --wt-header-height: 60px;
- --wt-main-padding-top: 40px;
-
- /* Border Radius Scale */
- --wt-radius-sm: 0.25rem; /* 4px - small elements, TOC items */
- --wt-radius-md: 0.5rem; /* 8px - buttons, inputs, cards */
- --wt-radius-lg: 0.75rem; /* 12px - content cards, modals */
- --wt-radius-pill: 999px; /* pill shapes */
-
- /* Typography - adjusted fallbacks prevent layout shift on font swap */
- --wt-font-sans: "Inter", "Inter Fallback", system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
- --wt-font-head: "Plus Jakarta Sans", "Plus Jakarta Sans Fallback", var(--wt-font-sans);
- --wt-font-mono: "JetBrains Mono", "JetBrains Mono Fallback", "Fira Code", "SF Mono", Menlo, monospace;
- }
-
- /* Dark Mode - follows system preference */
- @media (prefers-color-scheme: dark) {
- :root {
- /* Backgrounds - warm darks */
- --wt-color-bg: #1c1b1a;
- --wt-color-bg-elevated: #262524;
- --wt-color-bg-soft: #222120;
-
- /* Borders */
- --wt-color-border-subtle: #3a3836;
-
- /* Text - warm lights */
- --wt-color-text: #e8e6e3;
- --wt-color-text-muted: #a8a29e;
- --wt-color-text-soft: #8a847e;
-
- /* Accents - slightly brighter for dark backgrounds */
- --wt-color-accent: #f59e0b;
- --wt-color-accent-soft: #422006;
- --wt-color-accent-strong: #fbbf24;
- --wt-color-link: #fcd34d;
-
- /* Craft details - muted amber ties to brand in dark mode */
- --wt-color-craft-brown: #92400e;
-
- /* Code */
- --wt-color-code-bg: #252321;
- --wt-color-code-border: #3a3735;
- --wt-color-code-inline-text: #fbbf24; /* amber text for inline code */
-
- /* Shadows - lighter in dark mode for visibility */
- --wt-shadow-soft: oklch(0% 0 0 / 0.15);
- --wt-shadow-medium: oklch(0% 0 0 / 0.25);
- --wt-shadow-accent: oklch(from var(--wt-color-accent) l c h / 0.2);
- --wt-shadow-accent-strong: oklch(from var(--wt-color-accent) l c h / 0.35);
-
- /* Terminal colors - brighter for dark mode */
- --cyan: #67d4d4;
- --green: #4ade80;
- --bright-white: #3a3836; /* gutter background - subtle on dark theme */
- --red: #f87171;
- --yellow: #fbbf24;
- --blue: #60a5fa;
- --magenta: #c084fc;
- --bright-black: #6b7280;
- }
- }
-</style>
diff --git a/docs/templates/base.html b/docs/templates/base.html
deleted file mode 100644
index 9b7b8960f..000000000
--- a/docs/templates/base.html
+++ /dev/null
@@ -1,291 +0,0 @@
-{% import "macros.html" as macros %}
-<!DOCTYPE html>
-<html lang="en">
-
-<head>
- <script>
- // 1Password extension bug workaround: MUST be first script in document.
- // 1Password injects Prism.js targeting [class*="language-"], stripping our
- // syntect spans. Fix: rename language-* to lang-* before 1Password sees them.
- // https://1password.community/discussion/165597
- (function() {
- function fix(el) {
- if (el.className && el.className.replace) {
- el.className = el.className.replace(/\blanguage-\S*/g, '');
- }
- if (el.dataset && el.dataset.lang) el.removeAttribute('data-lang');
- }
- new MutationObserver(function(mutations) {
- for (var i = 0; i < mutations.length; i++) {
- var nodes = mutations[i].addedNodes;
- for (var j = 0; j < nodes.length; j++) {
- var n = nodes[j];
- if (n.nodeType === 1) {
- if (n.className && n.className.includes && n.className.includes('language-')) fix(n);
- var els = n.querySelectorAll ? n.querySelectorAll('[class*="language-"]') : [];
- for (var k = 0; k < els.length; k++) fix(els[k]);
- }
- }
- }
- }).observe(document.documentElement, { childList: true, subtree: true });
- })();
- </script>
- <meta charset="UTF-8">
- <title>{% block title %}{{ config.title }}{% endblock title %}</title>
- <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
- <link rel="icon" type="image/png" sizes="48x48" href="/favicon-48.png">
- <link rel="icon" type="image/png" sizes="32x32" href="/favicon.png">
- <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
-
- {% include "_variables.html" %}
-
- <link rel="preconnect" href="https://fonts.googleapis.com">
- <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
- <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&family=Plus+Jakarta+Sans:wght@500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
- <link rel="preload" href="{{ get_url(path='[email protected]') }}" as="image" media="(-webkit-min-device-pixel-ratio: 2), (min-resolution: 192dpi)">
- <link rel="preload" href="{{ get_url(path='logo.png') }}" as="image" media="not all and (-webkit-min-device-pixel-ratio: 2), not all and (min-resolution: 192dpi)">
-
- <script>
- // iOS viewport jank fix: Firefox/Chrome iOS have broken svh/lvh units that
- // behave like dvh, causing the hero to resize when browser chrome appears.
- // Root cause: Missing WebKit minimumViewportInset/maximumViewportInset APIs.
- // https://github.com/mozilla-mobile/firefox-ios/issues/11574
- //
- // Solution: Capture height ONCE on load, set --vh-full CSS variable.
- // CSS uses var(--vh-full, 100lvh) so iOS gets stable pixels, others get lvh.
- (function() {
- var isIOS = /iP(hone|ad|od)/.test(navigator.platform) ||
- (/Macintosh/.test(navigator.userAgent) && 'ontouchend' in document);
- if (!isIOS) return;
-
- var h = window.innerHeight;
- if (h) {
- document.documentElement.style.setProperty('--vh-full', h + 'px');
- }
-
- window.addEventListener('orientationchange', function() {
- setTimeout(function() {
- var newH = window.innerHeight;
- if (newH) {
- document.documentElement.style.setProperty('--vh-full', newH + 'px');
- }
- }, 100);
- });
- })();
- </script>
- <meta name="view-transition" content="same-origin">
- {% set page_description = page.description | default(value=config.extra.site_description) %}
- <meta name="description" content="{{ page_description }}">
- {% if page.extra.canonical %}
- <link rel="canonical" href="{{ config.base_url | trim_end_matches(pat='/') }}{{ page.extra.canonical }}">
- {% else %}
- <link rel="canonical" href="{{ current_url | default(value=config.base_url) }}">
- {% endif %}
-
- <!-- OpenGraph -->
- {% set og_title = page.title | default(value="") %}
- <meta property="og:type" content="website">
- <meta property="og:url" content="{% if page.extra.canonical %}{{ config.base_url | trim_end_matches(pat='/') }}{{ page.extra.canonical }}{% else %}{{ current_url | default(value=config.base_url) }}{% endif %}">
- {% if og_title %}{% set og_title_full = og_title ~ " | " ~ config.title %}{% else %}{% set og_title_full = config.title ~ " — " ~ config.extra.site_description %}{% endif %}
- <meta property="og:title" content="{{ og_title_full }}">
- <meta property="og:description" content="{{ page_description }}">
- <meta property="og:image" content="{{ config.base_url }}assets/social/social-card.png">
- <meta property="og:image:width" content="1200">
- <meta property="og:image:height" content="630">
-
- <!-- Twitter Card -->
- <meta name="twitter:card" content="summary_large_image">
- <meta name="twitter:title" content="{{ og_title_full }}">
- <meta name="twitter:description" content="{{ page_description }}">
- <meta name="twitter:image" content="{{ config.base_url }}assets/social/social-card.png">
-
- <!-- Structured data -->
- {% if not page.title %}
- <script type="application/ld+json">
- {
- "@context": "https://schema.org",
- "@type": "WebSite",
- "name": "Worktrunk",
- "url": "https://worktrunk.dev/",
- "description": "{{ config.extra.site_description }}"
- }
- </script>
- <script type="application/ld+json">
- {
- "@context": "https://schema.org",
- "@type": "SoftwareApplication",
- "name": "Worktrunk",
- "url": "https://worktrunk.dev/",
- "description": "{{ config.extra.site_description }}",
- "applicationCategory": "DeveloperApplication",
- "operatingSystem": "macOS, Linux, Windows",
- "offers": {
- "@type": "Offer",
- "price": "0",
- "priceCurrency": "USD"
- },
- "codeRepository": "https://github.com/max-sixty/worktrunk",
- "license": "https://opensource.org/licenses/Apache-2.0"
- }
- </script>
- {% endif %}
-
- <!-- Google tag (gtag.js) -->
- <script async src="https://www.googletagmanager.com/gtag/js?id=G-6YY8BDJ4QH"></script>
- <script>
- window.dataLayer = window.dataLayer || [];
- function gtag(){dataLayer.push(arguments);}
- gtag('js', new Date());
- gtag('config', 'G-6YY8BDJ4QH');
- </script>
-
- <link rel="stylesheet" href="/normalize.css">
- <link rel="preload" href="/custom.css" as="style">
- <link rel="stylesheet" href="/custom.css">
- <!-- Syntax highlighting themes - preload and load conditionally by color scheme -->
- <link rel="preload" href="/giallo-light.css" as="style" media="(prefers-color-scheme: light)">
- <link rel="preload" href="/giallo-dark.css" as="style" media="(prefers-color-scheme: dark)">
- <link rel="stylesheet" href="/giallo-light.css" media="(prefers-color-scheme: light)">
- <link rel="stylesheet" href="/giallo-dark.css" media="(prefers-color-scheme: dark)">
- <script src="/elasticlunr.min.js" defer></script>
- <script src="/search_index.en.js" defer></script>
- <script src="/search.js" defer></script>
- <script src="/code-copy.js" defer></script>
- <script src="/mobile-menu.js" defer></script>
- <script src="//instant.page/5.2.0" type="module" integrity="sha384-jnZyxPjiipYXnSU0ygqeac2q7CVYMbh84q0uHVRRxEtvFPiQYbXWUorga2aqZJ0z"></script>
- <script>
- // Show demo images with fade-in after they load (hides broken-image icon during loading)
- document.addEventListener('DOMContentLoaded', function() {
- document.querySelectorAll('figure.demo img').forEach(function(img) {
- if (img.complete) {
- img.classList.add('loaded');
- } else {
- img.addEventListener('load', function() { img.classList.add('loaded'); });
- }
- });
- });
- </script>
-</head>
-
-<body>
- <!-- iOS 26 Liquid Glass fix: solid scrim behind translucent browser chrome -->
- <div class="ios-chrome-scrim" aria-hidden="true"></div>
- <header>
- <button class="mobile-menu-toggle" aria-label="Open menu" aria-expanded="false">
- <svg class="menu-icon" aria-hidden="true" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
- <line x1="3" y1="6" x2="21" y2="6"></line>
- <line x1="3" y1="12" x2="21" y2="12"></line>
- <line x1="3" y1="18" x2="21" y2="18"></line>
- </svg>
- <svg class="close-icon" aria-hidden="true" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
- <line x1="18" y1="6" x2="6" y2="18"></line>
- <line x1="6" y1="6" x2="18" y2="18"></line>
- </svg>
- </button>
- <a href="/">
- <div class="logo">
- <img src="{{ get_url(path=config.extra.logo_path) }}" srcset="{{ get_url(path='logo.png') }} 1x, {{ get_url(path='[email protected]') }} 2x" alt="logo" width="44" height="44" decoding="sync" fetchpriority="high">
- {{ config.extra.logo_name }}
- </div>
- </a>
- <nav>
- <div class="search-container">
- <input id="userinput" type="search" placeholder="Search..." aria-label="Search documentation">
- <div id="suggestions"></div>
- </div>
- {% for menu in config.extra.extra_menu %}
- <a class="nav-item" href="{{ menu.link | safe }}">{{ menu.title }}</a>
- {% endfor %}
- </nav>
- </header>
-
- <!-- Mobile menu drawer -->
- <div class="mobile-menu-overlay" aria-hidden="true"></div>
- <nav class="mobile-menu" aria-hidden="true">
- <div class="mobile-menu-content">
- <div class="mobile-menu-section">
- {% for menu in config.extra.extra_menu %}
- <a class="mobile-nav-item" href="{{ menu.link | safe }}">{{ menu.title }}</a>
- {% endfor %}
- </div>
- <div class="mobile-menu-divider"></div>
- <div class="mobile-menu-section mobile-menu-toc">
- {% set docs_section = get_section(path="_index.md") %}
- {% set current_group = "" %}
- {% for doc_page in docs_section.pages %}
- {% if not doc_page.extra.hide_from_nav %}
- {% set page_group = doc_page.extra.group | default(value="") %}
- {% if page_group != current_group and page_group != "" %}
- <div class="mobile-toc-group">{{ page_group }}</div>
- {% set_global current_group = page_group %}
- {% endif %}
- <a class="mobile-toc-item" href="{{ doc_page.permalink | safe }}">{{ doc_page.title }}</a>
- {% endif %}
- {% endfor %}
- </div>
- </div>
- </nav>
-
- <div class="hero">
- {% block hero %}{% endblock hero %}
- </div>
-
- <main>
- {% block toc %}
- {% set docs_section = get_section(path="_index.md") %}
- {{ macros::toc_nav(docs_section=docs_section) }}
- {% endblock toc %}
-
- <div class="content" id="{% block content_id %}{% endblock content_id %}">
- {% block content %}
- {{ section.content | safe }}
- {% endblock content %}
- </div>
- </main>
-
- <footer>
- <div class="footer-social">
- <a href="https://github.com/max-sixty/worktrunk" aria-label="GitHub" title="GitHub">
- <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor">
- <path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z"/>
- </svg>
- </a>
- <a href="https://crates.io/crates/worktrunk" aria-label="Crates.io" title="Crates.io">
- <svg width="20" height="20" viewBox="0 0 512 512" fill="currentColor">
- <path d="M239.1 6.3l-208 78c-18.7 7-31.1 25-31.1 45v225.1c0 18.2 10.3 34.8 26.5 42.9l208 104c13.5 6.8 29.4 6.8 42.9 0l208-104c16.3-8.1 26.5-24.8 26.5-42.9V129.3c0-20-12.4-37.9-31.1-44.9l-208-78C262.4 2.2 249.6 2.2 239.1 6.3zM256 68.4l192 72v1.1l-192 78-192-78v-1.1l192-72zm32 356V275.5l160-65v160.4l-160 53.5z"/>
- </svg>
- </a>
- <a href="https://twitter.com/intent/tweet?text=Worktrunk%20%E2%80%94%20CLI%20for%20git%20worktree%20management&url=https%3A%2F%2Fworktrunk.dev" aria-label="Share on X" title="Share on X">
- <svg width="18" height="18" viewBox="0 0 24 24" fill="currentColor">
- <path d="M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z"/>
- </svg>
- </a>
- <a href="https://www.reddit.com/submit?url=https%3A%2F%2Fworktrunk.dev&title=Worktrunk%20%E2%80%94%20CLI%20for%20git%20worktree%20management" aria-label="Share on Reddit" title="Share on Reddit">
- <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor">
- <path d="M12 0A12 12 0 0 0 0 12a12 12 0 0 0 12 12 12 12 0 0 0 12-12A12 12 0 0 0 12 0zm5.01 4.744c.688 0 1.25.561 1.25 1.249a1.25 1.25 0 0 1-2.498.056l-2.597-.547-.8 3.747c1.824.07 3.48.632 4.674 1.488.308-.309.73-.491 1.207-.491.968 0 1.754.786 1.754 1.754 0 .716-.435 1.333-1.01 1.614a3.111 3.111 0 0 1 .042.52c0 2.694-3.13 4.87-7.004 4.87-3.874 0-7.004-2.176-7.004-4.87 0-.183.015-.366.043-.534A1.748 1.748 0 0 1 4.028 12c0-.968.786-1.754 1.754-1.754.463 0 .898.196 1.207.49 1.207-.883 2.878-1.43 4.744-1.487l.885-4.182a.342.342 0 0 1 .14-.197.35.35 0 0 1 .238-.042l2.906.617a1.214 1.214 0 0 1 1.108-.701zM9.25 12C8.561 12 8 12.562 8 13.25c0 .687.561 1.248 1.25 1.248.687 0 1.248-.561 1.248-1.249 0-.688-.561-1.249-1.249-1.249zm5.5 0c-.687 0-1.248.561-1.248 1.25 0 .687.561 1.248 1.249 1.248.688 0 1.249-.561 1.249-1.249 0-.687-.562-1.249-1.25-1.249zm-5.466 3.99a.327.327 0 0 0-.231.094.33.33 0 0 0 0 .463c.842.842 2.484.913 2.961.913.477 0 2.105-.056 2.961-.913a.361.361 0 0 0 .029-.463.33.33 0 0 0-.464 0c-.547.533-1.684.73-2.512.73-.828 0-1.979-.196-2.512-.73a.326.326 0 0 0-.232-.095z"/>
- </svg>
- </a>
- <a href="https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fworktrunk.dev" aria-label="Share on LinkedIn" title="Share on LinkedIn">
- <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor">
- <path d="M20.447 20.452h-3.554v-5.569c0-1.328-.027-3.037-1.852-3.037-1.853 0-2.136 1.445-2.136 2.939v5.667H9.351V9h3.414v1.561h.046c.477-.9 1.637-1.85 3.37-1.85 3.601 0 4.267 2.37 4.267 5.455v6.286zM5.337 7.433c-1.144 0-2.063-.926-2.063-2.065 0-1.138.92-2.063 2.063-2.063 1.14 0 2.064.925 2.064 2.063 0 1.139-.925 2.065-2.064 2.065zm1.782 13.019H3.555V9h3.564v11.452zM22.225 0H1.771C.792 0 0 .774 0 1.729v20.542C0 23.227.792 24 1.771 24h20.451C23.2 24 24 23.227 24 22.271V1.729C24 .774 23.2 0 22.222 0h.003z"/>
- </svg>
- </a>
- </div>
- </footer>
- <script>
- // Wrap code blocks in containers SYNCHRONOUSLY before first paint to prevent layout jump.
- // The deferred code-copy.js will add copy buttons to these wrappers later.
- (function() {
- var blocks = document.querySelectorAll('.content pre');
- for (var i = 0; i < blocks.length; i++) {
- var block = blocks[i];
- var wrapper = document.createElement('div');
- wrapper.className = 'code-block-wrapper';
- block.parentNode.insertBefore(wrapper, block);
- wrapper.appendChild(block);
- }
- })();
- </script>
-</body>
-
-</html>
diff --git a/docs/templates/index.html b/docs/templates/index.html
deleted file mode 100644
index 710f62b08..000000000
--- a/docs/templates/index.html
+++ /dev/null
@@ -1,95 +0,0 @@
-{% extends "base.html" %}
-
-{% block title %}Worktrunk — Git Worktree Manager for AI Agent Workflows{% endblock title %}
-
-{% block hero %}
-<style>
- .welcome {
- animation: welcome-animation 1s cubic-bezier(0.25, 0.1, 0.25, 1) both;
- animation-delay: 0.25s;
- }
-
- .hero-image {
- animation: logo-animation 2s cubic-bezier(0.25, 0.1, 0.25, 1) both;
- }
-
- @keyframes logo-animation {
- 0% {
- transform: rotateY(-40deg) rotateZ(90deg) translateX(-50%);
- filter: blur(50px);
- opacity: 0;
- }
- 50% {
- filter: blur(0);
- }
- 70% {
- opacity: 1;
- transform: rotateY(-10deg) rotateZ(10deg) translateX(5%);
- }
- 100% {
- transform: rotateY(0) rotateZ(0) translateX(0);
- }
- }
-
- @keyframes welcome-animation {
- 0% {
- transform: translateY(60%);
- filter: blur(10px);
- opacity: 0;
- }
- 100% {
- transform: translateY(0);
- filter: blur(0);
- opacity: 1;
- }
- }
-
- .hero section {
- padding: 0 5rem;
- }
- @media screen and (max-width: 768px) {
- .hero section {
- padding: 0 2rem;
- }
-
- .hero-image {
- display: none;
- }
- }
-</style>
-<section class="text-center welcome">
- <h1 class="heading-text" style="font-size: 50px"><a href="#worktrunk" class="heading-anchor">Worktrunk</a></h1>
- <h3 class="title-text">
- Git worktree management for <b style="white-space: nowrap">parallel AI agent workflows</b>
- </h3>
- <div style="display: flex; gap: 1rem; justify-content: center; align-items: center; margin-top: 1.5rem;">
- <button class="button" onclick="window.scrollTo({top: document.querySelector('main').offsetTop - document.querySelector('header').offsetHeight, behavior: 'smooth'})">Learn More</button>
- <a href="https://github.com/max-sixty/worktrunk" aria-label="GitHub stars">
- <img src="https://img.shields.io/github/stars/max-sixty/worktrunk?style=social" alt="GitHub stars">
- </a>
- </div>
-</section>
-<script>
- document.addEventListener('keydown', function(e) {
- if (e.key === 'Enter' && !e.target.matches('input, textarea, [contenteditable]')) {
- document.querySelector('.hero .button').click();
- }
- }, {once: true});
-</script>
-<img class="hero-image" src="{{ get_url(path='logo.png') }}" srcset="{{ get_url(path='logo.png') }} 1x, {{ get_url(path='[email protected]') }} 2x" alt="Worktrunk logo" decoding="sync" fetchpriority="high">
-{% endblock hero %}
-
-{% block toc %}
-{% set docs_section = get_section(path="_index.md") %}
-{{ macros::toc_nav(docs_section=docs_section) }}
-{% endblock toc %}
-
-{% block content_id %}worktrunk{% endblock content_id %}
-
-{% block content %}
-{# Display worktrunk content directly on homepage #}
-{% set docs_section = get_section(path="_index.md") %}
-{% set worktrunk = docs_section.pages | filter(attribute="slug", value="worktrunk") | first %}
-<h1 class="heading-text"><a href="#worktrunk" class="heading-anchor">{{ worktrunk.title }}</a></h1>
-{{ worktrunk.content | safe }}
-{% endblock content %}
diff --git a/docs/templates/macros.html b/docs/templates/macros.html
deleted file mode 100644
index 168be7e8b..000000000
--- a/docs/templates/macros.html
+++ /dev/null
@@ -1,55 +0,0 @@
-{% macro toc_nav(docs_section, current_page=false) %}
-<div class="toc">
- <div class="toc-sticky">
- {% set current_group = "" %}
- {% for doc_page in docs_section.pages %}
- {% if not doc_page.extra.hide_from_nav %}
- {% set is_current = current_page and doc_page.permalink == current_page.permalink %}
- {% set page_group = doc_page.extra.group | default(value="") %}
-
- {# Show group label when group changes #}
- {% if page_group != current_group and page_group != "" %}
- <div class="toc-group-label">{{ page_group }}</div>
- {% set_global current_group = page_group %}
- {% endif %}
-
- <div class="toc-item">
- <a class="subtext {% if is_current %}active{% endif %}" href="{{ doc_page.permalink | safe }}">
- {{ doc_page.title }}
- </a>
- </div>
-
- {# Show page TOC for current page (h1s with nested h2s, or standalone h2s) #}
- {% if is_current and current_page.toc %}
- {% for h in current_page.toc %}
- {% if h.level == 1 %}
- <div class="toc-item-child toc-h1">
- <a class="subtext" href="{{ h.permalink | safe }}">
- <small>{{ h.title }}</small>
- </a>
- </div>
- {# Show H2 children nested under this H1 #}
- {% for child in h.children | default(value=[]) %}
- {% if child.level == 2 %}
- <div class="toc-item-child toc-h2-under-h1">
- <a class="subtext" href="{{ child.permalink | safe }}">
- <small>{{ child.title }}</small>
- </a>
- </div>
- {% endif %}
- {% endfor %}
- {% elif h.level == 2 %}
- {# Standalone H2s (before any H1) #}
- <div class="toc-item-child">
- <a class="subtext" href="{{ h.permalink | safe }}">
- <small>{{ h.title }}</small>
- </a>
- </div>
- {% endif %}
- {% endfor %}
- {% endif %}
- {% endif %}
- {% endfor %}
- </div>
-</div>
-{% endmacro toc_nav %}
diff --git a/docs/templates/page.html b/docs/templates/page.html
deleted file mode 100644
index 9ca7a58d7..000000000
--- a/docs/templates/page.html
+++ /dev/null
@@ -1,48 +0,0 @@
-{% extends "base.html" %}
-
-{% block title %}{{ page.title }} | {{ config.title }}{% endblock title %}
-
-{% block toc %}
-{% set docs_section = get_section(path="_index.md") %}
-{{ macros::toc_nav(docs_section=docs_section, current_page=page) }}
-{% endblock toc %}
-
-{% block content_id %}{{ page.slug }}{% endblock content_id %}
-
-{% block content %}
-<h1 class="heading-text"><a href="#{{ page.slug }}" class="heading-anchor">{{ page.title }}</a></h1>
-{{ page.content | safe }}
-
-{# Calculate prev/next from section pages #}
-{% set prev_page = false %}
-{% set next_page = false %}
-{% set found_current = false %}
-{% for doc_page in docs_section.pages %}
- {# A hide_from_nav page is skipped as a prev/next candidate, so nothing links
- into it, but the current-page test below stays unguarded: viewing such a
- page directly must still flip found_current, or its own prev/next would
- compute against the wrong neighbour. It keeps a prev link back out. #}
- {% set hidden = doc_page.extra.hide_from_nav | default(value=false) %}
- {% if found_current and not next_page and not hidden %}
- {% set_global next_page = doc_page %}
- {% endif %}
- {% if doc_page.permalink == page.permalink %}
- {% set_global found_current = true %}
- {% endif %}
- {% if not found_current and not hidden %}
- {% set_global prev_page = doc_page %}
- {% endif %}
-{% endfor %}
-
-<div class="page-nav">
- {% if prev_page %}
- <a href="{{ prev_page.permalink | safe }}">← {{ prev_page.title }}</a>
- {% else %}
- <span></span>
- {% endif %}
-
- {% if next_page %}
- <a href="{{ next_page.permalink | safe }}">{{ next_page.title }} →</a>
- {% endif %}
-</div>
-{% endblock content %}
diff --git a/docs/templates/shortcodes/rawcode.html b/docs/templates/shortcodes/rawcode.html
deleted file mode 100644
index b4e06a0ef..000000000
--- a/docs/templates/shortcodes/rawcode.html
+++ /dev/null
@@ -1 +0,0 @@
-<code class="multiline">{{ body | safe }}</code>
diff --git a/docs/templates/shortcodes/terminal.html b/docs/templates/shortcodes/terminal.html
deleted file mode 100644
index f769b625b..000000000
--- a/docs/templates/shortcodes/terminal.html
+++ /dev/null
@@ -1,33 +0,0 @@
-{% if cmd %}
-{% set fence = "```" %}
-{% set cmd_lines = cmd | split(pat="|||") %}
-{% if body is defined %}
-{% set clean_body = body | regex_replace(pattern='<span class="cmd">[^<]*</span>\n?', rep="") %}
-{% set extra_class = "" %}
-{% else %}
-{% set clean_body = "" %}
-{% set extra_class = " terminal--commands" %}
-{% endif %}
-<pre class="terminal{{ extra_class }}"><code>
-{%- for cmd_line in cmd_lines -%}
-{%- set cmd_line = cmd_line | replace(from="__WT_OPEN__", to="{{") | replace(from="__WT_CLOSE__", to="}}") | replace(from="__WT_QUOT__", to='"') -%}
-{%- if cmd_line | trim == "" -%}
-{{ "
-" }}
-{%- else -%}
-{%- set md = fence ~ "bash
-" ~ cmd_line ~ "
-" ~ fence -%}
-{%- set raw = md | markdown -%}
-{%- set hl = raw | regex_replace(pattern="(?s)<pre[^>]*><code[^>]*>(.*)</code>\s*</pre>", rep="$1") | trim -%}
-{%- if cmd_line is starting_with("#") -%}
-{{ hl | safe }}
-{% else -%}
-<span class="cmd">{{ hl | safe }}</span>
-{% endif -%}
-{%- endif -%}
-{%- endfor -%}
-{{ clean_body | safe }}</code></pre>
-{% else %}
-<pre class="terminal"><code>{{ body | safe }}</code></pre>
-{% endif %}
diff --git a/docs/templates/sitemap.xml b/docs/templates/sitemap.xml
deleted file mode 100644
index 6e5bd553c..000000000
--- a/docs/templates/sitemap.xml
+++ /dev/null
@@ -1,16 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
- {%- for sitemap_entry in entries %}
- {#- Skip pages that declare a non-self canonical — only canonical URLs belong in the sitemap. #}
- {%- if not sitemap_entry.extra.canonical %}
- <url>
- <loc>{{ sitemap_entry.permalink | escape_xml | safe }}</loc>
- {%- if sitemap_entry.updated %}
- <lastmod>{{ sitemap_entry.updated }}</lastmod>
- {%- else %}
- <lastmod>{{ now() | date(format="%Y-%m-%d") }}</lastmod>
- {%- endif %}
- </url>
- {%- endif %}
- {%- endfor %}
-</urlset>
diff --git a/docs/tests/built-site.test.mjs b/docs/tests/built-site.test.mjs
new file mode 100644
index 000000000..b8daea194
--- /dev/null
+++ b/docs/tests/built-site.test.mjs
@@ -0,0 +1,515 @@
+import assert from 'node:assert/strict';
+import { readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import test from 'node:test';
+import { fileURLToPath } from 'node:url';
+
+import {
+ keepCurrentTocLinkVisible,
+ syncTocCurrentToHash,
+} from '../src/components/toc-scroll.mjs';
+
+const docsRoot = fileURLToPath(new URL('..', import.meta.url));
+const dist = path.join(docsRoot, 'dist');
+const publicRoutes = [
+ '/',
+ '/claude-code/',
+ '/code-signing/',
+ '/config/',
+ '/extending/',
+ '/faq/',
+ '/hook/',
+ '/list/',
+ '/llm-commits/',
+ '/merge/',
+ '/remove/',
+ '/step/',
+ '/switch/',
+ '/tips-patterns/',
+];
+
+async function htmlFiles(directory = dist) {
+ const entries = await readdir(directory, { withFileTypes: true });
+ const nested = await Promise.all(entries.map((entry) => {
+ const file = path.join(directory, entry.name);
+ return entry.isDirectory() ? htmlFiles(file) : entry.name.endsWith('.html') ? [file] : [];
+ }));
+ return nested.flat();
+}
+
+async function allFiles(directory = dist) {
+ const entries = await readdir(directory, { withFileTypes: true });
+ const nested = await Promise.all(entries.map((entry) => {
+ const file = path.join(directory, entry.name);
+ return entry.isDirectory() ? allFiles(file) : [file];
+ }));
+ return nested.flat();
+}
+
+function routeFile(pathname) {
+ if (pathname === '/') return path.join(dist, 'index.html');
+ if (pathname === '/404/') return path.join(dist, '404.html');
+ if (pathname.endsWith('/')) return path.join(dist, pathname, 'index.html');
+ if (pathname.endsWith('.html')) return path.join(dist, pathname);
+}
+
+const renderedPages = [
+ '/404/',
+ ...publicRoutes,
+ '/worktrunk/',
+].map(routeFile);
+
+function fileRoute(file) {
+ const relative = path.relative(dist, file);
+ if (relative === 'index.html') return '/';
+ if (relative === '404.html') return '/404/';
+ return `/${path.dirname(relative)}/`;
+}
+
+function tableSummaries(html) {
+ const text = (value) => value
+ .replace(/<[^>]*>/g, '')
+ .replaceAll('&#x26;', '&')
+ .replaceAll('&amp;', '&')
+ .replace(/\s+/g, ' ')
+ .trim();
+ return [...html.matchAll(/<table\b([^>]*)>([\s\S]*?)<\/table>/g)].map((match) => {
+ const body = match[2].match(/<tbody>([\s\S]*?)<\/tbody>/)?.[1] ?? '';
+ const rows = [...body.matchAll(/<tr\b[^>]*>([\s\S]*?)<\/tr>/g)];
+ return {
+ attributes: match[1],
+ headers: [...match[2].matchAll(/<th\b[^>]*>([\s\S]*?)<\/th>/g)]
+ .map((header) => text(header[1])),
+ rowLabels: rows.map((row) => (
+ [...row[1].matchAll(/<span\b([^>]*)>([\s\S]*?)<\/span>/g)]
+ .filter((label) => (
+ /\baria-hidden="true"/.test(label[1])
+ && /\bclass="[^"]*\bwt-responsive-record-label\b[^"]*"/.test(label[1])
+ ))
+ .map((label) => text(label[2]))
+ )),
+ };
+ });
+}
+
+function renderedText(html) {
+ return html
+ .replace(/<[^>]*>/g, '')
+ .replace(/&#x([\da-f]+);/giu, (_, value) => String.fromCodePoint(Number.parseInt(value, 16)))
+ .replace(/&#(\d+);/gu, (_, value) => String.fromCodePoint(Number(value)))
+ .replaceAll('&quot;', '"')
+ .replaceAll('&gt;', '>')
+ .replaceAll('&lt;', '<')
+ .replaceAll('&amp;', '&');
+}
+
+test('build preserves the public route contract', async () => {
+ const files = new Set(await htmlFiles());
+ const buildFiles = new Set(await allFiles());
+ const expected = [
+ path.join(dist, '404.html'),
+ ...publicRoutes.map(routeFile),
+ routeFile('/worktrunk/'),
+ ];
+ for (const file of expected) assert.ok(files.has(file), `missing ${file}`);
+
+ const sitemap = await readFile(path.join(dist, 'sitemap-0.xml'), 'utf8');
+ for (const route of publicRoutes) {
+ assert.match(sitemap, new RegExp(`<loc>https://worktrunk\\.dev${route}</loc>`));
+ }
+ assert.doesNotMatch(sitemap, /worktrunk\.dev\/(?:404|worktrunk)\//);
+
+ const robots = await readFile(path.join(dist, 'robots.txt'), 'utf8');
+ for (const match of robots.matchAll(/^Sitemap:\s+(\S+)$/gm)) {
+ const url = new URL(match[1]);
+ assert.equal(url.origin, 'https://worktrunk.dev');
+ assert.ok(buildFiles.has(path.join(dist, url.pathname)), `robots.txt references missing ${url.pathname}`);
+ }
+
+ const compatibilityPage = await readFile(routeFile('/worktrunk/'), 'utf8');
+ assert.match(compatibilityPage, /<link rel="canonical" href="https:\/\/worktrunk\.dev\/"/);
+ assert.match(compatibilityPage, /<meta name="robots" content="noindex"/);
+ assert.match(compatibilityPage, /<meta property="og:url" content="https:\/\/worktrunk\.dev\/"/);
+ assert.doesNotMatch(compatibilityPage, /<meta property="og:url" content="https:\/\/worktrunk\.dev\/worktrunk\/"/);
+
+ const homepage = await readFile(routeFile('/'), 'utf8');
+ assert.match(homepage, /<title>Worktrunk — Git worktree management for parallel AI agent workflows<\/title>/);
+ assert.doesNotMatch(homepage, /data-contract="home-hero"/);
+ assert.doesNotMatch(homepage, /data-has-hero/);
+ assert.doesNotMatch(homepage, />\s*Learn More\s*</);
+ assert.match(
+ homepage,
+ /<a\b[^>]*data-contract="github-stars"[^>]*href="https:\/\/github\.com\/max-sixty\/worktrunk"[^>]*>[\s\S]*?<img\b[^>]*src="https:\/\/img\.shields\.io\/github\/stars\/max-sixty\/worktrunk\?style=social"[^>]*>[\s\S]*?<\/a>/,
+ );
+ assert.doesNotMatch(homepage, />\s*GitHub stars\s*</);
+ assert.match(
+ homepage,
+ /<div\b[^>]*class="wt-home"[^>]*>[\s\S]*?<p>Worktrunk is a CLI for Git worktree management, designed for <strong>parallel AI agent\s+workflows<\/strong>\.<\/p>/,
+ );
+ assert.match(homepage, /<button\b[^>]*aria-label="Menu"[^>]*aria-controls="starlight__sidebar"/);
+ assert.match(homepage, /<div id="starlight__sidebar" class="sidebar-pane\b/);
+ assert.match(homepage, /<a\b[^>]*href="\/switch\/"[^>]*><span\b[^>]*>wt switch<\/span><\/a>/);
+ assert.match(homepage, /<a\b[^>]*href="\/faq\/"[^>]*><span\b[^>]*>FAQ<\/span><\/a>/);
+ assert.doesNotMatch(homepage, /data-has-toc/);
+ assert.doesNotMatch(homepage, /<nav aria-labelledby="starlight__on-this-page">/);
+ assert.doesNotMatch(homepage, /<starlight-theme-select>/);
+ assert.match(homepage, /<div\b[^>]*class="wt-home"[^>]*data-contract="home-content-rail"/);
+ assert.match(homepage, /<h1 id="_top"[^>]*><span id="worktrunk"[^>]*>Worktrunk<\/span><\/h1>/);
+ assert.match(
+ homepage,
+ /<source srcset="\/assets\/docs\/dark\/wt-core-mobile\.gif"[^>]*data-demo-theme="dark"[^>]*data-demo-media="\(max-width: 42rem\)"/,
+ );
+ assert.match(
+ homepage,
+ /<source srcset="\/assets\/docs\/light\/wt-core-mobile\.gif"[^>]*data-demo-theme="light"[^>]*data-demo-media="\(max-width: 42rem\)"/,
+ );
+ assert.match(homepage, /<img src="\/assets\/docs\/light\/wt-core\.gif"/);
+ assert.equal(homepage.match(/<h1\b/g)?.length, 1);
+ assert.match(homepage, /<pre><code>git worktree add -b feat \.\.\/repo\.feat &#x26;&#x26; \\\ncd \.\.\/repo\.feat &#x26;&#x26; \\\nclaude<\/code><\/pre>/);
+ const comparison = homepage.match(/<table class="cmd-compare">([\s\S]*?)<\/table>/)?.[1];
+ assert.ok(comparison, 'homepage is missing the command comparison table');
+ assert.equal(comparison.match(/<td data-label="Worktrunk">/g)?.length, 4);
+ assert.equal(comparison.match(/<td data-label="Plain git">/g)?.length, 4);
+ assert.match(homepage, /class="wt-positive"/);
+ assert.match(homepage, /class="wt-negative"/);
+ assert.match(homepage, /<nav\b[^>]*data-contract="project-links"[^>]*aria-label="Project links"/);
+ assert.match(homepage, /href="https:\/\/crates\.io\/crates\/worktrunk"/);
+ assert.match(homepage, /href="https:\/\/twitter\.com\/intent\/tweet\?/);
+ assert.match(homepage, /href="https:\/\/www\.reddit\.com\/submit\?/);
+ assert.match(homepage, /href="https:\/\/www\.linkedin\.com\/sharing\/share-offsite\/\?/);
+
+ const switchPage = await readFile(routeFile('/switch/'), 'utf8');
+ assert.match(switchPage, /<nav aria-labelledby="starlight__on-this-page">/);
+ assert.match(
+ switchPage,
+ /<a\b[^>]*data-contract="github-stars"[^>]*href="https:\/\/github\.com\/max-sixty\/worktrunk"[^>]*>[\s\S]*?<img\b[^>]*src="https:\/\/img\.shields\.io\/github\/stars\/max-sixty\/worktrunk\?style=social"[^>]*>[\s\S]*?<\/a>/,
+ );
+ assert.doesNotMatch(switchPage, /<starlight-theme-select>/);
+
+ const listPage = await readFile(routeFile('/list/'), 'utf8');
+ assert.match(listPage, /href="https:\/\/github\.com\/max-sixty\/worktrunk\/edit\/main\/docs\/src\/content\/docs\/list\.md"/);
+ assert.doesNotMatch(listPage, /docs\/src\/content\/docs\/src\/content\/docs/);
+
+ const configPage = await readFile(routeFile('/config/'), 'utf8');
+ const configToc = configPage.match(
+ /<nav aria-labelledby="starlight__on-this-page">([\s\S]*?)<\/nav>/,
+ )?.[1];
+ assert.ok(configToc, 'config page is missing its desktop table of contents');
+ assert.equal(
+ [...configToc.matchAll(/<a href="#[^"]+"/g)].length,
+ 32,
+ 'config table of contents should expose overview and structural section headings only',
+ );
+ for (const [id, title] of [
+ ['user-configuration', 'User Configuration'],
+ ['project-configuration', 'Project Configuration'],
+ ['shell-integration', 'Shell Integration'],
+ ['other', 'Other'],
+ ['subcommands', 'Subcommands'],
+ ]) {
+ assert.match(
+ configToc,
+ new RegExp(`<a href="#${id}"[^>]*>[\\s\\S]*?<span[^>]*>${title}</span></a>`),
+ );
+ }
+ assert.doesNotMatch(configToc, /href="#claude-code"/);
+ assert.doesNotMatch(configToc, /href="#command-reference-1"/);
+
+ const structuralSections = new Map([
+ ['/hook/', ['hook-types', 'security', 'configuration', 'running-hooks-manually', 'recipes']],
+ ['/list/', ['subcommands']],
+ ['/step/', ['subcommands']],
+ ]);
+ for (const [route, ids] of structuralSections) {
+ const page = await readFile(routeFile(route), 'utf8');
+ const toc = page.match(/<nav aria-labelledby="starlight__on-this-page">([\s\S]*?)<\/nav>/)?.[1];
+ assert.ok(toc, `${route} is missing its desktop table of contents`);
+ for (const id of ids) assert.match(toc, new RegExp(`<a href="#${id}"`));
+ }
+});
+
+test('nested command references expose unique search-only fragment titles', async () => {
+ const stepPage = await readFile(routeFile('/step/'), 'utf8');
+ assert.match(stepPage, /<h2 id="command-reference">Command reference<\/h2>/);
+
+ const references = [...stepPage.matchAll(
+ /<h3 id="command-reference-\d+"><span class="wt-pagefind-fragment-title" hidden aria-hidden="true">(wt step [^<]+) — <\/span>Command reference<\/h3>/g,
+ )].map((match) => match[1]);
+ assert.deepEqual(references, [
+ 'wt step commit',
+ 'wt step squash',
+ 'wt step rebase',
+ 'wt step push',
+ 'wt step diff',
+ 'wt step copy-ignored',
+ 'wt step eval',
+ 'wt step for-each',
+ 'wt step promote',
+ 'wt step prune',
+ 'wt step relocate',
+ 'wt step tether',
+ ]);
+
+ const listPage = await readFile(routeFile('/list/'), 'utf8');
+ assert.match(
+ listPage,
+ /<h3 id="command-reference-1"><span class="wt-pagefind-fragment-title" hidden aria-hidden="true">wt list statusline — <\/span>Command reference<\/h3>/,
+ );
+});
+
+test('built pages only reference emitted local assets', async () => {
+ const files = new Set(await allFiles());
+
+ for (const page of renderedPages) {
+ const html = await readFile(page, 'utf8');
+ const assertAsset = (reference) => {
+ const url = new URL(reference.replaceAll('&amp;', '&'), `https://worktrunk.dev${fileRoute(page)}`);
+ if (url.origin !== 'https://worktrunk.dev' || url.pathname.endsWith('/')) return;
+ const target = path.join(dist, decodeURIComponent(url.pathname));
+ assert.ok(files.has(target), `${page} references missing asset ${url.pathname}`);
+ };
+ for (const match of html.matchAll(/\s(href|src|srcset)="([^"]+)"/g)) {
+ const references = match[1] === 'srcset'
+ ? match[2].split(',').map((candidate) => candidate.trim().split(/\s+/, 1)[0])
+ : [match[2]];
+ for (const reference of references) assertAsset(reference);
+ }
+ for (const match of html.matchAll(/<meta (?:property="og:image"|name="twitter:image") content="([^"]+)"/g)) {
+ assertAsset(match[1]);
+ }
+ }
+});
+
+test('output-only console blocks do not expose copy controls', async () => {
+ let outputOnlyBlocks = 0;
+ for (const page of renderedPages) {
+ const html = await readFile(page, 'utf8');
+ for (const match of html.matchAll(/<figure class="frame is-terminal[^"]*">([\s\S]*?)<\/figure>/g)) {
+ const frame = match[1];
+ if (!/class="ec-line wt-output"/.test(frame)) continue;
+ if (/class="ec-line wt-(?:command|copyable)"/.test(frame)) continue;
+ outputOnlyBlocks += 1;
+ assert.doesNotMatch(frame, /class="copy"/, `${page} exposes a copy control for captured output`);
+ }
+ }
+ assert.equal(outputOnlyBlocks, 1, 'expected the FAQ approval transcript to exercise this case');
+});
+
+test('command-bearing console blocks emit command-only copy payloads', async () => {
+ let commandBearingBlocks = 0;
+ for (const page of renderedPages) {
+ const html = await readFile(page, 'utf8');
+ for (const match of html.matchAll(/<figure class="frame is-terminal[^"]*">([\s\S]*?)<\/figure>/g)) {
+ const frame = match[1];
+ const lines = [...frame.matchAll(
+ /<div class="ec-line wt-(command|copyable|output)"><div class="code">([\s\S]*?)<\/div><\/div>/g,
+ )];
+ const expected = lines
+ .filter((line) => line[1] !== 'output')
+ .map((line) => renderedText(line[2]).replace(/\n$/u, ''));
+ if (expected.length === 0) continue;
+
+ commandBearingBlocks += 1;
+ const encodedPayload = frame.match(/<button\b[^>]*\bdata-code="([^"]*)"/)?.[1];
+ assert.notEqual(encodedPayload, undefined, `${page} is missing a terminal copy payload`);
+ assert.equal(renderedText(encodedPayload), expected.join('\u007f'), `${page} copies captured output`);
+ }
+ }
+ assert.ok(commandBearingBlocks > 0, 'expected command-bearing console blocks');
+});
+
+test('titleless code frames do not render decorative headers', async () => {
+ for (const page of renderedPages) {
+ const html = await readFile(page, 'utf8');
+ assert.doesNotMatch(
+ html,
+ /<figcaption class="header"><span class="title"><\/span>/,
+ `${page} renders chrome for an untitled code block`,
+ );
+ }
+});
+
+test('long desktop TOCs keep the current link inside their own scrollport', () => {
+ const scrollport = {
+ clientHeight: 1_000,
+ scrollHeight: 1_961,
+ scrollTop: 0,
+ getBoundingClientRect: () => ({ top: 0, bottom: 1_000 }),
+ };
+ const visibleToc = {
+ closest: () => scrollport,
+ getClientRects: () => [{}],
+ };
+ const current = {
+ closest: () => visibleToc,
+ getBoundingClientRect: () => ({ top: 1_386.84375, bottom: 1_411.09375 }),
+ };
+
+ assert.equal(keepCurrentTocLinkVisible(current), true);
+ assert.equal(scrollport.scrollTop, 459.09375);
+
+ current.getBoundingClientRect = () => ({ top: 500, bottom: 525 });
+ assert.equal(keepCurrentTocLinkVisible(current), false);
+ assert.equal(scrollport.scrollTop, 459.09375);
+
+ current.getBoundingClientRect = () => ({ top: 20, bottom: 45 });
+ assert.equal(keepCurrentTocLinkVisible(current), true);
+ assert.equal(scrollport.scrollTop, 431.09375);
+
+ visibleToc.getClientRects = () => [];
+ current.getBoundingClientRect = () => ({ top: 1_386.84375, bottom: 1_411.09375 });
+ assert.equal(keepCurrentTocLinkVisible(current), false);
+ assert.equal(scrollport.scrollTop, 431.09375);
+
+ visibleToc.getClientRects = () => [{}];
+ scrollport.scrollHeight = scrollport.clientHeight;
+ assert.equal(keepCurrentTocLinkVisible(current), false);
+ assert.equal(scrollport.scrollTop, 431.09375);
+});
+
+test('hash navigation selects the requested section in every rendered TOC', () => {
+ const link = (hash, current = false) => ({
+ hash,
+ current,
+ getAttribute(name) {
+ return name === 'aria-current' && this.current ? 'true' : null;
+ },
+ setAttribute(name, value) {
+ if (name === 'aria-current') this.current = value === 'true';
+ },
+ removeAttribute(name) {
+ if (name === 'aria-current') this.current = false;
+ },
+ textContent: hash.slice(1).replaceAll('-', ' '),
+ });
+ const root = (mobile = false) => {
+ const overview = link('#_top', true);
+ const requested = link('#reporting-a-problem');
+ const display = mobile ? { textContent: '' } : null;
+ return {
+ display,
+ links: [overview, requested],
+ querySelector(selector) {
+ return selector === '.display-current' ? display : null;
+ },
+ querySelectorAll(selector) {
+ if (selector === 'a') return this.links;
+ if (selector === 'a[aria-current="true"]') {
+ return this.links.filter((candidate) => candidate.current);
+ }
+ return [];
+ },
+ };
+ };
+ const desktop = root();
+ const mobile = root(true);
+ const doc = {
+ querySelectorAll: () => [desktop, mobile],
+ };
+
+ assert.equal(syncTocCurrentToHash(doc, '#reporting-a-problem'), true);
+ for (const toc of [desktop, mobile]) {
+ assert.equal(toc.links[0].current, false);
+ assert.equal(toc.links[1].current, true);
+ }
+ assert.equal(mobile.display.textContent, 'reporting a problem');
+ assert.equal(syncTocCurrentToHash(doc, '#missing'), false);
+});
+
+test('every structural content heading appears in the page outline', async () => {
+ for (const route of publicRoutes.filter((candidate) => candidate !== '/')) {
+ const page = await readFile(routeFile(route), 'utf8');
+ const headings = [...page.matchAll(/<h[12]\b[^>]*\bid="([^"]+)"/g)]
+ .map((match) => match[1])
+ .filter((id) => id !== 'starlight__on-this-page');
+ const toc = page.match(/<nav aria-labelledby="starlight__on-this-page">([\s\S]*?)<\/nav>/)?.[1];
+ assert.ok(toc, `${route} is missing its desktop table of contents`);
+ const links = [...toc.matchAll(/<a href="#([^"]+)"/g)].map((match) => match[1]);
+ assert.deepEqual(links, headings, `${route} outline does not match its structural headings`);
+ }
+});
+
+test('short wide tables become labeled records without capturing dense tables', async () => {
+ const pages = new Map(await Promise.all(publicRoutes.map(async (route) => (
+ [route, await readFile(routeFile(route), 'utf8')]
+ ))));
+ const tables = new Map([...pages].map(([route, html]) => [route, tableSummaries(html)]));
+ const findTable = (route, headers) => {
+ const table = tables.get(route).find((candidate) => (
+ candidate.headers.join('|') === headers.join('|')
+ ));
+ assert.ok(table, `${route} is missing table ${headers.join(' | ')}`);
+ return table;
+ };
+
+ const configFiles = findTable(
+ '/config/',
+ ['File', 'Location', 'Contains', 'Committed & shared'],
+ );
+ assert.match(configFiles.attributes, /class="wt-responsive-records"/);
+
+ for (const pageTables of tables.values()) {
+ for (const table of pageTables) {
+ if (!/\bwt-responsive-records\b/.test(table.attributes)) continue;
+ assert.ok(table.headers.length >= 3);
+ assert.ok(table.rowLabels.length >= 1 && table.rowLabels.length <= 3);
+ assert.deepEqual(
+ table.rowLabels,
+ Array.from({ length: table.rowLabels.length }, () => table.headers),
+ );
+ }
+ }
+
+ assert.doesNotMatch(
+ findTable('/extending/', ['', 'Hooks', 'Aliases', 'Custom subcommands']).attributes,
+ /\bwt-responsive-records\b/,
+ );
+ assert.doesNotMatch(
+ findTable('/claude-code/', ['Capability', 'Claude Code', 'Codex', 'OpenCode', 'Gemini CLI']).attributes,
+ /\bwt-responsive-records\b/,
+ );
+ assert.doesNotMatch(
+ findTable('/hook/', ['Kind', 'Variable', 'Description']).attributes,
+ /\bwt-responsive-records\b/,
+ );
+ assert.doesNotMatch(
+ findTable('/list/', ['Column', 'Shows']).attributes,
+ /\bwt-responsive-records\b/,
+ );
+ assert.doesNotMatch(
+ findTable('/', ['Task', 'Worktrunk', 'Plain git']).attributes,
+ /\bwt-responsive-records\b/,
+ );
+});
+
+test('mobile menu control is hidden until its script is available', async () => {
+ const faqPage = await readFile(routeFile('/faq/'), 'utf8');
+ assert.match(faqPage, /<starlight-menu-button\b/);
+ assert.match(
+ faqPage,
+ /<style>\s*starlight-menu-button:not\(:defined\)\s*\{\s*display:\s*none;\s*\}\s*<\/style>/,
+ );
+});
+
+test('built pages have unique IDs and valid internal page links', async () => {
+ const pages = await htmlFiles();
+ const contents = new Map(await Promise.all(pages.map(async (file) => [file, await readFile(file, 'utf8')])));
+
+ for (const [source, html] of contents) {
+ const ids = [...html.matchAll(/\sid="([^"]+)"/g)].map((match) => match[1]);
+ assert.equal(new Set(ids).size, ids.length, `duplicate ID in ${source}`);
+
+ for (const match of html.matchAll(/\shref="([^"]+)"/g)) {
+ const href = match[1].replaceAll('&amp;', '&');
+ const url = new URL(href, `https://worktrunk.dev${fileRoute(source)}`);
+ if (url.origin !== 'https://worktrunk.dev') continue;
+ const targetFile = routeFile(decodeURIComponent(url.pathname));
+ if (!targetFile) continue;
+ const target = contents.get(targetFile);
+ assert.ok(target, `${source} links to missing page ${url.pathname}`);
+ if (!url.hash) continue;
+ const id = decodeURIComponent(url.hash.slice(1));
+ assert.match(target, new RegExp(`\\sid="${id.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}"`), `${source} links to missing ${url.hash}`);
+ }
+ }
+});
diff --git a/docs/tests/plugins.test.mjs b/docs/tests/plugins.test.mjs
new file mode 100644
index 000000000..673fed83d
--- /dev/null
+++ b/docs/tests/plugins.test.mjs
@@ -0,0 +1,337 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import {
+ rehypeStableHeadingIds,
+ slugHeading,
+} from '../src/plugins/stable-heading-ids.mjs';
+import { rehypePagefindCommandReferences } from '../src/plugins/pagefind-command-references.mjs';
+import { rehypeResponsiveTables } from '../src/plugins/responsive-tables.mjs';
+import {
+ pluginWorktrunkTerminal,
+ semanticOutputSegments,
+} from '../src/plugins/worktrunk-terminal.mjs';
+
+function markdownTable(headers, rows, { className, headerProperties } = {}) {
+ const row = (tagName, values, properties = []) => ({
+ type: 'element',
+ tagName: 'tr',
+ properties: {},
+ children: values.map((value, index) => ({
+ type: 'element',
+ tagName,
+ properties: properties[index] ?? {},
+ children: [{ type: 'text', value }],
+ })),
+ });
+ return {
+ type: 'element',
+ tagName: 'table',
+ properties: className ? { className } : {},
+ children: [
+ {
+ type: 'element',
+ tagName: 'thead',
+ properties: {},
+ children: [row('th', headers, headerProperties)],
+ },
+ {
+ type: 'element',
+ tagName: 'tbody',
+ properties: {},
+ children: rows.map((values) => row('td', values)),
+ },
+ ],
+ };
+}
+
+test('heading slugs preserve existing public anchors', () => {
+ const headings = new Map([
+ ['Example: CI/testing override', 'example-ci-testing-override'],
+ ['Inline config overrides (--config-set)', 'inline-config-overrides-config-set'],
+ ['What’s cached', 'what-s-cached'],
+ ['What’s logged', 'what-s-logged'],
+ ['Command log (commands.jsonl)', 'command-log-commands-jsonl'],
+ ['vs. git-machete / git-town', 'vs-git-machete-git-town'],
+ ["There's an issue with my shell setup", 'there-s-an-issue-with-my-shell-setup'],
+ ['What does -v / -vv do?', 'what-does-v-vv-do'],
+ [
+ 'My for-each or --execute alias prints the same value in every worktree',
+ 'my-for-each-or-execute-alias-prints-the-same-value-in-every-worktree',
+ ],
+ ['working_tree object', 'working-tree-object'],
+ ['main_state values', 'main-state-values'],
+ ['integration_reason values', 'integration-reason-values'],
+ ['ci.status and ci.review_state values', 'ci-status-and-ci-review-state-values'],
+ ['Node.js', 'node-js'],
+ ['Shell alias for new worktree + agent', 'shell-alias-for-new-worktree-agent'],
+ ]);
+ for (const [heading, expected] of headings) {
+ assert.equal(slugHeading(heading), expected);
+ }
+});
+
+test('duplicate heading slugs are unique', () => {
+ const headings = [
+ { type: 'element', tagName: 'h2', properties: {}, children: [{ type: 'text', value: 'Demo' }] },
+ { type: 'element', tagName: 'h2', properties: {}, children: [{ type: 'text', value: 'Demo' }] },
+ ];
+ rehypeStableHeadingIds()({ type: 'root', children: headings });
+ assert.deepEqual(headings.map((heading) => heading.properties.id), ['demo', 'demo-1']);
+});
+
+function heading(tagName, value) {
+ return {
+ type: 'element',
+ tagName,
+ properties: {},
+ children: [{ type: 'text', value }],
+ };
+}
+
+test('nested command references receive hidden Pagefind context', () => {
+ const command = heading('h2', 'wt step commit');
+ const reference = heading('h3', 'Command reference');
+ const tree = { type: 'root', children: [command, reference] };
+
+ rehypePagefindCommandReferences()(tree);
+ rehypePagefindCommandReferences()(tree);
+
+ assert.deepEqual(reference.children, [
+ {
+ type: 'raw',
+ value: '<span class="wt-pagefind-fragment-title" hidden aria-hidden="true">wt step commit — </span>',
+ },
+ { type: 'text', value: 'Command reference' },
+ ]);
+});
+
+test('Pagefind context rejects non-command and non-nested references', () => {
+ const topLevelReference = heading('h2', 'Command reference');
+ const orphanReference = heading('h3', 'Command reference');
+ const command = heading('h2', 'wt step commit');
+ const otherSubheading = heading('h3', 'Examples');
+ const unrelated = heading('h2', 'Configuration');
+ const unrelatedReference = heading('h3', 'Command reference');
+ const tree = {
+ type: 'root',
+ children: [
+ topLevelReference,
+ orphanReference,
+ command,
+ otherSubheading,
+ unrelated,
+ unrelatedReference,
+ ],
+ };
+
+ rehypePagefindCommandReferences()(tree);
+
+ for (const candidate of [
+ topLevelReference,
+ orphanReference,
+ otherSubheading,
+ unrelatedReference,
+ ]) {
+ assert.deepEqual(candidate.children, [{ type: 'text', value: candidate.children[0].value }]);
+ }
+});
+
+test('short wide tables become accessible responsive records', () => {
+ const table = markdownTable(
+ ['File', 'Location', 'Contains'],
+ [
+ ['User config', '~/.config/worktrunk/config.toml', 'Personal settings'],
+ ['Project config', '.config/wt.toml', 'Shared hooks'],
+ ],
+ );
+
+ rehypeResponsiveTables()({ type: 'root', children: [table] });
+
+ assert.deepEqual(table.properties, {
+ className: ['wt-responsive-records'],
+ dataRecordColumns: '3',
+ });
+ const cells = table.children[1].children.flatMap((row) => row.children);
+ assert.deepEqual(
+ cells.map((cell) => cell.children[0]),
+ ['File', 'Location', 'Contains', 'File', 'Location', 'Contains'].map((value) => ({
+ type: 'element',
+ tagName: 'span',
+ properties: {
+ ariaHidden: 'true',
+ className: ['wt-responsive-record-label'],
+ },
+ children: [{ type: 'text', value }],
+ })),
+ );
+ assert.deepEqual(
+ cells.map((cell) => cell.children[1].value),
+ ['User config', '~/.config/worktrunk/config.toml', 'Personal settings', 'Project config', '.config/wt.toml', 'Shared hooks'],
+ );
+});
+
+test('responsive records reject tables that cannot stack unambiguously', () => {
+ const twoColumns = markdownTable(['Name', 'Meaning'], [['one', 'first']]);
+ const dense = markdownTable(
+ ['Name', 'Value', 'Meaning'],
+ Array.from({ length: 4 }, (_, index) => [`name ${index}`, `${index}`, `meaning ${index}`]),
+ );
+ const comparison = markdownTable(
+ ['Task', 'Worktrunk', 'Plain git'],
+ [['Switch', 'wt switch', 'git worktree add']],
+ { className: ['cmd-compare'] },
+ );
+ const complexHeader = markdownTable(
+ ['Grouped', 'Value', 'Meaning'],
+ [['one', '1', 'first']],
+ { headerProperties: [{ colSpan: 2 }] },
+ );
+ const emptyHeader = markdownTable(['Name', '', 'Meaning'], [['one', '1', 'first']]);
+ const duplicateHeader = markdownTable(['Name', 'Value', 'Value'], [['one', '1', 'first']]);
+ const mismatchedRow = markdownTable(['Name', 'Value', 'Meaning'], [['one', '1']]);
+ const multipleHeaderRows = markdownTable(['Name', 'Value', 'Meaning'], [['one', '1', 'first']]);
+ multipleHeaderRows.children[0].children.push(structuredClone(multipleHeaderRows.children[0].children[0]));
+ const tables = [
+ twoColumns,
+ dense,
+ comparison,
+ complexHeader,
+ emptyHeader,
+ duplicateHeader,
+ mismatchedRow,
+ multipleHeaderRows,
+ ];
+
+ rehypeResponsiveTables()({ type: 'root', children: tables });
+
+ for (const table of tables) {
+ assert.ok(!table.properties.className?.includes('wt-responsive-records'));
+ assert.equal(
+ table.children[1].children.flatMap((row) => row.children)
+ .filter((cell) => cell.children[0]?.properties?.className?.includes('wt-responsive-record-label'))
+ .length,
+ 0,
+ );
+ }
+});
+
+test('console blocks separate copyable recipes from output', () => {
+ const lines = ['# Recent', '$ wt list', '', '# Failed', '$ wt list --full'].map((text) => ({
+ text,
+ editText(start, end, replacement) {
+ this.text = this.text.slice(0, start) + replacement + this.text.slice(end);
+ },
+ }));
+ const codeBlock = { language: 'console', getLines: () => lines };
+ const plugin = pluginWorktrunkTerminal();
+ plugin.hooks.preprocessCode({ codeBlock });
+
+ const classes = lines.map((_, lineIndex) => {
+ const renderData = { lineAst: { properties: {} } };
+ plugin.hooks.postprocessRenderedLine({ codeBlock, lineIndex, renderData });
+ return renderData.lineAst.properties.className;
+ });
+
+ assert.deepEqual(
+ lines.map((line) => line.text),
+ ['# Recent', 'wt list', '', '# Failed', 'wt list --full'],
+ );
+ assert.deepEqual(classes, [
+ ['wt-copyable'],
+ ['wt-command'],
+ ['wt-copyable'],
+ ['wt-copyable'],
+ ['wt-command'],
+ ]);
+
+ const copyButton = { type: 'element', tagName: 'button', properties: { 'data-code': 'stale' } };
+ const renderData = {
+ blockAst: {
+ children: [{
+ type: 'element',
+ properties: { className: ['copy'] },
+ children: [copyButton],
+ }],
+ },
+ };
+ plugin.hooks.postprocessRenderedBlock({ codeBlock, renderData });
+ assert.equal(
+ copyButton.properties['data-code'],
+ '# Recent\u007fwt list\u007f\u007f# Failed\u007fwt list --full',
+ );
+});
+
+test('console output and its blank lines stay out of copied commands', () => {
+ const lines = ['$ wt list', 'output', '', '# shell comment'].map((text) => ({
+ text,
+ editText(start, end, replacement) {
+ this.text = this.text.slice(0, start) + replacement + this.text.slice(end);
+ },
+ }));
+ const codeBlock = { language: 'console', getLines: () => lines };
+ const plugin = pluginWorktrunkTerminal();
+ plugin.hooks.preprocessCode({ codeBlock });
+
+ const classes = lines.map((_, lineIndex) => {
+ const renderData = { lineAst: { properties: {} } };
+ plugin.hooks.postprocessRenderedLine({ codeBlock, lineIndex, renderData });
+ return renderData.lineAst.properties.className;
+ });
+ assert.deepEqual(classes, [
+ ['wt-command'],
+ ['wt-output'],
+ ['wt-output'],
+ ['wt-copyable'],
+ ]);
+
+ const copyButton = { type: 'element', tagName: 'button', properties: { 'data-code': 'stale' } };
+ const renderData = {
+ blockAst: {
+ children: [{
+ type: 'element',
+ properties: { className: ['copy'] },
+ children: [copyButton],
+ }],
+ },
+ };
+ plugin.hooks.postprocessRenderedBlock({ codeBlock, renderData });
+ assert.equal(copyButton.properties['data-code'], 'wt list\u007f# shell comment');
+});
+
+test('console output retains state-color semantics without ANSI in Markdown', () => {
+ assert.deepEqual(
+ semanticOutputSegments('@ feat +54 -5 ↑4 ↓1 ⇡3 ? ✓ done'),
+ [
+ { text: '@ feat ' },
+ { text: '+54', tone: 'positive' },
+ { text: ' ' },
+ { text: '-5', tone: 'negative' },
+ { text: ' ' },
+ { text: '↑4', tone: 'positive' },
+ { text: ' ' },
+ { text: '↓1', tone: 'negative' },
+ { text: ' ' },
+ { text: '⇡3', tone: 'positive' },
+ { text: ' ' },
+ { text: '?', tone: 'warning' },
+ { text: ' ' },
+ { text: '✓', tone: 'positive' },
+ { text: ' done' },
+ ],
+ );
+
+ assert.deepEqual(
+ semanticOutputSegments('[unoptimized + debuginfo] Allow and remember?'),
+ [{ text: '[unoptimized + debuginfo] Allow and remember?' }],
+ );
+ assert.deepEqual(
+ semanticOutputSegments('@ feat + ↑'),
+ [
+ { text: '@ feat ' },
+ { text: '+', tone: 'positive' },
+ { text: ' ' },
+ { text: '↑', tone: 'positive' },
+ ],
+ );
+});
diff --git a/docs/themes/base16-ocean-dark.json b/docs/themes/base16-ocean-dark.json
deleted file mode 100644
index eb9e4465c..000000000
--- a/docs/themes/base16-ocean-dark.json
+++ /dev/null
@@ -1,299 +0,0 @@
-{
- "name": "base16-ocean-dark",
- "displayName": "Base16 Ocean Dark",
- "type": "dark",
- "colors": {
- "foreground": "#c0c5ce",
- "background": "#2b303b"
- },
- "tokenColors": [
- {
- "settings": {
- "foreground": "#c0c5ce",
- "background": "#2b303b"
- }
- },
- {
- "name": "Text",
- "scope": "variable.parameter.function",
- "settings": {
- "foreground": "#c0c5ce"
- }
- },
- {
- "name": "Comments",
- "scope": "comment, punctuation.definition.comment",
- "settings": {
- "foreground": "#65737e"
- }
- },
- {
- "name": "Punctuation",
- "scope": "punctuation.definition.string, punctuation.definition.variable, punctuation.definition.parameters, punctuation.definition.array",
- "settings": {
- "foreground": "#c0c5ce"
- }
- },
- {
- "name": "Operators",
- "scope": "keyword.operator",
- "settings": {
- "foreground": "#c0c5ce"
- }
- },
- {
- "name": "Keywords",
- "scope": "keyword",
- "settings": {
- "foreground": "#b48ead"
- }
- },
- {
- "name": "Variables",
- "scope": "variable",
- "settings": {
- "foreground": "#bf616a"
- }
- },
- {
- "name": "Functions",
- "scope": "entity.name.function, meta.require, support.function.any-method",
- "settings": {
- "foreground": "#8fa1b3"
- }
- },
- {
- "name": "Classes",
- "scope": "support.class, entity.name.class, entity.name.type.class",
- "settings": {
- "foreground": "#ebcb8b"
- }
- },
- {
- "name": "Classes",
- "scope": "meta.class",
- "settings": {
- "foreground": "#eff1f5"
- }
- },
- {
- "name": "Methods",
- "scope": "keyword.other.special-method",
- "settings": {
- "foreground": "#8fa1b3"
- }
- },
- {
- "name": "Storage",
- "scope": "storage",
- "settings": {
- "foreground": "#b48ead"
- }
- },
- {
- "name": "Support",
- "scope": "support.function",
- "settings": {
- "foreground": "#96b5b4"
- }
- },
- {
- "name": "Strings, Inherited Class",
- "scope": "string, constant.other.symbol, entity.other.inherited-class",
- "settings": {
- "foreground": "#a3be8c"
- }
- },
- {
- "name": "Integers",
- "scope": "constant.numeric",
- "settings": {
- "foreground": "#d08770"
- }
- },
- {
- "name": "Constants",
- "scope": "constant",
- "settings": {
- "foreground": "#d08770"
- }
- },
- {
- "name": "Tags",
- "scope": "entity.name.tag",
- "settings": {
- "foreground": "#bf616a"
- }
- },
- {
- "name": "Attributes",
- "scope": "entity.other.attribute-name",
- "settings": {
- "foreground": "#d08770"
- }
- },
- {
- "name": "Attribute IDs",
- "scope": "entity.other.attribute-name.id, punctuation.definition.entity",
- "settings": {
- "foreground": "#8fa1b3"
- }
- },
- {
- "name": "Selector",
- "scope": "meta.selector",
- "settings": {
- "foreground": "#b48ead"
- }
- },
- {
- "name": "Headings",
- "scope": "markup.heading punctuation.definition.heading, entity.name.section",
- "settings": {
- "foreground": "#8fa1b3"
- }
- },
- {
- "name": "Units",
- "scope": "keyword.other.unit",
- "settings": {
- "foreground": "#d08770"
- }
- },
- {
- "name": "Bold",
- "scope": "markup.bold, punctuation.definition.bold",
- "settings": {
- "fontStyle": "bold",
- "foreground": "#ebcb8b"
- }
- },
- {
- "name": "Italic",
- "scope": "markup.italic, punctuation.definition.italic",
- "settings": {
- "fontStyle": "italic",
- "foreground": "#b48ead"
- }
- },
- {
- "name": "Code",
- "scope": "markup.raw.inline",
- "settings": {
- "foreground": "#a3be8c"
- }
- },
- {
- "name": "Link Text",
- "scope": "string.other.link, punctuation.definition.string.end.markdown",
- "settings": {
- "foreground": "#bf616a"
- }
- },
- {
- "name": "Link Url",
- "scope": "meta.link",
- "settings": {
- "foreground": "#d08770"
- }
- },
- {
- "name": "Lists",
- "scope": "markup.list",
- "settings": {
- "foreground": "#bf616a"
- }
- },
- {
- "name": "Quotes",
- "scope": "markup.quote",
- "settings": {
- "foreground": "#d08770"
- }
- },
- {
- "name": "Separator",
- "scope": "meta.separator",
- "settings": {
- "foreground": "#c0c5ce"
- }
- },
- {
- "name": "Inserted",
- "scope": "markup.inserted",
- "settings": {
- "foreground": "#a3be8c"
- }
- },
- {
- "name": "Deleted",
- "scope": "markup.deleted",
- "settings": {
- "foreground": "#bf616a"
- }
- },
- {
- "name": "Changed",
- "scope": "markup.changed",
- "settings": {
- "foreground": "#b48ead"
- }
- },
- {
- "name": "Colors",
- "scope": "constant.other.color",
- "settings": {
- "foreground": "#96b5b4"
- }
- },
- {
- "name": "Regular Expressions",
- "scope": "string.regexp",
- "settings": {
- "foreground": "#96b5b4"
- }
- },
- {
- "name": "Escape Characters",
- "scope": "constant.character.escape",
- "settings": {
- "foreground": "#96b5b4"
- }
- },
- {
- "name": "Embedded",
- "scope": "punctuation.section.embedded, variable.interpolation",
- "settings": {
- "foreground": "#ab7967"
- }
- },
- {
- "name": "Illegal",
- "scope": "invalid.illegal",
- "settings": {
- "foreground": "#eff1f5"
- }
- },
- {
- "name": "Broken",
- "scope": "invalid.broken",
- "settings": {
- "foreground": "#2b303b"
- }
- },
- {
- "name": "Deprecated",
- "scope": "invalid.deprecated",
- "settings": {
- "foreground": "#eff1f5"
- }
- },
- {
- "name": "Unimplemented",
- "scope": "invalid.unimplemented",
- "settings": {
- "foreground": "#eff1f5"
- }
- }
- ]
-}
diff --git a/docs/themes/worktrunk-light.json b/docs/themes/worktrunk-light.json
deleted file mode 100644
index 765103527..000000000
--- a/docs/themes/worktrunk-light.json
+++ /dev/null
@@ -1,274 +0,0 @@
-{
- "name": "worktrunk-light",
- "displayName": "Worktrunk Light",
- "type": "light",
- "colors": {
- "foreground": "#3d3632",
- "background": "#ffffff"
- },
- "tokenColors": [
- {
- "settings": {
- "foreground": "#3d3632",
- "background": "#ffffff"
- }
- },
- {
- "name": "Text",
- "scope": "variable.parameter.function",
- "settings": {
- "foreground": "#3d3632"
- }
- },
- {
- "name": "Comments",
- "scope": "comment, punctuation.definition.comment",
- "settings": {
- "foreground": "#7a756e",
- "fontStyle": "italic"
- }
- },
- {
- "name": "String Punctuation",
- "scope": "punctuation.definition.string",
- "settings": {
- "foreground": "#588a10"
- }
- },
- {
- "name": "Other Punctuation",
- "scope": "punctuation.definition.variable, punctuation.definition.parameters, punctuation.definition.array",
- "settings": {
- "foreground": "#3d3632"
- }
- },
- {
- "name": "Operators",
- "scope": "keyword.operator",
- "settings": {
- "foreground": "#3d3632"
- }
- },
- {
- "name": "Keywords",
- "scope": "keyword",
- "settings": {
- "foreground": "#a03c15"
- }
- },
- {
- "name": "Variables",
- "scope": "variable",
- "settings": {
- "foreground": "#7a5230"
- }
- },
- {
- "name": "Functions",
- "scope": "entity.name.function, meta.require, support.function.any-method",
- "settings": {
- "foreground": "#b07800",
- "fontStyle": "bold"
- }
- },
- {
- "name": "Classes",
- "scope": "support.class, entity.name.class, entity.name.type.class",
- "settings": {
- "foreground": "#7a5230"
- }
- },
- {
- "name": "Methods",
- "scope": "keyword.other.special-method",
- "settings": {
- "foreground": "#b07800"
- }
- },
- {
- "name": "Storage",
- "scope": "storage",
- "settings": {
- "foreground": "#a03c15",
- "fontStyle": "bold"
- }
- },
- {
- "name": "Support",
- "scope": "support.function",
- "settings": {
- "foreground": "#b05a20"
- }
- },
- {
- "name": "Strings, Inherited Class",
- "scope": "string, constant.other.symbol, entity.other.inherited-class",
- "settings": {
- "foreground": "#947a00"
- }
- },
- {
- "name": "Integers",
- "scope": "constant.numeric",
- "settings": {
- "foreground": "#b05a20"
- }
- },
- {
- "name": "Constants",
- "scope": "constant",
- "settings": {
- "foreground": "#b05a20"
- }
- },
- {
- "name": "Tags",
- "scope": "entity.name.tag",
- "settings": {
- "foreground": "#b07800"
- }
- },
- {
- "name": "Attributes",
- "scope": "entity.other.attribute-name",
- "settings": {
- "foreground": "#7a5230"
- }
- },
- {
- "name": "Attribute IDs",
- "scope": "entity.other.attribute-name.id, punctuation.definition.entity",
- "settings": {
- "foreground": "#b07800"
- }
- },
- {
- "name": "Selector",
- "scope": "meta.selector",
- "settings": {
- "foreground": "#a03c15"
- }
- },
- {
- "name": "Headings",
- "scope": "markup.heading punctuation.definition.heading, entity.name.section",
- "settings": {
- "foreground": "#b07800"
- }
- },
- {
- "name": "Units",
- "scope": "keyword.other.unit",
- "settings": {
- "foreground": "#b05a20"
- }
- },
- {
- "name": "Bold",
- "scope": "markup.bold, punctuation.definition.bold",
- "settings": {
- "fontStyle": "bold",
- "foreground": "#3d3632"
- }
- },
- {
- "name": "Italic",
- "scope": "markup.italic, punctuation.definition.italic",
- "settings": {
- "fontStyle": "italic",
- "foreground": "#3d3632"
- }
- },
- {
- "name": "Code",
- "scope": "markup.raw.inline",
- "settings": {
- "foreground": "#b07800"
- }
- },
- {
- "name": "Link Text",
- "scope": "string.other.link, punctuation.definition.string.end.markdown",
- "settings": {
- "foreground": "#a03c15"
- }
- },
- {
- "name": "Link Url",
- "scope": "meta.link",
- "settings": {
- "foreground": "#b07800"
- }
- },
- {
- "name": "Lists",
- "scope": "markup.list",
- "settings": {
- "foreground": "#7a5230"
- }
- },
- {
- "name": "Quotes",
- "scope": "markup.quote",
- "settings": {
- "foreground": "#4d5a20"
- }
- },
- {
- "name": "Separator",
- "scope": "meta.separator",
- "settings": {
- "foreground": "#3d3632"
- }
- },
- {
- "name": "Inserted",
- "scope": "markup.inserted",
- "settings": {
- "foreground": "#4d5a20"
- }
- },
- {
- "name": "Deleted",
- "scope": "markup.deleted",
- "settings": {
- "foreground": "#a03c15"
- }
- },
- {
- "name": "Changed",
- "scope": "markup.changed",
- "settings": {
- "foreground": "#b07800"
- }
- },
- {
- "name": "Regular Expressions",
- "scope": "string.regexp",
- "settings": {
- "foreground": "#b05a20"
- }
- },
- {
- "name": "Escape Characters",
- "scope": "constant.character.escape",
- "settings": {
- "foreground": "#b05a20"
- }
- },
- {
- "name": "Embedded",
- "scope": "punctuation.section.embedded, variable.interpolation",
- "settings": {
- "foreground": "#7a5230"
- }
- },
- {
- "name": "Invalid",
- "scope": "invalid.illegal, invalid.broken, invalid.deprecated, invalid.unimplemented",
- "settings": {
- "foreground": "#a03c15"
- }
- }
- ]
-}
diff --git a/plugins/worktrunk/skills/worktrunk/reference/README.md b/plugins/worktrunk/skills/worktrunk/reference/README.md
index d113ddba7..b86cf5637 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/README.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/README.md
@@ -1,6 +1,6 @@
<!-- markdownlint-disable MD033 -->
-<h1><img src="docs/static/logo.png" alt="Worktrunk logo" width="50" align="absmiddle">&nbsp;&nbsp;Worktrunk</h1>
+<h1><img src="docs/public/logo.png" alt="Worktrunk logo" width="50" align="absmiddle">&nbsp;&nbsp;Worktrunk</h1>
<!-- Crates.io badge below disabled while shields.io is rate-limited by crates.io
(renders "CRATES.IO: INVALID"). Tracking: badges/shields#11879. Restore once fixed.
@@ -25,7 +25,7 @@ A quick demo:
> ### 📚 Full documentation at [worktrunk.dev](https://worktrunk.dev) 📚
-<!-- ⚠️ AUTO-GENERATED from docs/content/worktrunk.md#context-git-worktrees..worktrunk-makes-git-worktrees-as-easy-as-branches — edit source to update -->
+<!-- ⚠️ AUTO-GENERATED from docs/src/content/docs/worktrunk.md#context-git-worktrees..worktrunk-makes-git-worktrees-as-easy-as-branches — edit source to update -->
## Context: git worktrees
@@ -42,7 +42,7 @@ worktree requires typing the branch name three times: `git worktree add -b feat
Worktrees are addressed by branch name; paths are computed from a configurable template. Commands that take a branch also accept the path of the worktree it is checked out in.
-> Start with the core commands
+<p class="workflow-stage">Start with the core commands</p>
**Core commands:**
@@ -57,34 +57,34 @@ Worktrees are addressed by branch name; paths are computed from a configurable t
<tbody>
<tr>
<td>Switch worktrees</td>
- <td><pre>wt switch feat</pre></td>
- <td><pre>cd ../repo.feat</pre></td>
+ <td data-label="Worktrunk"><code>wt switch feat</code></td>
+ <td data-label="Plain git"><code>cd ../repo.feat</code></td>
</tr>
<tr>
<td>Create + start Claude</td>
- <td><pre>wt switch -c -x claude feat</pre></td>
- <td><pre>git worktree add -b feat ../repo.feat && \
+ <td data-label="Worktrunk"><code>wt switch -c -x claude feat</code></td>
+ <td data-label="Plain git"><pre><code>git worktree add -b feat ../repo.feat && \
cd ../repo.feat && \
-claude</pre></td>
+claude</code></pre></td>
</tr>
<tr>
<td>Clean up</td>
- <td><pre>wt remove</pre></td>
- <td><pre>cd ../repo && \
+ <td data-label="Worktrunk"><code>wt remove</code></td>
+ <td data-label="Plain git"><pre><code>cd ../repo && \
git worktree remove ../repo.feat && \
-git branch -d feat</pre></td>
+git branch -d feat</code></pre></td>
</tr>
<tr>
<td>List with status</td>
- <td><pre>wt list</pre></td>
- <td><pre>git worktree list</pre> (paths only)</td>
+ <td data-label="Worktrunk"><code>wt list</code></td>
+ <td data-label="Plain git"><span class="cmd-compare-value"><code>git worktree list</code> (paths only)</span></td>
</tr>
</tbody>
</table>
-> Expand into the more advanced commands as needed
+<p class="workflow-stage">Expand into the more advanced commands as needed</p>
-**Workflow automation:**
+<p class="workflow-heading"><strong>Workflow automation:</strong></p>
- **[Hooks](https://worktrunk.dev/hook/)** — run commands on create, pre-merge, post-merge, etc
- **[LLM commit messages](https://worktrunk.dev/llm-commits/)** — generate commit messages from diffs
@@ -103,7 +103,7 @@ Multiple parallel agents, same simple commands:
<!-- END AUTO-GENERATED -->
-<!-- ⚠️ AUTO-GENERATED from docs/content/worktrunk.md#install..further-reading — edit source to update -->
+<!-- ⚠️ AUTO-GENERATED from docs/src/content/docs/worktrunk.md#install..further-reading — edit source to update -->
## Install
@@ -158,7 +158,6 @@ Create a worktree for a new feature:
```console
$ wt switch --create feature-auth
✓ Created branch feature-auth from main and worktree @ ~/repo.feature-auth
-
```
This creates a new branch and worktree, then switches to it. Do your work, then check all worktrees with [`wt list`](https://worktrunk.dev/list/):
@@ -170,7 +169,6 @@ $ wt list
^ main ^⇡ ⇡1 0e631ad 1d Initial commit
○ Showing 2 worktrees, 1 with changes, 1 ahead, 1 column hidden
-
```
The `@` marks the current worktree. `+` means staged changes, `↑1` means 1 commit ahead of main, `⇡` means unpushed commits.
@@ -200,7 +198,6 @@ $ wt merge main
✓ Merged to main (1 commit, 2 files, +53)
◎ Removing feature-auth worktree & branch in background (same commit as main, _)
○ Switched to worktree for main @ ~/repo
-
```
For parallel agents, create multiple worktrees and launch an agent in each:
diff --git a/plugins/worktrunk/skills/worktrunk/reference/claude-code.md b/plugins/worktrunk/skills/worktrunk/reference/claude-code.md
index 3a68f0ba6..c9936e368 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/claude-code.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/claude-code.md
@@ -71,15 +71,15 @@ Claude Code is designed to load the skill automatically when it detects worktrun
The Claude Code, Codex, OpenCode, and Gemini plugins track agent sessions with status markers in `wt list`:
-```bash
+```console
$ wt list
- <b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Remote⇅</b> <b>Path</b> <b>Commit</b> <b>Age</b> <b>Message</b>
-@ main <span class=d>^</span><span class=d>⇡</span> <span class=g>⇡1</span> . <span class=d>33323bc</span> <span class=d>1d</span> <span class=d>Initial commit</span>
-+ feature-api <span class=d>↑</span> 🤖 <span class=g>↑1</span> <span class=g>+1</span> ../repo.feature-api <span class=d>70343f0</span> <span class=d>1d</span> <span class=d>Add REST API endpoints</span>
-+ review-ui <span class=c>?</span> <span class=d>↑</span> 💬 <span class=g>↑1</span> <span class=g>+1</span> ../repo.review-ui <span class=d>a585d6e</span> <span class=d>1d</span> <span class=d>Add dashboard component</span>
-+ wip-docs <span class=c>?</span> <span class=d>–</span> ../repo.wip-docs <span class=d>33323bc</span> <span class=d>1d</span> <span class=d>Initial commit</span>
+ Branch Status HEAD± main↕ main…± Remote⇅ Path Commit Age Message
+@ main ^⇡ ⇡1 . 33323bc 1d Initial commit
++ feature-api ↑ 🤖 ↑1 +1 ../repo.feature-api 70343f0 1d Add REST API endpoints
++ review-ui ? ↑ 💬 ↑1 +1 ../repo.review-ui a585d6e 1d Add dashboard component
++ wip-docs ? – ../repo.wip-docs 33323bc 1d Initial commit
-<span class=d>○</span> <span class=d>Showing 4 worktrees, 2 with changes, 2 ahead</span>
+○ Showing 4 worktrees, 2 with changes, 2 ahead
```
- 🤖 — agent is working
@@ -91,7 +91,7 @@ All four plugins clear the marker when a session ends. A stale marker can remain
Set status markers manually for any workflow:
-```bash
+```console
$ wt config state marker set "🚧" # Current branch
$ wt config state marker set "✅" --branch feature # Specific branch
$ git config worktrunk.state.feature.marker '{"marker":"💬","set_at":0}' # Direct
diff --git a/plugins/worktrunk/skills/worktrunk/reference/config.md b/plugins/worktrunk/skills/worktrunk/reference/config.md
index 2ddb87553..65fe54baa 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/config.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/config.md
@@ -6,25 +6,25 @@ Manage user & project configs. Includes shell integration, hooks, and saved stat
Install shell integration (required for directory switching):
-```bash
+```console
$ wt config shell install
```
Create user config file with documented examples:
-```bash
+```console
$ wt config create
```
Create project config file (`.config/wt.toml`) for hooks:
-```bash
+```console
$ wt config create --project
```
Show current configuration and file locations:
-```bash
+```console
$ wt config show
```
@@ -611,7 +611,7 @@ Aliases defined here are shared with teammates. For personal aliases, use the [u
Worktrunk needs shell integration to change directories when switching worktrees. Install with:
-```bash
+```console
$ wt config shell install
```
@@ -645,7 +645,7 @@ For nested config sections, use double underscores to separate levels:
Override the LLM command in CI to use a mock:
-```bash
+```console
$ WORKTRUNK_COMMIT__GENERATION__COMMAND="echo 'test: automated commit'" wt merge
```
@@ -673,7 +673,7 @@ $ WORKTRUNK_COMMIT__GENERATION__COMMAND="echo 'test: automated commit'" wt merge
`--config-set <toml>` overrides any user config key for a single invocation. The value is a TOML fragment, so arrays and tables work directly; the flag is global (works before or after the subcommand), repeatable, and a later `--config-set` replaces an earlier one for the same key.
-```bash
+```console
$ wt --config-set list.full=true list
$ wt step copy-ignored --config-set 'step.copy-ignored.exclude=["target", "dist"]'
```
@@ -691,7 +691,7 @@ Sources closer to the invocation rank higher (user config above system config),
A `--config-set` that names a project entry is both the highest layer and the most specific key, so it beats the same flag's global key:
-```bash
+```console
$ wt --config-set 'projects."github.com/owner/repo".worktree-path = "/tmp/scratch"' switch --create feature
```
@@ -754,7 +754,7 @@ If a config file doesn't exist, shows defaults that would be used.
Use `--full` to run diagnostic checks:
-```bash
+```console
$ wt config show --full
```
@@ -812,37 +812,37 @@ Project hooks and project aliases prompt for approval on first run to prevent un
### Examples
List commands and their approval status for current project:
-```bash
+```console
$ wt config approvals list
```
Pre-approve all hook and alias commands for current project:
-```bash
+```console
$ wt config approvals add
```
Pre-approve without prompting, for a container or CI job:
-```bash
+```console
$ wt config approvals add --yes
```
Clear approvals for current project:
-```bash
+```console
$ wt config approvals clear
```
Clear only approvals for commands no longer in the project config:
-```bash
+```console
$ wt config approvals clear --stale
```
Clear global approvals:
-```bash
+```console
$ wt config approvals clear --global
```
Check whether an unattended run would stop for approval:
-```bash
+```console
$ wt config approvals list --format=json | jq -r .state
```
@@ -915,17 +915,17 @@ Aliases are command templates configured in user (`~/.config/worktrunk/config.to
### Examples
Show every configured alias's template:
-```bash
+```console
$ wt config alias show
```
Show the template for `deploy`:
-```bash
+```console
$ wt config alias show deploy
```
Preview an invocation without running it:
-```bash
+```console
$ wt config alias dry-run deploy
$ wt config alias dry-run deploy -- --env=staging
```
@@ -981,37 +981,37 @@ State is stored in `.git/` (config entries and log files), separate from configu
### Examples
Get the default branch:
-```bash
+```console
$ wt config state default-branch
```
Set the default branch manually:
-```bash
+```console
$ wt config state default-branch set main
```
Set a marker for current branch:
-```bash
+```console
$ wt config state marker set 🚧
```
Store arbitrary data:
-```bash
+```console
$ wt config state vars set env=staging
```
Drop the regenerable caches:
-```bash
+```console
$ wt config state cache clear
```
Show all stored state:
-```bash
+```console
$ wt config state get
```
Clear all stored state:
-```bash
+```console
$ wt config state clear
```
@@ -1075,12 +1075,12 @@ Without a subcommand, runs `get`.
### Examples
Show cache contents:
-```bash
+```console
$ wt config state cache
```
Drop all caches:
-```bash
+```console
$ wt config state cache clear
```
@@ -1128,7 +1128,7 @@ Default branch detection and override.
Useful in scripts to avoid hardcoding `main` or `master`:
-```bash
+```console
$ git rebase $(wt config state default-branch)
```
@@ -1252,27 +1252,27 @@ All logs are stored in `.git/wt/logs/` (in the main worktree's git directory). A
### Examples
List all log files:
-```bash
+```console
$ wt config state logs
```
Query the command log:
-```bash
+```console
$ tail -5 .git/wt/logs/commands.jsonl | jq .
```
Path to one hook log (e.g. the `post-start` `server` hook for the current branch):
-```bash
+```console
$ wt config state logs --format=json | jq -r '.hook_output[] | select(.source == "user" and .hook_type == "post-start" and (.name | startswith("server"))) | .path'
```
Logs for a specific branch:
-```bash
+```console
$ wt config state logs --format=json | jq '.hook_output[] | select(.branch | startswith("feature"))'
```
Clear all logs:
-```bash
+```console
$ wt config state logs clear
```
@@ -1373,7 +1373,7 @@ Custom status text or emoji shown in the `wt list` Status column.
Markers appear at the end of the Status column, after git symbols:
-```
+```console
$ wt list
Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
@ main ^⇡ ⇡1 33323bc 1d Initial commit
@@ -1394,7 +1394,7 @@ $ wt list
Stored in git config as `worktrunk.state.<branch>.marker`. Set directly with:
-```bash
+```console
$ git config worktrunk.state.feature.marker '{"marker":"🚧","set_at":0}'
```
@@ -1450,23 +1450,23 @@ Store custom variables per branch. Values are stored as-is — plain strings or
### Examples
Set and get values:
-```bash
+```console
$ wt config state vars set env=staging
$ wt config state vars get env
```
Store JSON:
-```bash
+```console
$ wt config state vars set config='{"port": 3000, "debug": true}'
```
List all keys:
-```bash
+```console
$ wt config state vars list
```
Operate on a different branch:
-```bash
+```console
$ wt config state vars set env=production --branch=main
```
@@ -1481,7 +1481,7 @@ dev = "ENV={{ vars.env | default('development') }} npm start -- --port {{ vars.p
JSON object and array values support dot access:
-```bash
+```console
$ wt config state vars set config='{"port": 3000, "debug": true}'
```
```toml
diff --git a/plugins/worktrunk/skills/worktrunk/reference/faq.md b/plugins/worktrunk/skills/worktrunk/reference/faq.md
index b8b9dd357..f06ea859c 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/faq.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/faq.md
@@ -10,7 +10,7 @@ Branch switching uses one directory: uncommitted changes from one agent get mixe
Git's built-in worktree commands work but require manual lifecycle management:
-```bash
+```console
# Plain git worktree workflow
$ git worktree add -b feature-branch ../myapp-feature main
$ cd ../myapp-feature
@@ -23,7 +23,7 @@ $ git branch -d feature-branch
Worktrunk automates the full lifecycle:
-```bash
+```console
$ wt switch --create feature-branch # Creates worktree, runs setup hooks
# ...work...
$ wt merge # Merges into default branch, cleans up
@@ -59,7 +59,7 @@ Not natively — stacked-branch workflows are a large design space, so Worktrunk
Stash the changes, create the worktree, then pop:
-```bash
+```console
$ git stash push -u # -u also stashes untracked files
$ wt switch --create feature # new branch off the default branch
$ git stash pop # changes reappear in the new worktree
@@ -219,6 +219,7 @@ User hooks and user aliases don't require approval (you defined them). Commands
### Example approval prompt
+```console
▲ repo needs approval to execute 3 commands:
○ pre-start install:
@@ -229,6 +230,7 @@ User hooks and user aliases don't require approval (you defined them). Commands
echo 'PORT={{ branch | hash_port }}' > .env.local
❯ Allow and remember? [y/N]
+```
Use `--yes` to bypass prompts (useful for CI/automation).
@@ -238,7 +240,7 @@ All hook executions and LLM commands are recorded in `.git/wt/logs/commands.json
View the log with `wt config state logs get`, or query directly:
-```bash
+```console
# Recent commands
$ tail -5 .git/wt/logs/commands.jsonl | jq .
diff --git a/plugins/worktrunk/skills/worktrunk/reference/hook.md b/plugins/worktrunk/skills/worktrunk/reference/hook.md
index 82f2b5354..d34fdff35 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/hook.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/hook.md
@@ -279,7 +279,7 @@ copy = "wt step copy-ignored"
`wt hook <type>` runs hooks on demand — useful for testing during development, running in CI pipelines, or re-running after a failure.
-```bash
+```console
$ wt hook pre-merge # Run all pre-merge hooks
$ wt hook pre-merge test # Run hooks named "test" from both sources
$ wt hook pre-merge test build # Run hooks named "test" and "build"
@@ -293,7 +293,7 @@ $ wt hook pre-merge -- --extra args # Forward tokens into {{ args }}
The `user:` and `project:` prefixes filter by source. Use `user:` or `project:` alone to run all hooks from that source, or `user:name` / `project:name` to run a specific hook.
-```
+```console
$ wt hook pre-merge
◎ Running pre-merge project:test
cargo test
@@ -313,7 +313,7 @@ test result: ok. 18 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; fin
Finished dev [unoptimized + debuginfo] target(s) in 1.23s
```
-```bash
+```console
$ wt hook post-start
◎ Running post-start: project @ ~/acme
```
diff --git a/plugins/worktrunk/skills/worktrunk/reference/list.md b/plugins/worktrunk/skills/worktrunk/reference/list.md
index 643e89720..69a078bfa 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/list.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/list.md
@@ -14,7 +14,7 @@ The table renders progressively: branch names, paths, and commit hashes appear i
List all worktrees:
-```
+```console
$ wt list
Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 ⇡3 6814f02 30m Add API tests
@@ -27,7 +27,7 @@ $ wt list
Include CI status and LLM summaries:
-```
+```console
$ wt list --full
Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
@@ -40,7 +40,7 @@ $ wt list --full
Include branches that don't have worktrees:
-```
+```console
$ wt list --branches --full
Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
@@ -55,7 +55,7 @@ $ wt list --branches --full
Output as JSON for scripting:
-```bash
+```console
$ wt list --format=json
```
@@ -277,7 +277,7 @@ Schema 1 names map directly: `commit` → `head`, `working_tree` →
`url_active` → `dev_server`, `statusline`/`symbols`/`columns` → `display.*`,
and the per-item `repo` moves to the envelope's `repo.forge`.
-```bash
+```console
# Current worktree path (for scripts)
$ wt list --format=json | jq -r '.items[] | select(.worktree.current) | .worktree.path'
@@ -300,7 +300,7 @@ optional there rather than required-and-null.
The original bare-array format, and the default while unset:
-```bash
+```console
# Current worktree path (for scripts)
$ wt list --format=json | jq -r '.[] | select(.is_current) | .path'
diff --git a/plugins/worktrunk/skills/worktrunk/reference/llm-commits.md b/plugins/worktrunk/skills/worktrunk/reference/llm-commits.md
index 1a5d6dda0..fb3f31adc 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/llm-commits.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/llm-commits.md
@@ -45,52 +45,52 @@ These examples assume a feature worktree with changes to commit.
Squashes all changes (uncommitted + existing commits) into one commit with an LLM-generated message, then merges to the default branch:
-```bash
+```console
$ wt merge
-<span class=c>◎</span> <span class=c>Squashing 3 commits into a single commit <span style='color:var(--bright-black,#555)'>(5 files, <span class=g>+16</span></span></span><span style='color:var(--bright-black,#555)'>)</span>...
-<span class=c>◎</span> <span class=c>Generating squash commit message...</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>feat(auth): Implement JWT authentication system</b>
-<span style='background:var(--bright-white,#fff)'> </span>
-<span style='background:var(--bright-white,#fff)'> </span> Add comprehensive JWT token handling including validation, refresh
-<span style='background:var(--bright-white,#fff)'> </span> logic, and authentication tests.
-<span class=g>✓</span> <span class=g>Squashed @ a1b2c3d</span>
-<span class=c>◎</span> <span class=c>Merging 1 commit to <b>main</b> @ <span class=d>a1b2c3d</span> (no rebase needed)</span>
-<span style='background:var(--bright-white,#fff)'> </span> * <span style='color:var(--yellow,#a60)'>a1b2c3d</span> feat(auth): Implement JWT authentication system
-<span style='background:var(--bright-white,#fff)'> </span> auth.rs | 2 <span class=g>++</span>
-<span style='background:var(--bright-white,#fff)'> </span> auth_test.rs | 2 <span class=g>++</span>
-<span style='background:var(--bright-white,#fff)'> </span> integration_test.rs | 6 <span class=g>++++++</span>
-<span style='background:var(--bright-white,#fff)'> </span> jwt.rs | 3 <span class=g>+++</span>
-<span style='background:var(--bright-white,#fff)'> </span> jwt_test.rs | 3 <span class=g>+++</span>
-<span style='background:var(--bright-white,#fff)'> </span> 5 files changed, 16 insertions(+)
-<span class=g>✓</span> <span class=g>Merged to <b>main</b> <span style='color:var(--bright-black,#555)'>(1 commit, 5 files, <span class=g>+16</span></span></span><span style='color:var(--bright-black,#555)'>)</span>
-<span class=c>◎</span> <span class=c>Removing <b>feature</b> worktree &amp; branch in background (same commit as <b>main</b>,</span> <span class=d>_</span><span class=c>)</span>
-<span class=d>○</span> Switched to worktree for <b>main</b> @ <b>~/repo</b>
+◎ Squashing 3 commits into a single commit (5 files, +16)...
+◎ Generating squash commit message...
+ feat(auth): Implement JWT authentication system
+
+ Add comprehensive JWT token handling including validation, refresh
+ logic, and authentication tests.
+✓ Squashed @ a1b2c3d
+◎ Merging 1 commit to main @ a1b2c3d (no rebase needed)
+ * a1b2c3d feat(auth): Implement JWT authentication system
+ auth.rs | 2 ++
+ auth_test.rs | 2 ++
+ integration_test.rs | 6 ++++++
+ jwt.rs | 3 +++
+ jwt_test.rs | 3 +++
+ 5 files changed, 16 insertions(+)
+✓ Merged to main (1 commit, 5 files, +16)
+◎ Removing feature worktree & branch in background (same commit as main, _)
+○ Switched to worktree for main @ ~/repo
```
### wt step commit
Stages and commits with LLM-generated message:
-```bash
+```console
$ wt step commit
-<span class=c>◎</span> <span class=c>Generating commit message and committing changes... <span style='color:var(--bright-black,#555)'>(2 files, <span class=g>+26</span></span></span><span style='color:var(--bright-black,#555)'>)</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>feat(validation): add input validation utilities</b>
-<span class=g>✓</span> <span class=g>Committed changes @ <span class=d>a1b2c3d</span></span>
+◎ Generating commit message and committing changes... (2 files, +26)
+ feat(validation): add input validation utilities
+✓ Committed changes @ a1b2c3d
```
### wt step squash
Squashes branch commits into one with LLM-generated message:
-```bash
+```console
$ wt step squash
-<span class=c>◎</span> <span class=c>Squashing 3 commits into a single commit <span style='color:var(--bright-black,#555)'>(5 files, <span class=g>+16</span></span></span><span style='color:var(--bright-black,#555)'>)</span>...
-<span class=c>◎</span> <span class=c>Generating squash commit message...</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>feat(auth): Implement JWT authentication system</b>
-<span style='background:var(--bright-white,#fff)'> </span>
-<span style='background:var(--bright-white,#fff)'> </span> Add comprehensive JWT token handling including validation, refresh
-<span style='background:var(--bright-white,#fff)'> </span> logic, and authentication tests.
-<span class=g>✓</span> <span class=g>Squashed @ a1b2c3d</span>
+◎ Squashing 3 commits into a single commit (5 files, +16)...
+◎ Generating squash commit message...
+ feat(auth): Implement JWT authentication system
+
+ Add comprehensive JWT token handling including validation, refresh
+ logic, and authentication tests.
+✓ Squashed @ a1b2c3d
```
See [`wt merge`](https://worktrunk.dev/merge/) and [`wt step`](https://worktrunk.dev/step/) for full documentation.
diff --git a/plugins/worktrunk/skills/worktrunk/reference/merge.md b/plugins/worktrunk/skills/worktrunk/reference/merge.md
index 7781639f4..79e77492a 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/merge.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/merge.md
@@ -8,7 +8,7 @@ Unlike `git merge`, this merges the current branch into the target branch — no
Merge to the default branch:
-```
+```console
$ wt merge
◎ Running pre-merge project:test
cargo nextest run
@@ -25,37 +25,37 @@ $ wt merge
Merge to a different branch:
-```bash
+```console
$ wt merge develop
```
Keep the worktree after merging:
-```bash
+```console
$ wt merge --no-remove
```
Preserve commit history (no squash):
-```bash
+```console
$ wt merge --no-squash
```
Create a merge commit — rebased semi-linear history by default:
-```bash
+```console
$ wt merge --no-ff
```
Skip committing/squashing (rebase still runs unless --no-rebase):
-```bash
+```console
$ wt merge --no-commit
```
Preserve the exact clean commit graph and tip:
-```bash
+```console
$ wt merge --no-commit --no-rebase
```
diff --git a/plugins/worktrunk/skills/worktrunk/reference/remove.md b/plugins/worktrunk/skills/worktrunk/reference/remove.md
index 0eee006fd..f7f81360e 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/remove.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/remove.md
@@ -6,7 +6,7 @@ Remove worktree; delete branch if merged. Defaults to the current worktree.
Remove current worktree:
-```
+```console
$ wt remove
◎ Running pre-remove project:cleanup
flyctl scale count 0
@@ -17,20 +17,20 @@ Scaling app to 0 machines
Remove specific worktrees / branches:
-```bash
+```console
$ wt remove feature-branch
$ wt remove old-feature another-branch
```
Keep the branch:
-```bash
+```console
$ wt remove --no-delete-branch feature-branch
```
Force-delete an unmerged branch:
-```bash
+```console
$ wt remove -D experimental
```
@@ -64,7 +64,7 @@ Worktrunk has two force flags for different situations:
| `--force` (`-f`) | Worktree | Worktree has uncommitted changes |
| `--force-delete` (`-D`) | Branch | Branch has unmerged commits |
-```bash
+```console
$ wt remove feature --force # Remove dirty worktree
$ wt remove feature -D # Delete unmerged branch
$ wt remove feature --force -D # Both
@@ -82,7 +82,7 @@ After each `wt remove`, entries in `.git/wt/trash/` older than 24 hours are swep
`--reap` terminates processes left running in the worktree before it is removed — a `post-start` dev server, a file watcher, a language server — freeing the ports and file handles they hold. Processes are discovered by working directory: any process whose current directory is at or under the worktree path (`SIGTERM`, then `SIGKILL` for survivors).
-```bash
+```console
$ wt remove --reap feature
◎ Reaping 2 processes under feature worktree
┃ 51234 node
diff --git a/plugins/worktrunk/skills/worktrunk/reference/step.md b/plugins/worktrunk/skills/worktrunk/reference/step.md
index d2b35280c..e69bfe85f 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/step.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/step.md
@@ -6,7 +6,7 @@ Run individual operations. The building blocks of wt merge — commit, squash, r
Commit with LLM-generated message:
-```
+```console
$ wt step commit
◎ Generating commit message and committing changes... (2 files, +26)
feat(validation): add input validation utilities
@@ -15,7 +15,7 @@ $ wt step commit
Manual merge workflow with review between steps:
-```bash
+```console
$ wt step commit
$ wt step squash
$ wt step rebase
@@ -105,7 +105,7 @@ Controls what to stage before committing:
| `tracked` | Stage only modified tracked files |
| `none` | Don't stage anything, commit only what's already staged |
-```bash
+```console
$ wt step commit --stage=tracked
```
@@ -120,7 +120,7 @@ stage = "tracked"
Render the prompt, print the LLM command, generate the message, and exit without staging, running hooks, or committing:
-```bash
+```console
$ wt step commit --dry-run
```
@@ -200,7 +200,7 @@ Controls what to stage before squashing:
| `tracked` | Stage only modified tracked files |
| `none` | Don't stage anything, squash only committed changes |
-```bash
+```console
$ wt step squash --stage=none
```
@@ -215,7 +215,7 @@ stage = "tracked"
Render the prompt, print the LLM command, generate the squash message, and exit without resetting, running hooks, or committing:
-```bash
+```console
$ wt step squash --dry-run
```
@@ -292,7 +292,7 @@ The target is any commit: a branch, a tag, a SHA.
### Examples
-```bash
+```console
$ wt step rebase # Rebase onto default branch
$ wt step rebase develop # Rebase onto develop
$ wt step rebase v1.2.0 # Rebase onto a tag
@@ -371,7 +371,7 @@ The target is a branch, and must already be an ancestor of the current branch. O
### Examples
-```bash
+```console
$ wt step push # Fast-forward main to current branch
$ wt step push develop # Fast-forward develop instead
$ wt step push --no-ff # Merge commit instead of a fast-forward
@@ -441,7 +441,7 @@ This is what `wt merge` would include — a single diff against the merge base.
`--branch` diffs another worktree's branch without leaving the current one:
-```bash
+```console
$ wt step diff --branch feature
```
@@ -451,7 +451,7 @@ The branch must have a checked-out worktree.
Arguments after `--` are forwarded to `git diff`:
-```bash
+```console
$ wt step diff -- --stat
$ wt step diff -- --name-only
$ wt step diff -- -- '*.rs'
@@ -459,7 +459,7 @@ $ wt step diff -- -- '*.rs'
The diff is pipeable to tools like `delta`:
-```bash
+```console
$ wt step diff | delta
```
@@ -467,7 +467,7 @@ $ wt step diff | delta
Equivalent to:
-```bash
+```console
$ cp "$(git rev-parse --git-dir)/index" /tmp/idx
$ GIT_INDEX_FILE=/tmp/idx git add --intent-to-add .
$ GIT_INDEX_FILE=/tmp/idx git diff $(git merge-base HEAD $(wt config state default-branch))
@@ -555,7 +555,7 @@ exclude = [".cache/", ".turbo/"]
To copy nothing unless `.worktreeinclude` exists — matching Claude Code desktop, where the file is required — pass `--require-include`:
-```bash
+```console
$ wt step copy-ignored --require-include
```
@@ -688,34 +688,34 @@ All [hook template variables and filters](https://worktrunk.dev/hook/#template-v
Get the port for the current branch:
-```bash
+```console
$ wt step eval '{{ branch | hash_port }}'
16066
```
Use in shell substitution:
-```bash
+```console
$ curl http://localhost:$(wt step eval '{{ branch | hash_port }}')/health
```
Combine multiple values:
-```bash
+```console
$ wt step eval '{{ branch | hash_port }},{{ ("supabase-api-" ~ branch) | hash_port }}'
16066,16739
```
Use conditionals and filters:
-```bash
+```console
$ wt step eval '{{ branch | sanitize_db }}'
feature_auth_oauth2_a1b
```
List the available template variables with `-v` (alongside the expansion, on stderr):
-```bash
+```console
$ wt step eval -v '{{ branch }}'
○ eval template variables:
branch = feature/auth-oauth2
@@ -785,14 +785,14 @@ A summary of successes and failures is shown at the end. A template-expansion er
Arguments after `--` are the program and its arguments — run directly, no shell.
-```bash
+```console
$ wt step for-each -- git status --short
$ wt step for-each -- npm install
```
For pipes, redirects, variables, or globs, wrap in `sh -c`:
-```bash
+```console
$ wt step for-each -- sh -c 'git status | wc -l'
$ wt step for-each -- sh -c 'echo $HOME && git pull'
```
@@ -801,7 +801,7 @@ $ wt step for-each -- sh -c 'echo $HOME && git pull'
Variables substitute into each argv element before exec. See [`wt hook` template variables](https://worktrunk.dev/hook/#template-variables) for the complete list and filters.
-```bash
+```console
$ wt step for-each -- echo 'Branch: {{ branch }}'
```
@@ -811,7 +811,7 @@ Each element is expanded fresh in every worktree, so `{{ branch }}` is that work
Pull updates in worktrees with upstreams (skips others):
-```bash
+```console
$ git fetch --prune && wt step for-each -- sh -c '[ "$(git rev-parse @{u} 2>/dev/null)" ] || exit 0; git pull --autostash'
```
@@ -867,7 +867,7 @@ Swap a branch into the main worktree. Exchanges branches and gitignored files be
### Example
-```bash
+```console
# from ~/project (main worktree)
$ wt step promote feature
```
@@ -967,7 +967,7 @@ Locked worktrees and the main worktree are always skipped. The current worktree
Worktrees younger than `--min-age` (default: 1 day) are skipped. This prevents removing a worktree just created from the default branch — it looks "merged" because its branch points at the same commit.
-```bash
+```console
$ wt step prune --min-age=0s # no age guard
$ wt step prune --min-age=2d # skip worktrees younger than 2 days
```
@@ -980,13 +980,13 @@ $ wt step prune --min-age=2d # skip worktrees younger than 2 days
Preview what would be removed:
-```bash
+```console
$ wt step prune --dry-run
```
Remove all merged worktrees:
-```bash
+```console
$ wt step prune
```
@@ -1047,25 +1047,25 @@ Move worktrees to expected paths. Relocates worktrees whose path doesn't match t
Preview what would be moved:
-```bash
+```console
$ wt step relocate --dry-run
```
Move all mismatched worktrees:
-```bash
+```console
$ wt step relocate
```
Auto-commit and clobber blockers (never fails):
-```bash
+```console
$ wt step relocate --commit --clobber
```
Move specific worktrees:
-```bash
+```console
$ wt step relocate feature bugfix
```
@@ -1179,13 +1179,13 @@ worktree is gone.
Arguments after `--` are the program and its arguments, run directly, no shell.
-```bash
+```console
$ wt step tether -- npm run dev
```
For pipes, redirects, variables, or globs, wrap in `sh -c`:
-```bash
+```console
$ wt step tether -- sh -c 'PORT=$P npm run dev | tee dev.log'
```
@@ -1193,7 +1193,7 @@ To run the command from a subdirectory, pass the global `-C` flag (teardown
still watches the worktree root, so a server launched with a relative `-C` is
torn down with the worktree):
-```bash
+```console
$ wt step tether -C frontend -- npm run dev
```
diff --git a/plugins/worktrunk/skills/worktrunk/reference/switch.md b/plugins/worktrunk/skills/worktrunk/reference/switch.md
index 97e59a156..afaa82b39 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/switch.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/switch.md
@@ -6,7 +6,7 @@ Worktrees are addressed by branch name; paths are computed from a configurable t
## Examples
-```bash
+```console
$ wt switch feature-auth # Switch to worktree
$ wt switch - # Previous worktree (like cd -)
$ wt switch --create new-feature # Create new branch and worktree
@@ -29,7 +29,7 @@ If the branch already has a worktree, `wt switch` changes directories to it. Oth
4. Runs [pre-start hooks](https://worktrunk.dev/hook/#hook-types), blocking until complete
5. Spawns [post-start](https://worktrunk.dev/hook/#hook-types) and [post-switch hooks](https://worktrunk.dev/hook/#hook-types) in the background
-```bash
+```console
$ wt switch feature # Existing branch → creates worktree
$ wt switch --create feature # New branch and worktree
$ wt switch --create fix --base release # New branch from release
@@ -50,7 +50,7 @@ Worktrees are addressed by branch name, and every argument that takes one also a
| `pr:{N}` | GitHub PR #N's branch |
| `mr:{N}` | GitLab MR !N's branch |
-```bash
+```console
$ wt switch - # Back to previous
$ wt switch ^ # Default branch worktree
$ wt switch --create fix --base=@ # Branch from current HEAD
@@ -119,7 +119,7 @@ pager = "delta --paging=never --width=$COLUMNS"
The `pr:<number>` / `mr:<number>` shortcut and the PR/MR's web URL both resolve to its branch. For same-repo PRs/MRs, worktrunk switches to the branch directly. For fork PRs/MRs, it fetches the ref (`refs/pull/N/head` or `refs/merge-requests/N/head`) and configures `pushRemote` to the fork URL.
-```bash
+```console
$ wt switch pr:101 # GitHub PR #101
$ wt switch https://github.com/owner/repo/pull/101 # ...the same PR, by URL
$ wt switch mr:101 # GitLab MR !101
diff --git a/plugins/worktrunk/skills/worktrunk/reference/tips-patterns.md b/plugins/worktrunk/skills/worktrunk/reference/tips-patterns.md
index 0c95e1ef3..8ae3bd0c7 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/tips-patterns.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/tips-patterns.md
@@ -58,15 +58,15 @@ url = "http://localhost:{{ branch | hash_port }}"
The URL column in `wt list` shows each worktree's dev server:
-```bash
+```console
$ wt list
- <b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Remote⇅</b> <b>URL</b> <b>Commit</b>
-@ main <span class=c>?</span> <span class=d>^</span><span class=d>⇅</span> <span class=g>⇡1</span> <span class=d><span class=r>⇣1</span></span> <span class=d>http://localhost:12107</span> <span class=d>41ee083</span>
-+ feature-api <span class=c>+</span> <span class=d>↕</span><span class=d>⇡</span> <span class=g>+54</span> <span class=r>-5</span> <span class=g>↑4</span> <span class=d><span class=r>↓1</span></span> <span class=g>+234</span> <span class=r>-24</span> <span class=g>⇡3</span> <span class=d>http://localhost:10703</span> <span class=d>6814f02</span>
-+ fix-auth <span class=d>↕</span><span class=d>|</span> <span class=g>↑2</span> <span class=d><span class=r>↓1</span></span> <span class=g>+25</span> <span class=r>-11</span> <span class=d>|</span> <span class=d>http://localhost:16460</span> <span class=d>b772e68</span>
-+ <span class=d>fix-typos</span> <span class=d>_</span><span class=d>|</span> <span class=d>|</span> <span class=d>http://localhost:14301</span> <span class=d>41ee083</span>
+ Branch Status HEAD± main↕ main…± Remote⇅ URL Commit
+@ main ? ^⇅ ⇡1 ⇣1 http://localhost:12107 41ee083
++ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 ⇡3 http://localhost:10703 6814f02
++ fix-auth ↕| ↑2 ↓1 +25 -11 | http://localhost:16460 b772e68
++ fix-typos _| | http://localhost:14301 41ee083
-<span class=d>○</span> <span class=d>Showing 4 worktrees, 2 with changes, 2 ahead, 3 columns hidden</span>
+○ Showing 4 worktrees, 2 with changes, 2 ahead, 3 columns hidden
```
`fix-auth` always gets port 16460, on any machine. The URL dims if the server isn't running.
@@ -355,7 +355,7 @@ tmux = "tmux kill-session -t {{ branch | sanitize }} 2>/dev/null || true"
To create a worktree and immediately attach:
-```bash
+```console
$ wt switch --create feature -x tmux -- attach -t '{{ branch | sanitize }}'
```
diff --git a/plugins/worktrunk/skills/worktrunk/reference/worktrunk.md b/plugins/worktrunk/skills/worktrunk/reference/worktrunk.md
index 4b537f136..6fc3c8db0 100644
--- a/plugins/worktrunk/skills/worktrunk/reference/worktrunk.md
+++ b/plugins/worktrunk/skills/worktrunk/reference/worktrunk.md
@@ -1,7 +1,7 @@
# Worktrunk
-Worktrunk is a CLI for git worktree management, designed for running AI agents
-in parallel.
+Worktrunk is a CLI for Git worktree management, designed for **parallel AI agent
+workflows**.
Worktrunk's three core commands make worktrees as easy as branches.
Plus, Worktrunk has a bunch of quality-of-life features to simplify working
@@ -24,7 +24,7 @@ worktree requires typing the branch name three times: `git worktree add -b feat
Worktrees are addressed by branch name; paths are computed from a configurable template. Commands that take a branch also accept the path of the worktree it is checked out in.
-> Start with the core commands
+<p class="workflow-stage">Start with the core commands</p>
**Core commands:**
@@ -39,34 +39,34 @@ Worktrees are addressed by branch name; paths are computed from a configurable t
<tbody>
<tr>
<td>Switch worktrees</td>
- <td>wt switch feat</td>
- <td>cd ../repo.feat</td>
+ <td data-label="Worktrunk"><code>wt switch feat</code></td>
+ <td data-label="Plain git"><code>cd ../repo.feat</code></td>
</tr>
<tr>
<td>Create + start Claude</td>
- <td>wt switch -c -x claude feat</td>
- <td>git worktree add -b feat ../repo.feat && \
+ <td data-label="Worktrunk"><code>wt switch -c -x claude feat</code></td>
+ <td data-label="Plain git"><pre><code>git worktree add -b feat ../repo.feat && \
cd ../repo.feat && \
-claude</td>
+claude</code></pre></td>
</tr>
<tr>
<td>Clean up</td>
- <td>wt remove</td>
- <td>cd ../repo && \
+ <td data-label="Worktrunk"><code>wt remove</code></td>
+ <td data-label="Plain git"><pre><code>cd ../repo && \
git worktree remove ../repo.feat && \
-git branch -d feat</td>
+git branch -d feat</code></pre></td>
</tr>
<tr>
<td>List with status</td>
- <td>wt list</td>
- <td>git worktree list (paths only)</td>
+ <td data-label="Worktrunk"><code>wt list</code></td>
+ <td data-label="Plain git"><span class="cmd-compare-value"><code>git worktree list</code> (paths only)</span></td>
</tr>
</tbody>
</table>
-> Expand into the more advanced commands as needed
+<p class="workflow-stage">Expand into the more advanced commands as needed</p>
-**Workflow automation:**
+<p class="workflow-heading"><strong>Workflow automation:</strong></p>
- **[Hooks](https://worktrunk.dev/hook/)** — run commands on create, pre-merge, post-merge, etc
- **[LLM commit messages](https://worktrunk.dev/llm-commits/)** — generate commit messages from diffs
@@ -131,20 +131,20 @@ Or with [Pixi](https://pixi.sh): `pixi global install worktrunk && wt config she
Create a worktree for a new feature:
-```bash
+```console
$ wt switch --create feature-auth
-<span class=g>✓</span> <span class=g>Created branch <b>feature-auth</b> from <b>main</b> and worktree @ <b>~/repo.feature-auth</b></span>
+✓ Created branch feature-auth from main and worktree @ ~/repo.feature-auth
```
This creates a new branch and worktree, then switches to it. Do your work, then check all worktrees with [`wt list`](https://worktrunk.dev/list/):
-```bash
+```console
$ wt list
- <b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Remote⇅</b> <b>Commit</b> <b>Age</b> <b>Message</b>
-@ feature-auth <span class=c>+</span> <span class=d>↑</span> <span class=g>+27</span> <span class=r>-8</span> <span class=g>↑1</span> <span class=g>+31</span> <span class=d>4bc72dc</span> <span class=d>2h</span> <span class=d>Add authenticati…</span>
-^ main <span class=d>^</span><span class=d>⇡</span> <span class=g>⇡1</span> <span class=d>0e631ad</span> <span class=d>1d</span> <span class=d>Initial commit</span>
+ Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
+@ feature-auth + ↑ +27 -8 ↑1 +31 4bc72dc 2h Add authenticati…
+^ main ^⇡ ⇡1 0e631ad 1d Initial commit
-<span class=d>○</span> <span class=d>Showing 2 worktrees, 1 with changes, 1 ahead, 1 column hidden</span>
+○ Showing 2 worktrees, 1 with changes, 1 ahead, 1 column hidden
```
The `@` marks the current worktree. `+` means staged changes, `↑1` means 1 commit ahead of main, `⇡` means unpushed commits.
@@ -161,19 +161,19 @@ wt remove # after PR is merged
**Local merge** — squash, rebase onto main, fast-forward merge, clean up:
-```bash
+```console
$ wt merge main
-<span class=c>◎</span> <span class=c>Generating commit message and committing changes... <span style='color:var(--bright-black,#555)'>(2 files, <span class=g>+53</span></span></span>, no squashing needed<span style='color:var(--bright-black,#555)'>)</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>Add authentication module</b>
-<span class=g>✓</span> <span class=g>Committed changes @ <span class=d>a1b2c3d</span></span>
-<span class=c>◎</span> <span class=c>Merging 1 commit to <b>main</b> @ <span class=d>a1b2c3d</span> (no rebase needed)</span>
-<span style='background:var(--bright-white,#fff)'> </span> * <span style='color:var(--yellow,#a60)'>a1b2c3d</span> Add authentication module
-<span style='background:var(--bright-white,#fff)'> </span> auth.rs | 51 <span class=g>+++++++++++++++++++++++++++++++++++++++++++++++++++</span>
-<span style='background:var(--bright-white,#fff)'> </span> lib.rs | 2 <span class=g>++</span>
-<span style='background:var(--bright-white,#fff)'> </span> 2 files changed, 53 insertions(+)
-<span class=g>✓</span> <span class=g>Merged to <b>main</b> <span style='color:var(--bright-black,#555)'>(1 commit, 2 files, <span class=g>+53</span></span></span><span style='color:var(--bright-black,#555)'>)</span>
-<span class=c>◎</span> <span class=c>Removing <b>feature-auth</b> worktree &amp; branch in background (same commit as <b>main</b>,</span> <span class=d>_</span><span class=c>)</span>
-<span class=d>○</span> Switched to worktree for <b>main</b> @ <b>~/repo</b>
+◎ Generating commit message and committing changes... (2 files, +53, no squashing needed)
+ Add authentication module
+✓ Committed changes @ a1b2c3d
+◎ Merging 1 commit to main @ a1b2c3d (no rebase needed)
+ * a1b2c3d Add authentication module
+ auth.rs | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
+ lib.rs | 2 ++
+ 2 files changed, 53 insertions(+)
+✓ Merged to main (1 commit, 2 files, +53)
+◎ Removing feature-auth worktree & branch in background (same commit as main, _)
+○ Switched to worktree for main @ ~/repo
```
For parallel agents, create multiple worktrees and launch an agent in each:
diff --git a/skills/worktrunk/reference/claude-code.md b/skills/worktrunk/reference/claude-code.md
index 3a68f0ba6..c9936e368 100644
--- a/skills/worktrunk/reference/claude-code.md
+++ b/skills/worktrunk/reference/claude-code.md
@@ -71,15 +71,15 @@ Claude Code is designed to load the skill automatically when it detects worktrun
The Claude Code, Codex, OpenCode, and Gemini plugins track agent sessions with status markers in `wt list`:
-```bash
+```console
$ wt list
- <b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Remote⇅</b> <b>Path</b> <b>Commit</b> <b>Age</b> <b>Message</b>
-@ main <span class=d>^</span><span class=d>⇡</span> <span class=g>⇡1</span> . <span class=d>33323bc</span> <span class=d>1d</span> <span class=d>Initial commit</span>
-+ feature-api <span class=d>↑</span> 🤖 <span class=g>↑1</span> <span class=g>+1</span> ../repo.feature-api <span class=d>70343f0</span> <span class=d>1d</span> <span class=d>Add REST API endpoints</span>
-+ review-ui <span class=c>?</span> <span class=d>↑</span> 💬 <span class=g>↑1</span> <span class=g>+1</span> ../repo.review-ui <span class=d>a585d6e</span> <span class=d>1d</span> <span class=d>Add dashboard component</span>
-+ wip-docs <span class=c>?</span> <span class=d>–</span> ../repo.wip-docs <span class=d>33323bc</span> <span class=d>1d</span> <span class=d>Initial commit</span>
+ Branch Status HEAD± main↕ main…± Remote⇅ Path Commit Age Message
+@ main ^⇡ ⇡1 . 33323bc 1d Initial commit
++ feature-api ↑ 🤖 ↑1 +1 ../repo.feature-api 70343f0 1d Add REST API endpoints
++ review-ui ? ↑ 💬 ↑1 +1 ../repo.review-ui a585d6e 1d Add dashboard component
++ wip-docs ? – ../repo.wip-docs 33323bc 1d Initial commit
-<span class=d>○</span> <span class=d>Showing 4 worktrees, 2 with changes, 2 ahead</span>
+○ Showing 4 worktrees, 2 with changes, 2 ahead
```
- 🤖 — agent is working
@@ -91,7 +91,7 @@ All four plugins clear the marker when a session ends. A stale marker can remain
Set status markers manually for any workflow:
-```bash
+```console
$ wt config state marker set "🚧" # Current branch
$ wt config state marker set "✅" --branch feature # Specific branch
$ git config worktrunk.state.feature.marker '{"marker":"💬","set_at":0}' # Direct
diff --git a/skills/worktrunk/reference/config.md b/skills/worktrunk/reference/config.md
index 2ddb87553..65fe54baa 100644
--- a/skills/worktrunk/reference/config.md
+++ b/skills/worktrunk/reference/config.md
@@ -6,25 +6,25 @@ Manage user & project configs. Includes shell integration, hooks, and saved stat
Install shell integration (required for directory switching):
-```bash
+```console
$ wt config shell install
```
Create user config file with documented examples:
-```bash
+```console
$ wt config create
```
Create project config file (`.config/wt.toml`) for hooks:
-```bash
+```console
$ wt config create --project
```
Show current configuration and file locations:
-```bash
+```console
$ wt config show
```
@@ -611,7 +611,7 @@ Aliases defined here are shared with teammates. For personal aliases, use the [u
Worktrunk needs shell integration to change directories when switching worktrees. Install with:
-```bash
+```console
$ wt config shell install
```
@@ -645,7 +645,7 @@ For nested config sections, use double underscores to separate levels:
Override the LLM command in CI to use a mock:
-```bash
+```console
$ WORKTRUNK_COMMIT__GENERATION__COMMAND="echo 'test: automated commit'" wt merge
```
@@ -673,7 +673,7 @@ $ WORKTRUNK_COMMIT__GENERATION__COMMAND="echo 'test: automated commit'" wt merge
`--config-set <toml>` overrides any user config key for a single invocation. The value is a TOML fragment, so arrays and tables work directly; the flag is global (works before or after the subcommand), repeatable, and a later `--config-set` replaces an earlier one for the same key.
-```bash
+```console
$ wt --config-set list.full=true list
$ wt step copy-ignored --config-set 'step.copy-ignored.exclude=["target", "dist"]'
```
@@ -691,7 +691,7 @@ Sources closer to the invocation rank higher (user config above system config),
A `--config-set` that names a project entry is both the highest layer and the most specific key, so it beats the same flag's global key:
-```bash
+```console
$ wt --config-set 'projects."github.com/owner/repo".worktree-path = "/tmp/scratch"' switch --create feature
```
@@ -754,7 +754,7 @@ If a config file doesn't exist, shows defaults that would be used.
Use `--full` to run diagnostic checks:
-```bash
+```console
$ wt config show --full
```
@@ -812,37 +812,37 @@ Project hooks and project aliases prompt for approval on first run to prevent un
### Examples
List commands and their approval status for current project:
-```bash
+```console
$ wt config approvals list
```
Pre-approve all hook and alias commands for current project:
-```bash
+```console
$ wt config approvals add
```
Pre-approve without prompting, for a container or CI job:
-```bash
+```console
$ wt config approvals add --yes
```
Clear approvals for current project:
-```bash
+```console
$ wt config approvals clear
```
Clear only approvals for commands no longer in the project config:
-```bash
+```console
$ wt config approvals clear --stale
```
Clear global approvals:
-```bash
+```console
$ wt config approvals clear --global
```
Check whether an unattended run would stop for approval:
-```bash
+```console
$ wt config approvals list --format=json | jq -r .state
```
@@ -915,17 +915,17 @@ Aliases are command templates configured in user (`~/.config/worktrunk/config.to
### Examples
Show every configured alias's template:
-```bash
+```console
$ wt config alias show
```
Show the template for `deploy`:
-```bash
+```console
$ wt config alias show deploy
```
Preview an invocation without running it:
-```bash
+```console
$ wt config alias dry-run deploy
$ wt config alias dry-run deploy -- --env=staging
```
@@ -981,37 +981,37 @@ State is stored in `.git/` (config entries and log files), separate from configu
### Examples
Get the default branch:
-```bash
+```console
$ wt config state default-branch
```
Set the default branch manually:
-```bash
+```console
$ wt config state default-branch set main
```
Set a marker for current branch:
-```bash
+```console
$ wt config state marker set 🚧
```
Store arbitrary data:
-```bash
+```console
$ wt config state vars set env=staging
```
Drop the regenerable caches:
-```bash
+```console
$ wt config state cache clear
```
Show all stored state:
-```bash
+```console
$ wt config state get
```
Clear all stored state:
-```bash
+```console
$ wt config state clear
```
@@ -1075,12 +1075,12 @@ Without a subcommand, runs `get`.
### Examples
Show cache contents:
-```bash
+```console
$ wt config state cache
```
Drop all caches:
-```bash
+```console
$ wt config state cache clear
```
@@ -1128,7 +1128,7 @@ Default branch detection and override.
Useful in scripts to avoid hardcoding `main` or `master`:
-```bash
+```console
$ git rebase $(wt config state default-branch)
```
@@ -1252,27 +1252,27 @@ All logs are stored in `.git/wt/logs/` (in the main worktree's git directory). A
### Examples
List all log files:
-```bash
+```console
$ wt config state logs
```
Query the command log:
-```bash
+```console
$ tail -5 .git/wt/logs/commands.jsonl | jq .
```
Path to one hook log (e.g. the `post-start` `server` hook for the current branch):
-```bash
+```console
$ wt config state logs --format=json | jq -r '.hook_output[] | select(.source == "user" and .hook_type == "post-start" and (.name | startswith("server"))) | .path'
```
Logs for a specific branch:
-```bash
+```console
$ wt config state logs --format=json | jq '.hook_output[] | select(.branch | startswith("feature"))'
```
Clear all logs:
-```bash
+```console
$ wt config state logs clear
```
@@ -1373,7 +1373,7 @@ Custom status text or emoji shown in the `wt list` Status column.
Markers appear at the end of the Status column, after git symbols:
-```
+```console
$ wt list
Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
@ main ^⇡ ⇡1 33323bc 1d Initial commit
@@ -1394,7 +1394,7 @@ $ wt list
Stored in git config as `worktrunk.state.<branch>.marker`. Set directly with:
-```bash
+```console
$ git config worktrunk.state.feature.marker '{"marker":"🚧","set_at":0}'
```
@@ -1450,23 +1450,23 @@ Store custom variables per branch. Values are stored as-is — plain strings or
### Examples
Set and get values:
-```bash
+```console
$ wt config state vars set env=staging
$ wt config state vars get env
```
Store JSON:
-```bash
+```console
$ wt config state vars set config='{"port": 3000, "debug": true}'
```
List all keys:
-```bash
+```console
$ wt config state vars list
```
Operate on a different branch:
-```bash
+```console
$ wt config state vars set env=production --branch=main
```
@@ -1481,7 +1481,7 @@ dev = "ENV={{ vars.env | default('development') }} npm start -- --port {{ vars.p
JSON object and array values support dot access:
-```bash
+```console
$ wt config state vars set config='{"port": 3000, "debug": true}'
```
```toml
diff --git a/skills/worktrunk/reference/faq.md b/skills/worktrunk/reference/faq.md
index b8b9dd357..f06ea859c 100644
--- a/skills/worktrunk/reference/faq.md
+++ b/skills/worktrunk/reference/faq.md
@@ -10,7 +10,7 @@ Branch switching uses one directory: uncommitted changes from one agent get mixe
Git's built-in worktree commands work but require manual lifecycle management:
-```bash
+```console
# Plain git worktree workflow
$ git worktree add -b feature-branch ../myapp-feature main
$ cd ../myapp-feature
@@ -23,7 +23,7 @@ $ git branch -d feature-branch
Worktrunk automates the full lifecycle:
-```bash
+```console
$ wt switch --create feature-branch # Creates worktree, runs setup hooks
# ...work...
$ wt merge # Merges into default branch, cleans up
@@ -59,7 +59,7 @@ Not natively — stacked-branch workflows are a large design space, so Worktrunk
Stash the changes, create the worktree, then pop:
-```bash
+```console
$ git stash push -u # -u also stashes untracked files
$ wt switch --create feature # new branch off the default branch
$ git stash pop # changes reappear in the new worktree
@@ -219,6 +219,7 @@ User hooks and user aliases don't require approval (you defined them). Commands
### Example approval prompt
+```console
▲ repo needs approval to execute 3 commands:
○ pre-start install:
@@ -229,6 +230,7 @@ User hooks and user aliases don't require approval (you defined them). Commands
echo 'PORT={{ branch | hash_port }}' > .env.local
❯ Allow and remember? [y/N]
+```
Use `--yes` to bypass prompts (useful for CI/automation).
@@ -238,7 +240,7 @@ All hook executions and LLM commands are recorded in `.git/wt/logs/commands.json
View the log with `wt config state logs get`, or query directly:
-```bash
+```console
# Recent commands
$ tail -5 .git/wt/logs/commands.jsonl | jq .
diff --git a/skills/worktrunk/reference/hook.md b/skills/worktrunk/reference/hook.md
index 82f2b5354..d34fdff35 100644
--- a/skills/worktrunk/reference/hook.md
+++ b/skills/worktrunk/reference/hook.md
@@ -279,7 +279,7 @@ copy = "wt step copy-ignored"
`wt hook <type>` runs hooks on demand — useful for testing during development, running in CI pipelines, or re-running after a failure.
-```bash
+```console
$ wt hook pre-merge # Run all pre-merge hooks
$ wt hook pre-merge test # Run hooks named "test" from both sources
$ wt hook pre-merge test build # Run hooks named "test" and "build"
@@ -293,7 +293,7 @@ $ wt hook pre-merge -- --extra args # Forward tokens into {{ args }}
The `user:` and `project:` prefixes filter by source. Use `user:` or `project:` alone to run all hooks from that source, or `user:name` / `project:name` to run a specific hook.
-```
+```console
$ wt hook pre-merge
◎ Running pre-merge project:test
cargo test
@@ -313,7 +313,7 @@ test result: ok. 18 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; fin
Finished dev [unoptimized + debuginfo] target(s) in 1.23s
```
-```bash
+```console
$ wt hook post-start
◎ Running post-start: project @ ~/acme
```
diff --git a/skills/worktrunk/reference/list.md b/skills/worktrunk/reference/list.md
index 643e89720..69a078bfa 100644
--- a/skills/worktrunk/reference/list.md
+++ b/skills/worktrunk/reference/list.md
@@ -14,7 +14,7 @@ The table renders progressively: branch names, paths, and commit hashes appear i
List all worktrees:
-```
+```console
$ wt list
Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 ⇡3 6814f02 30m Add API tests
@@ -27,7 +27,7 @@ $ wt list
Include CI status and LLM summaries:
-```
+```console
$ wt list --full
Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
@@ -40,7 +40,7 @@ $ wt list --full
Include branches that don't have worktrees:
-```
+```console
$ wt list --branches --full
Branch Status HEAD± main↕ main…± Summary Remote⇅ CI Commit
@ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 Refactor API to REST architecture with middleware ⇡3 #412 6814f02
@@ -55,7 +55,7 @@ $ wt list --branches --full
Output as JSON for scripting:
-```bash
+```console
$ wt list --format=json
```
@@ -277,7 +277,7 @@ Schema 1 names map directly: `commit` → `head`, `working_tree` →
`url_active` → `dev_server`, `statusline`/`symbols`/`columns` → `display.*`,
and the per-item `repo` moves to the envelope's `repo.forge`.
-```bash
+```console
# Current worktree path (for scripts)
$ wt list --format=json | jq -r '.items[] | select(.worktree.current) | .worktree.path'
@@ -300,7 +300,7 @@ optional there rather than required-and-null.
The original bare-array format, and the default while unset:
-```bash
+```console
# Current worktree path (for scripts)
$ wt list --format=json | jq -r '.[] | select(.is_current) | .path'
diff --git a/skills/worktrunk/reference/llm-commits.md b/skills/worktrunk/reference/llm-commits.md
index 1a5d6dda0..fb3f31adc 100644
--- a/skills/worktrunk/reference/llm-commits.md
+++ b/skills/worktrunk/reference/llm-commits.md
@@ -45,52 +45,52 @@ These examples assume a feature worktree with changes to commit.
Squashes all changes (uncommitted + existing commits) into one commit with an LLM-generated message, then merges to the default branch:
-```bash
+```console
$ wt merge
-<span class=c>◎</span> <span class=c>Squashing 3 commits into a single commit <span style='color:var(--bright-black,#555)'>(5 files, <span class=g>+16</span></span></span><span style='color:var(--bright-black,#555)'>)</span>...
-<span class=c>◎</span> <span class=c>Generating squash commit message...</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>feat(auth): Implement JWT authentication system</b>
-<span style='background:var(--bright-white,#fff)'> </span>
-<span style='background:var(--bright-white,#fff)'> </span> Add comprehensive JWT token handling including validation, refresh
-<span style='background:var(--bright-white,#fff)'> </span> logic, and authentication tests.
-<span class=g>✓</span> <span class=g>Squashed @ a1b2c3d</span>
-<span class=c>◎</span> <span class=c>Merging 1 commit to <b>main</b> @ <span class=d>a1b2c3d</span> (no rebase needed)</span>
-<span style='background:var(--bright-white,#fff)'> </span> * <span style='color:var(--yellow,#a60)'>a1b2c3d</span> feat(auth): Implement JWT authentication system
-<span style='background:var(--bright-white,#fff)'> </span> auth.rs | 2 <span class=g>++</span>
-<span style='background:var(--bright-white,#fff)'> </span> auth_test.rs | 2 <span class=g>++</span>
-<span style='background:var(--bright-white,#fff)'> </span> integration_test.rs | 6 <span class=g>++++++</span>
-<span style='background:var(--bright-white,#fff)'> </span> jwt.rs | 3 <span class=g>+++</span>
-<span style='background:var(--bright-white,#fff)'> </span> jwt_test.rs | 3 <span class=g>+++</span>
-<span style='background:var(--bright-white,#fff)'> </span> 5 files changed, 16 insertions(+)
-<span class=g>✓</span> <span class=g>Merged to <b>main</b> <span style='color:var(--bright-black,#555)'>(1 commit, 5 files, <span class=g>+16</span></span></span><span style='color:var(--bright-black,#555)'>)</span>
-<span class=c>◎</span> <span class=c>Removing <b>feature</b> worktree &amp; branch in background (same commit as <b>main</b>,</span> <span class=d>_</span><span class=c>)</span>
-<span class=d>○</span> Switched to worktree for <b>main</b> @ <b>~/repo</b>
+◎ Squashing 3 commits into a single commit (5 files, +16)...
+◎ Generating squash commit message...
+ feat(auth): Implement JWT authentication system
+
+ Add comprehensive JWT token handling including validation, refresh
+ logic, and authentication tests.
+✓ Squashed @ a1b2c3d
+◎ Merging 1 commit to main @ a1b2c3d (no rebase needed)
+ * a1b2c3d feat(auth): Implement JWT authentication system
+ auth.rs | 2 ++
+ auth_test.rs | 2 ++
+ integration_test.rs | 6 ++++++
+ jwt.rs | 3 +++
+ jwt_test.rs | 3 +++
+ 5 files changed, 16 insertions(+)
+✓ Merged to main (1 commit, 5 files, +16)
+◎ Removing feature worktree & branch in background (same commit as main, _)
+○ Switched to worktree for main @ ~/repo
```
### wt step commit
Stages and commits with LLM-generated message:
-```bash
+```console
$ wt step commit
-<span class=c>◎</span> <span class=c>Generating commit message and committing changes... <span style='color:var(--bright-black,#555)'>(2 files, <span class=g>+26</span></span></span><span style='color:var(--bright-black,#555)'>)</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>feat(validation): add input validation utilities</b>
-<span class=g>✓</span> <span class=g>Committed changes @ <span class=d>a1b2c3d</span></span>
+◎ Generating commit message and committing changes... (2 files, +26)
+ feat(validation): add input validation utilities
+✓ Committed changes @ a1b2c3d
```
### wt step squash
Squashes branch commits into one with LLM-generated message:
-```bash
+```console
$ wt step squash
-<span class=c>◎</span> <span class=c>Squashing 3 commits into a single commit <span style='color:var(--bright-black,#555)'>(5 files, <span class=g>+16</span></span></span><span style='color:var(--bright-black,#555)'>)</span>...
-<span class=c>◎</span> <span class=c>Generating squash commit message...</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>feat(auth): Implement JWT authentication system</b>
-<span style='background:var(--bright-white,#fff)'> </span>
-<span style='background:var(--bright-white,#fff)'> </span> Add comprehensive JWT token handling including validation, refresh
-<span style='background:var(--bright-white,#fff)'> </span> logic, and authentication tests.
-<span class=g>✓</span> <span class=g>Squashed @ a1b2c3d</span>
+◎ Squashing 3 commits into a single commit (5 files, +16)...
+◎ Generating squash commit message...
+ feat(auth): Implement JWT authentication system
+
+ Add comprehensive JWT token handling including validation, refresh
+ logic, and authentication tests.
+✓ Squashed @ a1b2c3d
```
See [`wt merge`](https://worktrunk.dev/merge/) and [`wt step`](https://worktrunk.dev/step/) for full documentation.
diff --git a/skills/worktrunk/reference/merge.md b/skills/worktrunk/reference/merge.md
index 7781639f4..79e77492a 100644
--- a/skills/worktrunk/reference/merge.md
+++ b/skills/worktrunk/reference/merge.md
@@ -8,7 +8,7 @@ Unlike `git merge`, this merges the current branch into the target branch — no
Merge to the default branch:
-```
+```console
$ wt merge
◎ Running pre-merge project:test
cargo nextest run
@@ -25,37 +25,37 @@ $ wt merge
Merge to a different branch:
-```bash
+```console
$ wt merge develop
```
Keep the worktree after merging:
-```bash
+```console
$ wt merge --no-remove
```
Preserve commit history (no squash):
-```bash
+```console
$ wt merge --no-squash
```
Create a merge commit — rebased semi-linear history by default:
-```bash
+```console
$ wt merge --no-ff
```
Skip committing/squashing (rebase still runs unless --no-rebase):
-```bash
+```console
$ wt merge --no-commit
```
Preserve the exact clean commit graph and tip:
-```bash
+```console
$ wt merge --no-commit --no-rebase
```
diff --git a/skills/worktrunk/reference/remove.md b/skills/worktrunk/reference/remove.md
index 0eee006fd..f7f81360e 100644
--- a/skills/worktrunk/reference/remove.md
+++ b/skills/worktrunk/reference/remove.md
@@ -6,7 +6,7 @@ Remove worktree; delete branch if merged. Defaults to the current worktree.
Remove current worktree:
-```
+```console
$ wt remove
◎ Running pre-remove project:cleanup
flyctl scale count 0
@@ -17,20 +17,20 @@ Scaling app to 0 machines
Remove specific worktrees / branches:
-```bash
+```console
$ wt remove feature-branch
$ wt remove old-feature another-branch
```
Keep the branch:
-```bash
+```console
$ wt remove --no-delete-branch feature-branch
```
Force-delete an unmerged branch:
-```bash
+```console
$ wt remove -D experimental
```
@@ -64,7 +64,7 @@ Worktrunk has two force flags for different situations:
| `--force` (`-f`) | Worktree | Worktree has uncommitted changes |
| `--force-delete` (`-D`) | Branch | Branch has unmerged commits |
-```bash
+```console
$ wt remove feature --force # Remove dirty worktree
$ wt remove feature -D # Delete unmerged branch
$ wt remove feature --force -D # Both
@@ -82,7 +82,7 @@ After each `wt remove`, entries in `.git/wt/trash/` older than 24 hours are swep
`--reap` terminates processes left running in the worktree before it is removed — a `post-start` dev server, a file watcher, a language server — freeing the ports and file handles they hold. Processes are discovered by working directory: any process whose current directory is at or under the worktree path (`SIGTERM`, then `SIGKILL` for survivors).
-```bash
+```console
$ wt remove --reap feature
◎ Reaping 2 processes under feature worktree
┃ 51234 node
diff --git a/skills/worktrunk/reference/step.md b/skills/worktrunk/reference/step.md
index d2b35280c..e69bfe85f 100644
--- a/skills/worktrunk/reference/step.md
+++ b/skills/worktrunk/reference/step.md
@@ -6,7 +6,7 @@ Run individual operations. The building blocks of wt merge — commit, squash, r
Commit with LLM-generated message:
-```
+```console
$ wt step commit
◎ Generating commit message and committing changes... (2 files, +26)
feat(validation): add input validation utilities
@@ -15,7 +15,7 @@ $ wt step commit
Manual merge workflow with review between steps:
-```bash
+```console
$ wt step commit
$ wt step squash
$ wt step rebase
@@ -105,7 +105,7 @@ Controls what to stage before committing:
| `tracked` | Stage only modified tracked files |
| `none` | Don't stage anything, commit only what's already staged |
-```bash
+```console
$ wt step commit --stage=tracked
```
@@ -120,7 +120,7 @@ stage = "tracked"
Render the prompt, print the LLM command, generate the message, and exit without staging, running hooks, or committing:
-```bash
+```console
$ wt step commit --dry-run
```
@@ -200,7 +200,7 @@ Controls what to stage before squashing:
| `tracked` | Stage only modified tracked files |
| `none` | Don't stage anything, squash only committed changes |
-```bash
+```console
$ wt step squash --stage=none
```
@@ -215,7 +215,7 @@ stage = "tracked"
Render the prompt, print the LLM command, generate the squash message, and exit without resetting, running hooks, or committing:
-```bash
+```console
$ wt step squash --dry-run
```
@@ -292,7 +292,7 @@ The target is any commit: a branch, a tag, a SHA.
### Examples
-```bash
+```console
$ wt step rebase # Rebase onto default branch
$ wt step rebase develop # Rebase onto develop
$ wt step rebase v1.2.0 # Rebase onto a tag
@@ -371,7 +371,7 @@ The target is a branch, and must already be an ancestor of the current branch. O
### Examples
-```bash
+```console
$ wt step push # Fast-forward main to current branch
$ wt step push develop # Fast-forward develop instead
$ wt step push --no-ff # Merge commit instead of a fast-forward
@@ -441,7 +441,7 @@ This is what `wt merge` would include — a single diff against the merge base.
`--branch` diffs another worktree's branch without leaving the current one:
-```bash
+```console
$ wt step diff --branch feature
```
@@ -451,7 +451,7 @@ The branch must have a checked-out worktree.
Arguments after `--` are forwarded to `git diff`:
-```bash
+```console
$ wt step diff -- --stat
$ wt step diff -- --name-only
$ wt step diff -- -- '*.rs'
@@ -459,7 +459,7 @@ $ wt step diff -- -- '*.rs'
The diff is pipeable to tools like `delta`:
-```bash
+```console
$ wt step diff | delta
```
@@ -467,7 +467,7 @@ $ wt step diff | delta
Equivalent to:
-```bash
+```console
$ cp "$(git rev-parse --git-dir)/index" /tmp/idx
$ GIT_INDEX_FILE=/tmp/idx git add --intent-to-add .
$ GIT_INDEX_FILE=/tmp/idx git diff $(git merge-base HEAD $(wt config state default-branch))
@@ -555,7 +555,7 @@ exclude = [".cache/", ".turbo/"]
To copy nothing unless `.worktreeinclude` exists — matching Claude Code desktop, where the file is required — pass `--require-include`:
-```bash
+```console
$ wt step copy-ignored --require-include
```
@@ -688,34 +688,34 @@ All [hook template variables and filters](https://worktrunk.dev/hook/#template-v
Get the port for the current branch:
-```bash
+```console
$ wt step eval '{{ branch | hash_port }}'
16066
```
Use in shell substitution:
-```bash
+```console
$ curl http://localhost:$(wt step eval '{{ branch | hash_port }}')/health
```
Combine multiple values:
-```bash
+```console
$ wt step eval '{{ branch | hash_port }},{{ ("supabase-api-" ~ branch) | hash_port }}'
16066,16739
```
Use conditionals and filters:
-```bash
+```console
$ wt step eval '{{ branch | sanitize_db }}'
feature_auth_oauth2_a1b
```
List the available template variables with `-v` (alongside the expansion, on stderr):
-```bash
+```console
$ wt step eval -v '{{ branch }}'
○ eval template variables:
branch = feature/auth-oauth2
@@ -785,14 +785,14 @@ A summary of successes and failures is shown at the end. A template-expansion er
Arguments after `--` are the program and its arguments — run directly, no shell.
-```bash
+```console
$ wt step for-each -- git status --short
$ wt step for-each -- npm install
```
For pipes, redirects, variables, or globs, wrap in `sh -c`:
-```bash
+```console
$ wt step for-each -- sh -c 'git status | wc -l'
$ wt step for-each -- sh -c 'echo $HOME && git pull'
```
@@ -801,7 +801,7 @@ $ wt step for-each -- sh -c 'echo $HOME && git pull'
Variables substitute into each argv element before exec. See [`wt hook` template variables](https://worktrunk.dev/hook/#template-variables) for the complete list and filters.
-```bash
+```console
$ wt step for-each -- echo 'Branch: {{ branch }}'
```
@@ -811,7 +811,7 @@ Each element is expanded fresh in every worktree, so `{{ branch }}` is that work
Pull updates in worktrees with upstreams (skips others):
-```bash
+```console
$ git fetch --prune && wt step for-each -- sh -c '[ "$(git rev-parse @{u} 2>/dev/null)" ] || exit 0; git pull --autostash'
```
@@ -867,7 +867,7 @@ Swap a branch into the main worktree. Exchanges branches and gitignored files be
### Example
-```bash
+```console
# from ~/project (main worktree)
$ wt step promote feature
```
@@ -967,7 +967,7 @@ Locked worktrees and the main worktree are always skipped. The current worktree
Worktrees younger than `--min-age` (default: 1 day) are skipped. This prevents removing a worktree just created from the default branch — it looks "merged" because its branch points at the same commit.
-```bash
+```console
$ wt step prune --min-age=0s # no age guard
$ wt step prune --min-age=2d # skip worktrees younger than 2 days
```
@@ -980,13 +980,13 @@ $ wt step prune --min-age=2d # skip worktrees younger than 2 days
Preview what would be removed:
-```bash
+```console
$ wt step prune --dry-run
```
Remove all merged worktrees:
-```bash
+```console
$ wt step prune
```
@@ -1047,25 +1047,25 @@ Move worktrees to expected paths. Relocates worktrees whose path doesn't match t
Preview what would be moved:
-```bash
+```console
$ wt step relocate --dry-run
```
Move all mismatched worktrees:
-```bash
+```console
$ wt step relocate
```
Auto-commit and clobber blockers (never fails):
-```bash
+```console
$ wt step relocate --commit --clobber
```
Move specific worktrees:
-```bash
+```console
$ wt step relocate feature bugfix
```
@@ -1179,13 +1179,13 @@ worktree is gone.
Arguments after `--` are the program and its arguments, run directly, no shell.
-```bash
+```console
$ wt step tether -- npm run dev
```
For pipes, redirects, variables, or globs, wrap in `sh -c`:
-```bash
+```console
$ wt step tether -- sh -c 'PORT=$P npm run dev | tee dev.log'
```
@@ -1193,7 +1193,7 @@ To run the command from a subdirectory, pass the global `-C` flag (teardown
still watches the worktree root, so a server launched with a relative `-C` is
torn down with the worktree):
-```bash
+```console
$ wt step tether -C frontend -- npm run dev
```
diff --git a/skills/worktrunk/reference/switch.md b/skills/worktrunk/reference/switch.md
index 97e59a156..afaa82b39 100644
--- a/skills/worktrunk/reference/switch.md
+++ b/skills/worktrunk/reference/switch.md
@@ -6,7 +6,7 @@ Worktrees are addressed by branch name; paths are computed from a configurable t
## Examples
-```bash
+```console
$ wt switch feature-auth # Switch to worktree
$ wt switch - # Previous worktree (like cd -)
$ wt switch --create new-feature # Create new branch and worktree
@@ -29,7 +29,7 @@ If the branch already has a worktree, `wt switch` changes directories to it. Oth
4. Runs [pre-start hooks](https://worktrunk.dev/hook/#hook-types), blocking until complete
5. Spawns [post-start](https://worktrunk.dev/hook/#hook-types) and [post-switch hooks](https://worktrunk.dev/hook/#hook-types) in the background
-```bash
+```console
$ wt switch feature # Existing branch → creates worktree
$ wt switch --create feature # New branch and worktree
$ wt switch --create fix --base release # New branch from release
@@ -50,7 +50,7 @@ Worktrees are addressed by branch name, and every argument that takes one also a
| `pr:{N}` | GitHub PR #N's branch |
| `mr:{N}` | GitLab MR !N's branch |
-```bash
+```console
$ wt switch - # Back to previous
$ wt switch ^ # Default branch worktree
$ wt switch --create fix --base=@ # Branch from current HEAD
@@ -119,7 +119,7 @@ pager = "delta --paging=never --width=$COLUMNS"
The `pr:<number>` / `mr:<number>` shortcut and the PR/MR's web URL both resolve to its branch. For same-repo PRs/MRs, worktrunk switches to the branch directly. For fork PRs/MRs, it fetches the ref (`refs/pull/N/head` or `refs/merge-requests/N/head`) and configures `pushRemote` to the fork URL.
-```bash
+```console
$ wt switch pr:101 # GitHub PR #101
$ wt switch https://github.com/owner/repo/pull/101 # ...the same PR, by URL
$ wt switch mr:101 # GitLab MR !101
diff --git a/skills/worktrunk/reference/tips-patterns.md b/skills/worktrunk/reference/tips-patterns.md
index 0c95e1ef3..8ae3bd0c7 100644
--- a/skills/worktrunk/reference/tips-patterns.md
+++ b/skills/worktrunk/reference/tips-patterns.md
@@ -58,15 +58,15 @@ url = "http://localhost:{{ branch | hash_port }}"
The URL column in `wt list` shows each worktree's dev server:
-```bash
+```console
$ wt list
- <b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Remote⇅</b> <b>URL</b> <b>Commit</b>
-@ main <span class=c>?</span> <span class=d>^</span><span class=d>⇅</span> <span class=g>⇡1</span> <span class=d><span class=r>⇣1</span></span> <span class=d>http://localhost:12107</span> <span class=d>41ee083</span>
-+ feature-api <span class=c>+</span> <span class=d>↕</span><span class=d>⇡</span> <span class=g>+54</span> <span class=r>-5</span> <span class=g>↑4</span> <span class=d><span class=r>↓1</span></span> <span class=g>+234</span> <span class=r>-24</span> <span class=g>⇡3</span> <span class=d>http://localhost:10703</span> <span class=d>6814f02</span>
-+ fix-auth <span class=d>↕</span><span class=d>|</span> <span class=g>↑2</span> <span class=d><span class=r>↓1</span></span> <span class=g>+25</span> <span class=r>-11</span> <span class=d>|</span> <span class=d>http://localhost:16460</span> <span class=d>b772e68</span>
-+ <span class=d>fix-typos</span> <span class=d>_</span><span class=d>|</span> <span class=d>|</span> <span class=d>http://localhost:14301</span> <span class=d>41ee083</span>
+ Branch Status HEAD± main↕ main…± Remote⇅ URL Commit
+@ main ? ^⇅ ⇡1 ⇣1 http://localhost:12107 41ee083
++ feature-api + ↕⇡ +54 -5 ↑4 ↓1 +234 -24 ⇡3 http://localhost:10703 6814f02
++ fix-auth ↕| ↑2 ↓1 +25 -11 | http://localhost:16460 b772e68
++ fix-typos _| | http://localhost:14301 41ee083
-<span class=d>○</span> <span class=d>Showing 4 worktrees, 2 with changes, 2 ahead, 3 columns hidden</span>
+○ Showing 4 worktrees, 2 with changes, 2 ahead, 3 columns hidden
```
`fix-auth` always gets port 16460, on any machine. The URL dims if the server isn't running.
@@ -355,7 +355,7 @@ tmux = "tmux kill-session -t {{ branch | sanitize }} 2>/dev/null || true"
To create a worktree and immediately attach:
-```bash
+```console
$ wt switch --create feature -x tmux -- attach -t '{{ branch | sanitize }}'
```
diff --git a/skills/worktrunk/reference/worktrunk.md b/skills/worktrunk/reference/worktrunk.md
index 4b537f136..6fc3c8db0 100644
--- a/skills/worktrunk/reference/worktrunk.md
+++ b/skills/worktrunk/reference/worktrunk.md
@@ -1,7 +1,7 @@
# Worktrunk
-Worktrunk is a CLI for git worktree management, designed for running AI agents
-in parallel.
+Worktrunk is a CLI for Git worktree management, designed for **parallel AI agent
+workflows**.
Worktrunk's three core commands make worktrees as easy as branches.
Plus, Worktrunk has a bunch of quality-of-life features to simplify working
@@ -24,7 +24,7 @@ worktree requires typing the branch name three times: `git worktree add -b feat
Worktrees are addressed by branch name; paths are computed from a configurable template. Commands that take a branch also accept the path of the worktree it is checked out in.
-> Start with the core commands
+<p class="workflow-stage">Start with the core commands</p>
**Core commands:**
@@ -39,34 +39,34 @@ Worktrees are addressed by branch name; paths are computed from a configurable t
<tbody>
<tr>
<td>Switch worktrees</td>
- <td>wt switch feat</td>
- <td>cd ../repo.feat</td>
+ <td data-label="Worktrunk"><code>wt switch feat</code></td>
+ <td data-label="Plain git"><code>cd ../repo.feat</code></td>
</tr>
<tr>
<td>Create + start Claude</td>
- <td>wt switch -c -x claude feat</td>
- <td>git worktree add -b feat ../repo.feat && \
+ <td data-label="Worktrunk"><code>wt switch -c -x claude feat</code></td>
+ <td data-label="Plain git"><pre><code>git worktree add -b feat ../repo.feat && \
cd ../repo.feat && \
-claude</td>
+claude</code></pre></td>
</tr>
<tr>
<td>Clean up</td>
- <td>wt remove</td>
- <td>cd ../repo && \
+ <td data-label="Worktrunk"><code>wt remove</code></td>
+ <td data-label="Plain git"><pre><code>cd ../repo && \
git worktree remove ../repo.feat && \
-git branch -d feat</td>
+git branch -d feat</code></pre></td>
</tr>
<tr>
<td>List with status</td>
- <td>wt list</td>
- <td>git worktree list (paths only)</td>
+ <td data-label="Worktrunk"><code>wt list</code></td>
+ <td data-label="Plain git"><span class="cmd-compare-value"><code>git worktree list</code> (paths only)</span></td>
</tr>
</tbody>
</table>
-> Expand into the more advanced commands as needed
+<p class="workflow-stage">Expand into the more advanced commands as needed</p>
-**Workflow automation:**
+<p class="workflow-heading"><strong>Workflow automation:</strong></p>
- **[Hooks](https://worktrunk.dev/hook/)** — run commands on create, pre-merge, post-merge, etc
- **[LLM commit messages](https://worktrunk.dev/llm-commits/)** — generate commit messages from diffs
@@ -131,20 +131,20 @@ Or with [Pixi](https://pixi.sh): `pixi global install worktrunk && wt config she
Create a worktree for a new feature:
-```bash
+```console
$ wt switch --create feature-auth
-<span class=g>✓</span> <span class=g>Created branch <b>feature-auth</b> from <b>main</b> and worktree @ <b>~/repo.feature-auth</b></span>
+✓ Created branch feature-auth from main and worktree @ ~/repo.feature-auth
```
This creates a new branch and worktree, then switches to it. Do your work, then check all worktrees with [`wt list`](https://worktrunk.dev/list/):
-```bash
+```console
$ wt list
- <b>Branch</b> <b>Status</b> <b>HEAD±</b> <b>main↕</b> <b>main…±</b> <b>Remote⇅</b> <b>Commit</b> <b>Age</b> <b>Message</b>
-@ feature-auth <span class=c>+</span> <span class=d>↑</span> <span class=g>+27</span> <span class=r>-8</span> <span class=g>↑1</span> <span class=g>+31</span> <span class=d>4bc72dc</span> <span class=d>2h</span> <span class=d>Add authenticati…</span>
-^ main <span class=d>^</span><span class=d>⇡</span> <span class=g>⇡1</span> <span class=d>0e631ad</span> <span class=d>1d</span> <span class=d>Initial commit</span>
+ Branch Status HEAD± main↕ main…± Remote⇅ Commit Age Message
+@ feature-auth + ↑ +27 -8 ↑1 +31 4bc72dc 2h Add authenticati…
+^ main ^⇡ ⇡1 0e631ad 1d Initial commit
-<span class=d>○</span> <span class=d>Showing 2 worktrees, 1 with changes, 1 ahead, 1 column hidden</span>
+○ Showing 2 worktrees, 1 with changes, 1 ahead, 1 column hidden
```
The `@` marks the current worktree. `+` means staged changes, `↑1` means 1 commit ahead of main, `⇡` means unpushed commits.
@@ -161,19 +161,19 @@ wt remove # after PR is merged
**Local merge** — squash, rebase onto main, fast-forward merge, clean up:
-```bash
+```console
$ wt merge main
-<span class=c>◎</span> <span class=c>Generating commit message and committing changes... <span style='color:var(--bright-black,#555)'>(2 files, <span class=g>+53</span></span></span>, no squashing needed<span style='color:var(--bright-black,#555)'>)</span>
-<span style='background:var(--bright-white,#fff)'> </span> <b>Add authentication module</b>
-<span class=g>✓</span> <span class=g>Committed changes @ <span class=d>a1b2c3d</span></span>
-<span class=c>◎</span> <span class=c>Merging 1 commit to <b>main</b> @ <span class=d>a1b2c3d</span> (no rebase needed)</span>
-<span style='background:var(--bright-white,#fff)'> </span> * <span style='color:var(--yellow,#a60)'>a1b2c3d</span> Add authentication module
-<span style='background:var(--bright-white,#fff)'> </span> auth.rs | 51 <span class=g>+++++++++++++++++++++++++++++++++++++++++++++++++++</span>
-<span style='background:var(--bright-white,#fff)'> </span> lib.rs | 2 <span class=g>++</span>
-<span style='background:var(--bright-white,#fff)'> </span> 2 files changed, 53 insertions(+)
-<span class=g>✓</span> <span class=g>Merged to <b>main</b> <span style='color:var(--bright-black,#555)'>(1 commit, 2 files, <span class=g>+53</span></span></span><span style='color:var(--bright-black,#555)'>)</span>
-<span class=c>◎</span> <span class=c>Removing <b>feature-auth</b> worktree &amp; branch in background (same commit as <b>main</b>,</span> <span class=d>_</span><span class=c>)</span>
-<span class=d>○</span> Switched to worktree for <b>main</b> @ <b>~/repo</b>
+◎ Generating commit message and committing changes... (2 files, +53, no squashing needed)
+ Add authentication module
+✓ Committed changes @ a1b2c3d
+◎ Merging 1 commit to main @ a1b2c3d (no rebase needed)
+ * a1b2c3d Add authentication module
+ auth.rs | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
+ lib.rs | 2 ++
+ 2 files changed, 53 insertions(+)
+✓ Merged to main (1 commit, 2 files, +53)
+◎ Removing feature-auth worktree & branch in background (same commit as main, _)
+○ Switched to worktree for main @ ~/repo
```
For parallel agents, create multiple worktrees and launch an agent in each:
diff --git a/src/cli/config.rs b/src/cli/config.rs
index 190535587..28b009592 100644
--- a/src/cli/config.rs
+++ b/src/cli/config.rs
@@ -237,7 +237,7 @@ pub enum ApprovalsCommand {
#[command(
after_long_help = r#"Shows every command the project config declares — hooks, aliases, and commit-message guidance — grouped into APPROVED and UNAPPROVED sections. Approvals recorded for commands no longer in the project config (edited or removed since approval) are listed separately.
-Reading is all it does: no prompt, no write. `--format=json` emits the same four distinctions as a structured payload — see [Reading approval state](@/config.md#reading-approval-state).
+Reading is all it does: no prompt, no write. `--format=json` emits the same four distinctions as a structured payload — see [Reading approval state](/config/#reading-approval-state).
## Examples
@@ -263,7 +263,7 @@ $ wt config approvals list --format=json | jq -r .state
By default, shows only unapproved commands. Use `--all` to review all commands
including previously approved ones.
-`--yes` writes the approvals without prompting, which is how a container or CI job pre-approves a project it has just cloned. It trusts every command the project config declares, including one whose template changed since an earlier approval. A caller that wants to look before granting them can list those first — see [Reading approval state](@/config.md#reading-approval-state).
+`--yes` writes the approvals without prompting, which is how a container or CI job pre-approves a project it has just cloned. It trusts every command the project config declares, including one whose template changed since an earlier approval. A caller that wants to look before granting them can list those first — see [Reading approval state](/config/#reading-approval-state).
## Examples
@@ -636,7 +636,7 @@ Approved commands are saved to `~/.config/worktrunk/approvals.toml`. Re-approval
/// Inspect and preview aliases
#[command(
- after_long_help = r#"Aliases are command templates configured in user (`~/.config/worktrunk/config.toml`) or project (`.config/wt.toml`) config and run as `wt <name>`. See the [Extending Worktrunk guide](@/extending.md#aliases) for the configuration format.
+ after_long_help = r#"Aliases are command templates configured in user (`~/.config/worktrunk/config.toml`) or project (`.config/wt.toml`) config and run as `wt <name>`. See the [Extending Worktrunk guide](/extending/#aliases) for the configuration format.
## Examples
@@ -690,11 +690,11 @@ $ wt config plugins opencode install
## Keys
-- **cache**: [Regenerable caches — CI status, summaries, git commands, hints, and the `wt switch -` target](@/config.md#wt-config-state-cache)
-- **default-branch**: [The repository's default branch (`main`, `master`, etc.)](@/config.md#wt-config-state-default-branch)
-- **marker**: [Custom status marker for a branch (shown in `wt list`)](@/config.md#wt-config-state-marker)
-- **vars**: [experimental] [Custom variables per branch](@/config.md#wt-config-state-vars)
-- **logs**: [Operation and debug logs](@/config.md#wt-config-state-logs)
+- **cache**: [Regenerable caches — CI status, summaries, git commands, hints, and the `wt switch -` target](/config/#wt-config-state-cache)
+- **default-branch**: [The repository's default branch (`main`, `master`, etc.)](/config/#wt-config-state-default-branch)
+- **marker**: [Custom status marker for a branch (shown in `wt list`)](/config/#wt-config-state-marker)
+- **vars**: [experimental] [Custom variables per branch](/config/#wt-config-state-vars)
+- **logs**: [Operation and debug logs](/config/#wt-config-state-logs)
## Examples
@@ -806,7 +806,7 @@ untouched."#)]
## What's cached
-- **CI status** — GitHub/GitLab CI per branch (30–60s TTL), shown in [`wt list`](@/list.md#ci-status), plus the largest PR/MR number seen (sizes the CI column)
+- **CI status** — GitHub/GitLab CI per branch (30–60s TTL), shown in [`wt list`](/list/#ci-status), plus the largest PR/MR number seen (sizes the CI column)
- **Summaries** — LLM-generated branch summaries (`wt list --full`, `wt switch` preview)
- **Git commands** — cached merge-tree, ancestry, diff-stat, and `wt switch` preview results
- **Hints** — one-time hints already shown in this repo
@@ -845,7 +845,7 @@ $ wt config state cache clear
$ git rebase $(wt config state default-branch)
```
-In a hook or alias template, prefer the `{{ default_branch }}` [template variable](@/hook.md#template-variables); `$(wt config state default-branch)` is for plain shell scripts.
+In a hook or alias template, prefer the `{{ default_branch }}` [template variable](/hook/#template-variables); `$(wt config state default-branch)` is for plain shell scripts.
Without a subcommand, runs `get`. Use `set` to override, or `clear` then `get` to re-detect.
@@ -881,7 +881,7 @@ If none of these match, detection fails; set it explicitly with `wt config state
#[command(
name = "previous-branch",
hide = true,
- after_long_help = r#"**Deprecated** — the previous branch is now part of [`wt config state cache`](@/config.md#wt-config-state-cache). This subcommand still works but prints a deprecation notice.
+ after_long_help = r#"**Deprecated** — the previous branch is now part of [`wt config state cache`](/config/#wt-config-state-cache). This subcommand still works but prints a deprecation notice.
Enables `wt switch -` to return to the previous worktree, similar to `cd -` or `git checkout -`.
@@ -987,7 +987,7 @@ $ wt config state logs clear
/// One-time hints shown in this repo
#[command(
hide = true,
- after_long_help = r#"**Deprecated** — hints are now part of [`wt config state cache`](@/config.md#wt-config-state-cache). This subcommand still works but prints a deprecation notice.
+ after_long_help = r#"**Deprecated** — hints are now part of [`wt config state cache`](/config/#wt-config-state-cache). This subcommand still works but prints a deprecation notice.
Some hints show once per repo on first use, then are recorded in git config
as `worktrunk.hints.<name>`, a count of times the hint has been shown.
@@ -1019,9 +1019,9 @@ $ wt config state hints clear NAME # re-show specific hint
#[command(
name = "ci-status",
hide = true,
- after_long_help = r#"**Deprecated** — the CI status cache is now part of [`wt config state cache`](@/config.md#wt-config-state-cache). This subcommand still works but prints a deprecation notice.
+ after_long_help = r#"**Deprecated** — the CI status cache is now part of [`wt config state cache`](/config/#wt-config-state-cache). This subcommand still works but prints a deprecation notice.
-Status values, display symbols, and fetch behavior: [`wt list` CI status](@/list.md#ci-status).
+Status values, display symbols, and fetch behavior: [`wt list` CI status](/list/#ci-status).
Without a subcommand, runs `get` for the current branch. Use `clear` to reset cache for a branch or `clear --all` to reset all."#
)]
@@ -1049,7 +1049,7 @@ wt list
## Use cases
- **Work status** — `🚧` WIP, `✅` ready for review, `🔥` urgent
-- **Agent tracking** — The [Claude Code](@/claude-code.md) plugin sets markers automatically
+- **Agent tracking** — The [Claude Code](/claude-code/) plugin sets markers automatically
- **Notes** — Any short text: `"blocked"`, `"needs tests"`
## Storage
@@ -1100,7 +1100,7 @@ $ wt config state vars set env=production --branch=main
## Template access
-Variables are available in [hook templates](@/hook.md#template-variables) as `{{ vars.<key> }}`. Use the `default` filter for keys that may not be set:
+Variables are available in [hook templates](/hook/#template-variables) as `{{ vars.<key> }}`. Use the `default` filter for keys that may not be set:
```toml
[post-start]
diff --git a/src/cli/list.rs b/src/cli/list.rs
index fd9b566f0..695028777 100644
--- a/src/cli/list.rs
+++ b/src/cli/list.rs
@@ -31,7 +31,7 @@ The CI reference links to its PR/MR, and a dev server URL carrying a port shows
The pace segment appears only when usage is likely to hit a rate limit before its window resets, and shows the higher-risk window: `2.9×(Tue–Tue 5pm)` reads as 2.9× the pace that would exactly fill that window. Above 90% used it shows usage instead of pace — `93%(Tue–Tue 5pm)` — near the cap, how much is left matters more than how fast it's going. "Likely" is a Bayesian forecast; early-window bursts don't trigger it. Its colour deepens with severity — dim, then dim-yellow, then yellow — as the forecast lockout (how much of the window would be spent capped) grows, so a fast pace that would only tip over near the reset stays dim rather than alarming. With `-vv`, each window's inputs and projection are logged to `.git/wt/logs/trace.log`.
-[Claude Code statusline setup](@/claude-code.md#statusline-claude-code-only) has the `~/.claude/settings.json` entry that feeds this mode.
+[Claude Code statusline setup](/claude-code/#statusline-claude-code-only) has the `~/.claude/settings.json` entry that feeds this mode.
"#
)]
Statusline {
diff --git a/src/cli/mod.rs b/src/cli/mod.rs
index 6c6b519d7..adf6ad9b2 100644
--- a/src/cli/mod.rs
+++ b/src/cli/mod.rs
@@ -382,7 +382,7 @@ pub(crate) struct SwitchArgs {
/// command runs against the selected worktree — so `wt switch -x claude`
/// picks a worktree, then launches Claude Code there.
///
- /// Supports [hook template variables](@/hook.md#template-variables)
+ /// Supports [hook template variables](https://worktrunk.dev/hook/#template-variables)
/// (`{{ branch }}`, `{{ worktree_path }}`, etc.) and filters.
/// `{{ base }}` and `{{ base_worktree_path }}` describe the source: the
/// selected base with `--create`, or the invoking worktree when switching
@@ -631,11 +631,11 @@ The `--create` flag creates a new branch from `--base` — the default branch un
If the branch already has a worktree, `wt switch` changes directories to it. Otherwise, it creates one:
-1. Runs [pre-switch hooks](@/hook.md#hook-types), blocking until complete
+1. Runs [pre-switch hooks](/hook/#hook-types), blocking until complete
2. Creates worktree at configured path
3. Switches to new directory
-4. Runs [pre-start hooks](@/hook.md#hook-types), blocking until complete
-5. Spawns [post-start](@/hook.md#hook-types) and [post-switch hooks](@/hook.md#hook-types) in the background
+4. Runs [pre-start hooks](/hook/#hook-types), blocking until complete
+5. Spawns [post-start](/hook/#hook-types) and [post-switch hooks](/hook/#hook-types) in the background
```console
$ wt switch feature # Existing branch → creates worktree
@@ -673,7 +673,7 @@ Shortcuts also apply to `--base`. For a fork PR/MR, the head commit is fetched a
When called without arguments, `wt switch` opens an interactive picker to browse and select worktrees with live preview. The candidate set widens with `--branches` (local branches without worktrees), `--remotes` (remote branches), and `--prs` (open PRs/MRs — see below).
-The CI column shows each row's PR/MR CI and review status, the same as [`wt list --full`](@/list.md).
+The CI column shows each row's PR/MR CI and review status, the same as [`wt list --full`](/list/).
<!-- demo: wt-switch-picker.gif 1600x800 -->
**Keybindings:**
@@ -709,7 +709,7 @@ Typing a gutter sigil filters by row kind: `+` narrows to linked worktrees and `
3. **committed** — Committed changes since the comparison base
4. **log** — Recent commits; commits already on the default branch have dimmed hashes
5. **remote⇅** — Ahead/behind diff vs upstream tracking branch
-6. **summary** — LLM-generated branch summary; requires `[list] summary = true` and [`commit.generation`](@/config.md#commit)
+6. **summary** — LLM-generated branch summary; requires `[list] summary = true` and [`commit.generation`](/config/#commit)
7. **pr** — The selected row's PR/MR, for any row whose branch has one
8. **comments** — The PR/MR's comment thread, fetched from the forge for any row whose branch has one
@@ -742,7 +742,7 @@ If the PR or MR is on a fork, the local branch uses its branch name directly, so
The `--prs` flag adds the repository's open PRs (GitHub) or MRs (GitLab) to the interactive picker — only the ones not already there: a PR whose branch is already shown (as a worktree, or a local or remote branch) isn't listed twice, so `--prs` only adds the rest and the two pickers differ solely by those extra rows. Each added row resolves to the same `pr:`/`mr:` shortcut, so selecting one fetches the ref and switches to its branch. A `--prs` row has no local worktree, so its `pr` and `comments` preview tabs load the PR/MR's metadata and comments from the forge in the background. The `log` tab uses a local `git log` — graph and merge-base dimming included — whenever the head commit is already in the object store (a same-repo PR off a fetched remote), falling back to a flat forge-fetched commit list otherwise.
-Requires `gh` (GitHub), `glab` (GitLab), or an equivalent CLI installed and authenticated; see [forge platform](@/config.md#forge-platform) for Gitea, Azure DevOps, and other supported platforms.
+Requires `gh` (GitHub), `glab` (GitLab), or an equivalent CLI installed and authenticated; see [forge platform](/config/#forge-platform) for Gitea, Azure DevOps, and other supported platforms.
## When wt switch fails
@@ -754,9 +754,9 @@ To change which branch a worktree is on, use `git switch` inside that worktree.
## See also
-- [`wt list`](@/list.md) — View all worktrees
-- [`wt remove`](@/remove.md) — Delete worktrees when done
-- [`wt merge`](@/merge.md) — Integrate changes back to the default branch
+- [`wt list`](/list/) — View all worktrees
+- [`wt remove`](/remove/) — Delete worktrees when done
+- [`wt merge`](/merge/) — Integrate changes back to the default branch
"#
)]
Switch(SwitchArgs),
@@ -833,7 +833,7 @@ $ wt list --format=json
| HEAD± | Uncommitted changes: +added -deleted lines |
| main↕ | Commits ahead/behind default branch |
| main…± | Line diffs since the merge-base (three-dot) with the default branch |
-| Summary | LLM-generated branch summary; requires `--full`, `summary = true`, and [`commit.generation`](@/config.md#commit) [experimental] |
+| Summary | LLM-generated branch summary; requires `--full`, `summary = true`, and [`commit.generation`](/config/#commit) [experimental] |
| Remote⇅ | Commits ahead/behind tracking branch |
| CI | PR/MR number colored by pipeline status; `--full` only |
| Path | Worktree directory |
@@ -883,18 +883,18 @@ CI cells are clickable links to the PR or pipeline page, and appear dimmed for a
### LLM summaries [experimental]
-Reuses the [`commit.generation`](@/config.md#commit) command — the same LLM that generates commit messages. Enable with `summary = true` in `[list]` config; requires `--full`. Results are cached until the branch's diff changes.
+Reuses the [`commit.generation`](/config/#commit) command — the same LLM that generates commit messages. Enable with `summary = true` in `[list]` config; requires `--full`. Results are cached until the branch's diff changes.
### Custom columns [experimental]
-Each `[list.custom-columns]` entry in user config adds a column: the key is the header, the template renders each row's cell. Templates read two per-branch namespaces — `{{ vars.* }}`, stored with [`wt config state vars set`](@/config.md#wt-config-state-vars), and `{{ git.branch.* }}`, the branch's own git config under `branch.<name>.*` (a `jira` key you set yourself, or the git-native `description`) — useful for tracking what each of many (often agent-driven) branches is for:
+Each `[list.custom-columns]` entry in user config adds a column: the key is the header, the template renders each row's cell. Templates read two per-branch namespaces — `{{ vars.* }}`, stored with [`wt config state vars set`](/config/#wt-config-state-vars), and `{{ git.branch.* }}`, the branch's own git config under `branch.<name>.*` (a `jira` key you set yourself, or the git-native `description`) — useful for tracking what each of many (often agent-driven) branches is for:
```toml
[list.custom-columns.Ticket]
template = "{{ vars.ticket }}"
```
-A column that renders empty for every row is dropped from the table. Templates, widths, and drop priority: [custom columns config](@/config.md#custom-columns).
+A column that renders empty for every row is dropped from the table. Templates, widths, and drop priority: [custom columns config](/config/#custom-columns).
## Status symbols
@@ -935,14 +935,14 @@ The single highest-priority state describing the branch's relation to the defaul
| `^` | `"is_main"` | The main worktree (the repo's home worktree) |
| `∅` | `"orphan"` | No common ancestor with the default branch |
| `_` | `"empty"` | Same commit as the default branch, working tree clean — safe to remove; row dimmed |
-| `⊂` | `"integrated"` | Content [integrated](@/remove.md#branch-cleanup) into the default branch or merge target via different history; the matching check is in `integration_reason`; row dimmed |
+| `⊂` | `"integrated"` | Content [integrated](/remove/#branch-cleanup) into the default branch or merge target via different history; the matching check is in `integration_reason`; row dimmed |
| `✗` | `"would_conflict"` | Merging into the default branch would conflict (simulated with `git merge-tree`) and the branch isn't already integrated; with `--full`, the check includes uncommitted changes |
| `–` | `"same_commit"` | Same commit as the default branch, but with uncommitted changes |
| `↕` | `"diverged"` | Both ahead of and behind the default branch |
| `↑` | `"ahead"` | Has commits the default branch doesn't |
| `↓` | `"behind"` | Missing commits the default branch has |
-Rows are dimmed when [safe to delete](@/remove.md#branch-cleanup) — `_` (`"empty"`) or `⊂` (`"integrated"`).
+Rows are dimmed when [safe to delete](/remove/#branch-cleanup) — `_` (`"empty"`) or `⊂` (`"integrated"`).
### Remote
@@ -1033,7 +1033,7 @@ Item fields:
| `checks` | CI pipeline: `{status, source, stale}`; collected with `--full`. `status` is `passed`, `running`, or `failed` — null when a conflicts report masks it |
| `dev_server` | `{url, listening}` from the project's `list.url` template |
| `summary` | LLM branch summary; needs `--full`, `[list] summary = true`, and a `[commit.generation]` command |
-| `vars` | Per-branch variables from [`wt config state vars`](@/config.md#wt-config-state-vars) |
+| `vars` | Per-branch variables from [`wt config state vars`](/config/#wt-config-state-vars) |
| `display` | Rendered strings: `state` (schema 1's `main_state` vocabulary), `symbols`, `statusline` (with ANSI colors and OSC 8 hyperlinks), `columns` (custom-column cells keyed by header) |
Schema 1 names map directly: `commit` → `head`, `working_tree` →
@@ -1117,7 +1117,7 @@ $ wt list --format=json --full | jq '.[] | select(.ci.stale) | .branch'
| `summary` | string | LLM-generated branch summary; `--full` only, then absent when not configured or no summary |
| `statusline` | string | Pre-formatted status with colors and links |
| `symbols` | string | Raw status symbols without colors (e.g., `"!?↓"`) |
-| `vars` | object | Per-branch variables from [`wt config state vars`](@/config.md#wt-config-state-vars) (absent when empty) |
+| `vars` | object | Per-branch variables from [`wt config state vars`](/config/#wt-config-state-vars) (absent when empty) |
| `columns` | object | Rendered [custom column](#custom-columns) values keyed by header; empty cells omitted (absent when none configured) |
### Commit object
@@ -1222,7 +1222,7 @@ Missing a field that would be generally useful? Open an issue at https://github.
## See also
-- [`wt switch`](@/switch.md) — Switch worktrees or open interactive picker
+- [`wt switch`](/switch/) — Switch worktrees or open interactive picker
<!-- subdoc: statusline -->"#
)]
// TODO: `args_conflicts_with_subcommands` causes confusing errors for unknown
@@ -1328,7 +1328,7 @@ $ wt remove --reap feature
To avoid killing work the user did not mean to kill, two guards keep `--reap` conservative:
- **Interactive processes are spared.** A process holding a controlling terminal — an interactive shell, or a terminal editor such as `vim` with unsaved buffers — is never reaped. Only detached processes remain candidates.
-- **Discovery is by working directory only.** A process that started in the worktree and later changed directory, or a daemon that reparented to `init`, no longer reports a directory under the worktree and is not found. To reliably reap those, launch them with [`wt step tether`](@/step.md#wt-step-tether), which kills the whole process group when the worktree is removed.
+- **Discovery is by working directory only.** A process that started in the worktree and later changed directory, or a daemon that reparented to `init`, no longer reports a directory under the worktree and is not found. To reliably reap those, launch them with [`wt step tether`](/step/#wt-step-tether), which kills the whole process group when the worktree is removed.
Reaping runs before the worktree directory is touched, so it is independent of foreground/background removal and the `--force` flag. Unix only; on Windows `--reap` is rejected.
@@ -1350,7 +1350,7 @@ Reaping runs before the worktree directory is touched, so it is independent of f
## Hooks
-`pre-remove` hooks run before the worktree is deleted (with access to worktree files). `post-remove` hooks run after removal. See [`wt hook`](@/hook.md) for configuration.
+`pre-remove` hooks run before the worktree is deleted (with access to worktree files). `post-remove` hooks run after removal. See [`wt hook`](/hook/) for configuration.
## Detached HEAD worktrees
@@ -1358,8 +1358,8 @@ Detached worktrees have no branch name. Pass the worktree path instead: `wt remo
## See also
-- [`wt merge`](@/merge.md) — Remove worktree after merging
-- [`wt list`](@/list.md) — View all worktrees
+- [`wt merge`](/merge/) — Remove worktree after merging
+- [`wt list`](/list/) — View all worktrees
"#)]
Remove(RemoveArgs),
@@ -1432,9 +1432,9 @@ $ wt merge --no-commit --no-rebase
1. **Commit** — Pre-commit hooks run, then uncommitted changes are committed. Post-commit hooks run in background. Skipped when squashing (the default) — changes are staged during the squash step instead. With `--no-squash`, this is the only commit step.
2. **Squash** — Combines all commits since target into one (like GitHub's "Squash and merge"). Use `--stage` to control what gets staged: `all` (default), `tracked`, or `none`. Working-tree changes swept into the squash are backed up first to `refs/wt-backup/<branch>`. With `--no-squash`, individual commits are preserved.
-3. **Rebase** — Rebases onto target, skipping when nothing needs replaying ([`wt step rebase`](@/step.md#wt-step-rebase) gives the conditions). A conflict stops the merge with the rebase left open in the worktree, to resolve or abort. With `--no-rebase`, the graph produced by earlier commit/squash steps is preserved and the target must be able to fast-forward to its tip.
-4. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [`wt hook`](@/hook.md).
-5. **Merge** — Fast-forward merge to the target branch ([`wt step push`](@/step.md#wt-step-push)). With `--no-ff`, a merge commit is created instead — semi-linear history after the default rebase, while explicit `--no-rebase` preserves the graph produced by earlier steps before adding the merge commit. Non-fast-forward merges are rejected.
+3. **Rebase** — Rebases onto target, skipping when nothing needs replaying ([`wt step rebase`](/step/#wt-step-rebase) gives the conditions). A conflict stops the merge with the rebase left open in the worktree, to resolve or abort. With `--no-rebase`, the graph produced by earlier commit/squash steps is preserved and the target must be able to fast-forward to its tip.
+4. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [`wt hook`](/hook/).
+5. **Merge** — Fast-forward merge to the target branch ([`wt step push`](/step/#wt-step-push)). With `--no-ff`, a merge commit is created instead — semi-linear history after the default rebase, while explicit `--no-rebase` preserves the graph produced by earlier steps before adding the merge commit. Non-fast-forward merges are rejected.
6. **Pre-remove hooks** — Hooks run before removing worktree. Failures abort.
7. **Cleanup** — Removes the worktree and branch. Use `--no-remove` to keep the worktree. When already on the target branch or in the primary worktree, the worktree is preserved.
8. **Post-remove + post-merge hooks** — Run in background after cleanup.
@@ -1459,9 +1459,9 @@ lint = "cargo clippy"
## See also
-- [`wt step`](@/step.md) — Run individual operations (commit, squash, rebase, push)
-- [`wt remove`](@/remove.md) — Remove worktrees without merging
-- [`wt switch`](@/switch.md) — Navigate to other worktrees
+- [`wt step`](/step/) — Run individual operations (commit, squash, rebase, push)
+- [`wt remove`](/remove/) — Remove worktrees without merging
+- [`wt switch`](/switch/) — Navigate to other worktrees
"#
)]
Merge(MergeArgs),
@@ -1508,8 +1508,8 @@ $ wt step push
## Operations
-- [`commit`](#wt-step-commit) — Stage and commit with [LLM-generated message](@/llm-commits.md)
-- [`squash`](#wt-step-squash) — Squash all branch commits into one with [LLM-generated message](@/llm-commits.md)
+- [`commit`](#wt-step-commit) — Stage and commit with [LLM-generated message](/llm-commits/)
+- [`squash`](#wt-step-squash) — Squash all branch commits into one with [LLM-generated message](/llm-commits/)
- [`rebase`](#wt-step-rebase) — Rebase onto target branch
- [`push`](#wt-step-push) — Fast-forward target to current branch
- [`diff`](#wt-step-diff) — Show all changes since branching (committed, staged, unstaged, untracked)
@@ -1520,13 +1520,13 @@ $ wt step push
- [`prune`](#wt-step-prune) — Remove worktrees and branches merged into the default branch
- [`relocate`](#wt-step-relocate) — [experimental] Move worktrees to expected paths
- [`tether`](#wt-step-tether) — [experimental] Run a command; kill its whole process tree when its worktree is removed
-- [`<alias>`](@/extending.md#aliases) — Run a configured command alias
+- [`<alias>`](/extending/#aliases) — Run a configured command alias
## See also
-- [`wt merge`](@/merge.md) — Runs commit → squash → rebase → hooks → push → cleanup automatically
-- [`wt hook`](@/hook.md) — Run configured hooks
-- [Aliases](@/extending.md#aliases) — Custom command templates run as `wt <name>`
+- [`wt merge`](/merge/) — Runs commit → squash → rebase → hooks → push → cleanup automatically
+- [`wt hook`](/hook/) — Run configured hooks
+- [Aliases](/extending/#aliases) — Custom command templates run as `wt <name>`
<!-- subdoc: commit -->
<!-- subdoc: squash -->
<!-- subdoc: rebase -->
@@ -1560,7 +1560,7 @@ $ wt step push
| **merge** | `pre-merge` | `post-merge` |
| **remove** | `pre-remove` | `post-remove` |
-`pre-*` hooks block — failure aborts the operation. `post-*` hooks run in the background with output logged (use [`wt config state logs`](@/config.md#wt-config-state-logs) to find and manage log files). Use `-v` to see the template variables for background hooks; `wt hook <type> --dry-run` previews the commands.
+`pre-*` hooks block — failure aborts the operation. `post-*` hooks run in the background with output logged (use [`wt config state logs`](/config/#wt-config-state-logs) to find and manage log files). Use `-v` to see the template variables for background hooks; `wt hook <type> --dry-run` previews the commands.
The most common creation hook is `post-start` — it runs background tasks (dev servers, file copying, builds) without blocking worktree creation. Prefer `post-start` over `pre-start` unless a later step needs the work completed first.
@@ -1577,7 +1577,7 @@ The most common creation hook is `post-start` — it runs background tasks (dev
| `pre-remove` | Cleanup before worktree deletion: saving test artifacts, backing up state. Runs in the worktree being removed |
| `post-remove` | Stopping dev servers, removing containers, notifying external systems. Template variables reference the removed worktree |
-During `wt merge`, hooks run in this order: pre-commit → post-commit → pre-merge → pre-remove → post-remove + post-merge. See [`wt merge`](@/merge.md#pipeline) for the complete pipeline.
+During `wt merge`, hooks run in this order: pre-commit → post-commit → pre-merge → pre-remove → post-remove + post-merge. See [`wt merge`](/merge/#pipeline) for the complete pipeline.
# Security
@@ -1639,7 +1639,7 @@ server = "npm run dev"
Here `install` runs first, then `build` and `server` run together.
-Templates are syntax-checked before the pipeline starts and rendered as each step runs, so a step can store [per-branch vars](@/config.md#wt-config-state-vars) that later steps read via `{{ vars.<key> }}`. Because an earlier step can still change those values, a preview leaves them alone: `wt hook <type> --dry-run` and `wt hook show --expanded` render `{{ vars.<key> }}` as itself while every other variable expands.
+Templates are syntax-checked before the pipeline starts and rendered as each step runs, so a step can store [per-branch vars](/config/#wt-config-state-vars) that later steps read via `{{ vars.<key> }}`. Because an earlier step can still change those values, a preview leaves them alone: `wt hook <type> --dry-run` and `wt hook show --expanded` render `{{ vars.<key> }}` as itself while every other variable expands.
Most hooks don't need `[[hook]]` blocks. Reach for them when there's a dependency chain — typically setup that must complete before later steps, like installing dependencies before running a build and dev server concurrently.
@@ -1648,7 +1648,7 @@ Most hooks don't need `[[hook]]` blocks. Reach for them when there's a dependenc
| Aspect | Project hooks | User hooks |
|--------|--------------|------------|
| Location | `.config/wt.toml` | `~/.config/worktrunk/config.toml` |
-| Scope | Single repository | All repositories (or [per-project](@/config.md#user-project-specific-settings)) |
+| Scope | Single repository | All repositories (or [per-project](/config/#user-project-specific-settings)) |
| Approval | Required | Not required |
| Execution order | After user hooks | First |
@@ -1684,7 +1684,7 @@ Hooks can use template variables that expand at runtime:
| | `{{ hook_type }}` | Hook type being run (e.g. `pre-start`, `pre-merge`) |
| | `{{ hook_name }}` | Hook command name (if named) |
| | `{{ args }}` | Tokens forwarded from the CLI — see [Running Hooks Manually](#running-hooks-manually) |
-| user | `{{ vars.<key> }}` | Per-branch variables from [`wt config state vars`](@/config.md#wt-config-state-vars) |
+| user | `{{ vars.<key> }}` | Per-branch variables from [`wt config state vars`](/config/#wt-config-state-vars) |
The `repo` variables (`repo`, `repo_path`, `owner`, `remote_repo`, `primary_worktree_path`, `default_branch`, `remote`, `remote_url`) are constant across the whole repository — `default_branch` is the same in every worktree. The `active` variables (`branch`, `worktree_path`, `worktree_name`, `commit`, `short_commit`, `upstream`) vary per worktree.
@@ -1814,7 +1814,7 @@ if ctx['branch'].startswith('feature/') and 'backend' in ctx['repo']:
## Copying untracked files
-One specific command worth calling out: [`wt step copy-ignored`](@/step.md#wt-step-copy-ignored). Git worktrees share the repository but not untracked files, and this copies gitignored files between worktrees:
+One specific command worth calling out: [`wt step copy-ignored`](/step/#wt-step-copy-ignored). Git worktrees share the repository but not untracked files, and this copies gitignored files between worktrees:
```toml
[post-start]
@@ -1875,18 +1875,18 @@ The long form `--var KEY=VALUE` is deprecated but still supported. It force-bind
# Recipes
-- [Eliminate cold starts](@/tips-patterns.md#eliminate-cold-starts): `wt step copy-ignored` in `post-start` shares build caches and dependencies; use a `[[post-start]]` pipeline when a later hook depends on the copy
-- [Dev server per worktree](@/tips-patterns.md#dev-server-per-worktree): `wt step tether` in `post-start` runs the dev server and kills its whole process group when the worktree is removed, with optional subdomain routing
-- [Database per worktree](@/tips-patterns.md#database-per-worktree): a `post-start` pipeline stores container name, port, and connection string as [per-branch vars](@/config.md#wt-config-state-vars) that later hooks reference
-- [Progressive validation](@/tips-patterns.md#progressive-validation): quick lint/typecheck in `pre-commit`, expensive tests and builds in `pre-merge`
-- [Target-specific hooks](@/tips-patterns.md#target-specific-hooks): branch on `{{ target }}` in `post-merge` for per-environment deploys
+- [Eliminate cold starts](/tips-patterns/#eliminate-cold-starts): `wt step copy-ignored` in `post-start` shares build caches and dependencies; use a `[[post-start]]` pipeline when a later hook depends on the copy
+- [Dev server per worktree](/tips-patterns/#dev-server-per-worktree): `wt step tether` in `post-start` runs the dev server and kills its whole process group when the worktree is removed, with optional subdomain routing
+- [Database per worktree](/tips-patterns/#database-per-worktree): a `post-start` pipeline stores container name, port, and connection string as [per-branch vars](/config/#wt-config-state-vars) that later hooks reference
+- [Progressive validation](/tips-patterns/#progressive-validation): quick lint/typecheck in `pre-commit`, expensive tests and builds in `pre-merge`
+- [Target-specific hooks](/tips-patterns/#target-specific-hooks): branch on `{{ target }}` in `post-merge` for per-environment deploys
## See also
-- [`wt merge`](@/merge.md) — Runs hooks automatically during merge
-- [`wt switch`](@/switch.md) — Runs pre-start/post-start hooks on `--create`
-- [`wt config approvals`](@/config.md#wt-config-approvals) — Manage approvals
-- [`wt config state logs`](@/config.md#wt-config-state-logs) — Access background hook logs
+- [`wt merge`](/merge/) — Runs hooks automatically during merge
+- [`wt switch`](/switch/) — Runs pre-start/post-start hooks on `--create`
+- [`wt config approvals`](/config/#wt-config-approvals) — Manage approvals
+- [`wt config state logs`](/config/#wt-config-state-logs) — Access background hook logs
"#
)]
Hook {
@@ -1978,7 +1978,7 @@ Controls where new worktrees are created.
- `{{ branch | sanitize_db }}` — database-safe: lowercase, underscores, hash suffix (e.g., `feature_auth_x7k`)
- `{{ branch | codename(2) }}` — deterministic friendly name from a ~1.26M-combo pool (e.g., `malleable-opah`)
-This is a smaller set than [the variables hooks and aliases get](@/hook.md#template-variables).
+This is a smaller set than [the variables hooks and aliases get](/hook/#template-variables).
**Examples** for repo at `~/code/myproject`, branch `feature/auth`:
@@ -2065,7 +2065,7 @@ command = "llm -m claude-haiku-4.5"
command = "aichat -m claude:claude-haiku-4.5"
```
-See [LLM commits docs](@/llm-commits.md) for setup and [Custom prompt templates](#custom-prompt-templates) for template customization.
+See [LLM commits docs](/llm-commits/) for setup and [Custom prompt templates](#custom-prompt-templates) for template customization.
## Command config
@@ -2091,7 +2091,7 @@ timeout-ms = 0 # Wall-clock budget for the entire collect phase; 0 disables
`columns` selects and orders the columns the `wt list` table and the `wt switch`
picker render; `--format json` ignores it and always emits every field. Omit it
for the default set. It is meant to drive a per-invocation
-[alias](@/extending.md#aliases) (`wt --config-set 'list.columns=[…]' list`),
+[alias](/extending/#aliases) (`wt --config-set 'list.columns=[…]' list`),
giving a named view without disturbing the default `wt list`. A static setting
works but pins one layout over a table that otherwise adapts to `--full` and
terminal width.
@@ -2143,7 +2143,7 @@ Templates may reference `{{ branch }}`, `{{ worktree_path }}`,
namespaces:
- `{{ vars.* }}` — values stored with
- [`wt config state vars set`](@/config.md#wt-config-state-vars).
+ [`wt config state vars set`](/config/#wt-config-state-vars).
- `{{ git.branch.* }}` — the branch's own git config under `branch.<name>.*`,
read straight from `git config` (e.g. `{{ git.branch.jira }}` for a key you
set yourself, or the git-native `description`). Git lowercases config variable
@@ -2214,11 +2214,11 @@ pager = "delta --paging=never" # Example: override git's core.pager for diff p
exclude = [] # Additional excludes (e.g., [".cache/", ".turbo/"])
```
-Built-in excludes (VCS metadata and tool-state directories) always apply; [the `wt step copy-ignored` docs](@/step.md#wt-step-copy-ignored) list them. User config and project config exclusions are combined.
+Built-in excludes (VCS metadata and tool-state directories) always apply; [the `wt step copy-ignored` docs](/step/#wt-step-copy-ignored) list them. User config and project config exclusions are combined.
### Aliases
-Command templates that run as `wt <name>`. See the [Extending Worktrunk guide](@/extending.md#aliases) for usage and flags.
+Command templates that run as `wt <name>`. See the [Extending Worktrunk guide](/extending/#aliases) for usage and flags.
```toml
[aliases]
@@ -2226,15 +2226,15 @@ greet = "echo Hello from {{ branch }}"
url = "echo http://localhost:{{ branch | hash_port }}"
```
-Aliases defined here apply to all projects. For project-specific aliases, use the [project config](@/config.md#project-configuration) `[aliases]` section instead.
+Aliases defined here apply to all projects. For project-specific aliases, use the [project config](/config/#project-configuration) `[aliases]` section instead.
### User project-specific settings
-User config can include a `[projects]` table for project-specific settings — worktree layout, setting overrides, anything else — separate from the [project config](@/config.md#project-configuration) shared with teammates.
+User config can include a `[projects]` table for project-specific settings — worktree layout, setting overrides, anything else — separate from the [project config](/config/#project-configuration) shared with teammates.
Entries are keyed by project identifier — `<host>/<owner>/<repo>` derived from the primary remote URL (no `.git` suffix), or the canonical repo path when there is no remote. Run `wt config show` inside the repo to see the identifier for the current project; it appears in the `PROJECT CONFIG` section as `Identifier: …`.
-Scalar values (like `worktree-path`) replace the global value; everything else (hooks, aliases, etc.) appends, global first. See [how the layers rank](@/config.md#precedence).
+Scalar values (like `worktree-path`) replace the global value; everything else (hooks, aliases, etc.) appends, global first. See [how the layers rank](/config/#precedence).
```toml
[projects."github.com/user/repo"]
@@ -2267,7 +2267,7 @@ Every matching entry applies, least- to most-specific, following the rule above:
#### Forge platform and hostname
-`forge` names the forge for the matched repositories — the user-level counterpart of the project config's [forge platform](@/config.md#forge-platform) block, for a self-hosted host whose name carries no `github`, `gitlab`, or `gitea` for detection to read.
+`forge` names the forge for the matched repositories — the user-level counterpart of the project config's [forge platform](/config/#forge-platform) block, for a self-hosted host whose name carries no `github`, `gitlab`, or `gitea` for detection to read.
```toml
[projects."git.company.example/*"]
@@ -2277,7 +2277,7 @@ forge.hostname = "api.git.company.example" # API host, when the remote's own h
Both fields describe the host rather than the repository, which is why a pattern keyed to a hostname suits them, and why an SSH alias resolved through `~/.ssh/config` — where the name in the remote URL is local to one machine — belongs here rather than in a repository's committed config. A repository's own `[forge]` block still wins over any entry here, field by field: a repository that sets only `platform` still takes a matching entry's `hostname`.
-Hooks support all three [hook forms](@/hook.md#hook-forms). A table runs multiple commands concurrently; an array-of-tables pipeline runs steps in sequence. The dotted-key examples below are equivalent to the table forms — TOML treats `projects."github.com/user/repo".post-start.server = "..."` and a `[projects."github.com/user/repo".post-start]` table the same way:
+Hooks support all three [hook forms](/hook/#hook-forms). A table runs multiple commands concurrently; an array-of-tables pipeline runs steps in sequence. The dotted-key examples below are equivalent to the table forms — TOML treats `projects."github.com/user/repo".post-start.server = "..."` and a `[projects."github.com/user/repo".post-start]` table the same way:
```toml
# Single command
@@ -2309,7 +2309,7 @@ Available variables:
- `{{ git_diff }}`, `{{ git_diff_stat }}` — diff content
- `{{ branch }}`, `{{ repo }}` — context
- `{{ recent_commits }}` — recent commit messages
-- `{{ user_guidance }}`, `{{ project_guidance }}` — rendered append fragments (see [Appending to the prompt](@/config.md#appending-to-the-prompt))
+- `{{ user_guidance }}`, `{{ project_guidance }}` — rendered append fragments (see [Appending to the prompt](/config/#appending-to-the-prompt))
Default template:
@@ -2420,11 +2420,11 @@ template-append = """
"""
```
-How the fragment renders, and the project-config counterpart: [the LLM commits guide](@/llm-commits.md#appending-to-the-prompt).
+How the fragment renders, and the project-config counterpart: [the LLM commits guide](/llm-commits/#appending-to-the-prompt).
## Hooks
-See [`wt hook`](@/hook.md) for hook types, execution order, template variables, and examples. User hooks apply to all projects; [project hooks](@/config.md#project-configuration) apply only to that repository.
+See [`wt hook`](/hook/) for hook types, execution order, template variables, and examples. User hooks apply to all projects; [project hooks](/config/#project-configuration) apply only to that repository.
<!-- USER_CONFIG_END -->
<!-- PROJECT_CONFIG_START -->
# Project Configuration
@@ -2435,7 +2435,7 @@ To create a starter file with commented-out examples, run `wt config create --pr
## Hooks
-Project hooks apply to this repository only. See [`wt hook`](@/hook.md) for hook types, execution order, and examples.
+Project hooks apply to this repository only. See [`wt hook`](/hook/) for hook types, execution order, and examples.
```toml
pre-start = "npm ci"
@@ -2462,7 +2462,7 @@ platform = "github" # or "gitlab", "gitea" (experimental), "azure-devops" (expe
hostname = "github.example.com" # Example: API host (GHE / self-hosted GitLab)
```
-When many repositories share one self-hosted host, name it once in user config with a [pattern-keyed `[projects]` entry](@/config.md#user-project-specific-settings) instead of repeating this block in each repo. A repository's own `[forge]` still wins, field by field.
+When many repositories share one self-hosted host, name it once in user config with a [pattern-keyed `[projects]` entry](/config/#user-project-specific-settings) instead of repeating this block in each repo. A repository's own `[forge]` still wins, field by field.
## Commit-message append [experimental]
@@ -2476,7 +2476,7 @@ template-append = """
"""
```
-The first time the fragment is used (and whenever it changes), `wt` prompts the user to approve it — the same one-shot gate as project-defined hooks. Only `template-append` is honored from the project file; the LLM command and the main prompt template stay in [user config](@/config.md), since they describe per-developer environment (which CLI is installed, which agent the developer prefers). How the fragment renders: [the LLM commits guide](@/llm-commits.md#appending-to-the-prompt).
+The first time the fragment is used (and whenever it changes), `wt` prompts the user to approve it — the same one-shot gate as project-defined hooks. Only `template-append` is honored from the project file; the LLM command and the main prompt template stay in [user config](/config/), since they describe per-developer environment (which CLI is installed, which agent the developer prefers). How the fragment renders: [the LLM commits guide](/llm-commits/#appending-to-the-prompt).
## Copy-ignored excludes
@@ -2487,11 +2487,11 @@ Additional excludes for `wt step copy-ignored`:
exclude = [".cache/", ".turbo/"]
```
-Built-in excludes (VCS metadata and tool-state directories) always apply; [the `wt step copy-ignored` docs](@/step.md#wt-step-copy-ignored) list them. User config and project config exclusions are combined.
+Built-in excludes (VCS metadata and tool-state directories) always apply; [the `wt step copy-ignored` docs](/step/#wt-step-copy-ignored) list them. User config and project config exclusions are combined.
## Aliases
-Command templates that run as `wt <name>`. See the [Extending Worktrunk guide](@/extending.md#aliases) for usage and flags.
+Command templates that run as `wt <name>`. See the [Extending Worktrunk guide](/extending/#aliases) for usage and flags.
```toml
[aliases]
@@ -2499,7 +2499,7 @@ deploy = "make deploy BRANCH={{ branch }}"
url = "echo http://localhost:{{ branch | hash_port }}"
```
-Aliases defined here are shared with teammates. For personal aliases, use the [user config](@/config.md#aliases) `[aliases]` section instead.
+Aliases defined here are shared with teammates. For personal aliases, use the [user config](/config/#aliases) `[aliases]` section instead.
<!-- PROJECT_CONFIG_END -->
# Shell Integration
@@ -2577,7 +2577,7 @@ This composes with aliases — an alias body can invoke `wt --config-set … <co
## Precedence
-Sources closer to the invocation rank higher (user config above system config), and within a config file a [project entry](@/config.md#user-project-specific-settings) outranks the global key of the same name. So `worktree-path` comes from the first of these that sets it:
+Sources closer to the invocation rank higher (user config above system config), and within a config file a [project entry](/config/#user-project-specific-settings) outranks the global key of the same name. So `worktree-path` comes from the first of these that sets it:
1. `--config-set 'worktree-path = …'`
2. `WORKTRUNK_WORKTREE_PATH`
diff --git a/src/cli/step.rs b/src/cli/step.rs
index 9ffb75752..d8d1aea6c 100644
--- a/src/cli/step.rs
+++ b/src/cli/step.rs
@@ -69,7 +69,7 @@ pub struct SquashArgs {
pub enum StepCommand {
/// Stage and commit with LLM-generated message
#[command(
- after_long_help = r#"See [LLM-generated commit messages](@/llm-commits.md) for configuration and prompt customization.
+ after_long_help = r#"See [LLM-generated commit messages](/llm-commits/) for configuration and prompt customization.
## Options
@@ -111,7 +111,7 @@ Three sections are printed: the rendered prompt, the shell command that would in
///
/// Stages changes and generates message with LLM.
#[command(
- after_long_help = r#"See [LLM-generated commit messages](@/llm-commits.md) for configuration and prompt customization.
+ after_long_help = r#"See [LLM-generated commit messages](/llm-commits/) for configuration and prompt customization.
## Options
@@ -175,7 +175,7 @@ The first matching row wins:
A branch that merged the target into itself still rebases: the target is its ancestor, but the merge commit in between keeps the first row from applying.
-When the target's local ref lags its upstream, the rows are measured against that upstream, which the result then names in place of the argument. [`wt merge`](@/merge.md) covers why.
+When the target's local ref lags its upstream, the rows are measured against that upstream, which the result then names in place of the argument. [`wt merge`](/merge/) covers why.
## Conflicts
@@ -432,7 +432,7 @@ The `.worktreeinclude` pattern is shared with [Claude Code on desktop](https://c
///
/// Prints the result to stdout for use in scripts and shell substitutions.
#[command(
- after_long_help = r#"All [hook template variables and filters](@/hook.md#template-variables) are available.
+ after_long_help = r#"All [hook template variables and filters](/hook/#template-variables) are available.
## Examples
@@ -514,13 +514,13 @@ $ wt step for-each -- sh -c 'echo $HOME && git pull'
## Template variables
-Variables substitute into each argv element before exec. See [`wt hook` template variables](@/hook.md#template-variables) for the complete list and filters.
+Variables substitute into each argv element before exec. See [`wt hook` template variables](/hook/#template-variables) for the complete list and filters.
```console
$ wt step for-each -- echo 'Branch: {{ branch }}'
```
-Each element is expanded fresh in every worktree, so `{{ branch }}` is that worktree's branch. An alias wrapping for-each renders templates earlier, in the invoking worktree; [deferring expansion in an alias](@/extending.md#deferring-expansion-to-a-nested-wt-command) shows how to keep a variable per-worktree.
+Each element is expanded fresh in every worktree, so `{{ branch }}` is that worktree's branch. An alias wrapping for-each renders templates earlier, in the invoking worktree; [deferring expansion in an alias](/extending/#deferring-expansion-to-a-nested-wt-command) shows how to keep a variable per-worktree.
## Examples
@@ -620,7 +620,7 @@ $ wt step prune --min-age=2d # skip worktrees younger than 2 days
## JSON output
-`--format=json` prints one object per candidate to stdout. The two modes report different things, and name their fields accordingly: a live run reports `branch_outcome`, the executed outcome, using the vocabulary [`wt remove`](@/remove.md#json-output) documents; `--dry-run` reports `branch_deleted`, its prediction of whether the removal would take the branch, since it runs nothing to have an outcome. A dry run also carries `reason` and `target` (why the candidate qualifies, and what it was measured against).
+`--format=json` prints one object per candidate to stdout. The two modes report different things, and name their fields accordingly: a live run reports `branch_outcome`, the executed outcome, using the vocabulary [`wt remove`](/remove/#json-output) documents; `--dry-run` reports `branch_deleted`, its prediction of whether the removal would take the branch, since it runs nothing to have an outcome. A dry run also carries `reason` and `target` (why the candidate qualifies, and what it was measured against).
## Examples
diff --git a/src/commands/CLAUDE.md b/src/commands/CLAUDE.md
index 8de19f6d7..b6d62fc14 100644
--- a/src/commands/CLAUDE.md
+++ b/src/commands/CLAUDE.md
@@ -82,7 +82,7 @@ wt --source -C /path/to/repo switch
1. Add the subcommand to the `Cli` enum in `src/cli/mod.rs`.
2. Implement it in `src/commands/` (e.g. `src/commands/mycommand.rs`).
-3. Add an `after_long_help` attribute — it is the source of truth for `docs/content/{command}.md`.
+3. Add an `after_long_help` attribute — it is the source of truth for `docs/src/content/docs/{command}.md`.
4. Run `cargo test --test integration test_docs_are_in_sync`. Editing help text also changes the rendered `--help` snapshots, which that test leaves untouched — regenerate them with `cargo insta test --accept --test integration -- test_help` (or run the pre-merge hook, which does both).
All stdout goes through anstream: `worktrunk::styling::println` for anything a person reads, and `crate::output::print_json` for a `--format=json` answer — every surface but `wt switch --format=json`, which emits its single result as one compact line. anstream's macros drop a `BrokenPipe` write error where std's panic, so `wt … | head -3` never exits 101.
@@ -190,7 +190,7 @@ No `long_about` or `after_long_help` needed when the short description is self-e
## Command Documentation Guidelines
-When writing or updating command docs in `docs/content/`, follow this structure and these principles. Load the `documentation` skill for additional guidance.
+When writing or updating command docs in `docs/src/content/docs/`, follow this structure and these principles. Load the `documentation` skill for additional guidance.
### Structure
diff --git a/src/commands/list/json_output.rs b/src/commands/list/json_output.rs
index 0163cccb4..b4cce7eb0 100644
--- a/src/commands/list/json_output.rs
+++ b/src/commands/list/json_output.rs
@@ -496,7 +496,7 @@ impl JsonCi {
// they're deliberately not surfaced here — `wt list --json` stays
// scoped to CI/review status. Add them (with
// `skip_serializing_if = "Option::is_none"` plus a row in the
- // docs/content/list.md ci-object table) if a JSON consumer needs them.
+ // docs/src/content/docs/list.md ci-object table) if a JSON consumer needs them.
}
}
}
diff --git a/src/commands/list/json_v2.rs b/src/commands/list/json_v2.rs
index 54e626957..dd004dbb0 100644
--- a/src/commands/list/json_v2.rs
+++ b/src/commands/list/json_v2.rs
@@ -103,7 +103,7 @@ pub struct JsonEnvelope {
/// The published JSON Schema for [`JsonEnvelope`], as a JSON value.
///
/// `wt list --print-schema` prints this and `test_docs_are_in_sync` commits it
-/// to `docs/static/schema/list-v2.json`; it lives here so the document and the
+/// to `docs/public/schema/list-v2.json`; it lives here so the document and the
/// types it describes stay in one place, and so `test_schema_accepts_envelopes`
/// checks the same document that ships.
///
@@ -116,8 +116,8 @@ pub fn schema_document() -> serde_json::Value {
let mut value = serde_json::to_value(&schema).expect("schema serializes");
let object = value.as_object_mut().expect("schema is an object");
- // Zola serves docs/static/ at the site root, so this is where the
- // committed docs/static/schema/list-v2.json is reachable.
+ // Astro serves docs/public/ at the site root, so this is where the
+ // committed docs/public/schema/list-v2.json is reachable.
object.insert(
"$id".to_string(),
"https://worktrunk.dev/schema/list-v2.json".into(),
diff --git a/src/commands/step/tether.rs b/src/commands/step/tether.rs
index 30ca19088..7d76d854c 100644
--- a/src/commands/step/tether.rs
+++ b/src/commands/step/tether.rs
@@ -42,7 +42,7 @@ const POLL_INTERVAL: Duration = Duration::from_millis(250);
///
/// `working_dir` is the global `-C <path>` flag — applied as the child's
/// current directory so the tethered command can run from a subdirectory (a
-/// dev server in `frontend/`, zola in `docs/`), the same way `-C` works for
+/// dev server in `frontend/`, Astro in `docs/`), the same way `-C` works for
/// custom subcommands. The reaper still watches the captured cwd (the worktree
/// root), not `working_dir`, so a relative `-C docs` server is still torn down
/// when the worktree is removed.
diff --git a/src/docs.rs b/src/docs.rs
index c09fd38de..dbbd425b2 100644
--- a/src/docs.rs
+++ b/src/docs.rs
@@ -1,11 +1,11 @@
-//! Documentation text transformations.
+//! Shared documentation markers.
//!
-//! Converts `$ `‐prefixed `console` code blocks into Zola `{% terminal() %}`
-//! shortcodes. Used by both the `--help-page` generator (CLI source → web docs)
-//! and the doc sync test (hand-written docs → web docs).
+//! The help-page generator and documentation sync tests both use these
+//! constants. Keeping the producer and consumer on one definition makes
+//! marker drift a compile-time failure.
/// Empty span; the displayed "EXPERIMENTAL" text comes from the CSS `::after`
-/// rule so the anchor-link slug generated by Zola ignores it.
+/// rule so generated anchor slugs ignore it.
///
/// Lives here (rather than in `src/help.rs`) so the producer (the `--help-page`
/// post-processor that emits this in place of `[experimental]`) and the
@@ -36,184 +36,3 @@ pub const MARKER_OPEN_PREFIX: &str = "<!-- ⚠️ AUTO-GENERATED from ";
/// `test_no_nested_auto_generated_markers` enforces the no-nesting precondition
/// that makes that pairing safe.
pub const MARKER_CLOSE: &str = "<!-- END AUTO-GENERATED -->";
-
-/// Convert `$ `‐prefixed console blocks into `{% terminal() %}` shortcodes.
-///
-/// All shell commands in `console` blocks use `$ ` prefix. This function detects
-/// them and emits the appropriate shortcode form:
-///
-/// - Commands without output: `{{ terminal(cmd="...") }}` (Syntect highlighting)
-/// - Commands with output: `{% terminal(cmd="...") %}output{% end %}`
-/// - Multiple commands/comments: `|||`‐delimited in `cmd` parameter
-///
-/// `{{ }}` in commands (e.g., Jinja2 template expressions) are replaced with
-/// placeholders so Tera doesn't interpret them. The terminal shortcode template
-/// replaces them back before Syntect highlighting. Double quotes are also
-/// replaced with a placeholder since they'd close the `cmd="..."` parameter
-/// (Tera has no backslash-escape mechanism for string literals).
-///
-/// Blocks without `$ ` are left unchanged for the `console` → `bash` replacement.
-pub fn convert_dollar_console_to_terminal(text: &str) -> String {
- let mut result = String::with_capacity(text.len());
- let mut lines = text.lines().peekable();
-
- while let Some(line) = lines.next() {
- if line.trim_start() == "```console" {
- // Collect the block, then decide whether to convert
- let mut block_lines = Vec::new();
- for content_line in lines.by_ref() {
- let stripped = content_line.trim_start();
- if stripped.starts_with("```")
- && (stripped.len() == 3 || !stripped.as_bytes()[3].is_ascii_alphabetic())
- {
- break;
- }
- block_lines.push(content_line);
- }
-
- // Only convert if the block contains $ commands
- let commands: Vec<_> = block_lines
- .iter()
- .filter_map(|l| l.strip_prefix("$ "))
- .collect();
-
- if commands.is_empty() {
- // No $ lines — emit unchanged as console block
- result.push_str(line);
- result.push('\n');
- for bl in &block_lines {
- result.push_str(bl);
- result.push('\n');
- }
- result.push_str("```\n");
- continue;
- }
-
- // Classify each line into the cmd= stream (rendered with prompt
- // prefix and Syntect highlighting, joined by `|||`) or the output
- // body. `$ <cmd>` lines feed cmd= verbatim (with `"` and `{{`/`}}`
- // escaped past Tera); `#` lines feed cmd= so the template styles
- // them as bash-comment section headers (used by the `wt list` jq
- // recipes block). Blank lines belong to whichever side has content
- // — to cmd= when the block is command-only (visual spacing between
- // recipe groups), to body otherwise.
- let has_output = block_lines
- .iter()
- .any(|l| !l.is_empty() && !l.starts_with("$ ") && !l.starts_with('#'));
- let mut cmd_value: Vec<String> = Vec::new();
- let mut body_lines: Vec<&&str> = Vec::new();
- for line in &block_lines {
- if let Some(cmd) = line.strip_prefix("$ ") {
- cmd_value.push(
- cmd.replace('"', "__WT_QUOT__")
- .replace("{{", "__WT_OPEN__")
- .replace("}}", "__WT_CLOSE__"),
- );
- } else if line.starts_with('#') || (line.is_empty() && !has_output) {
- cmd_value.push((*line).to_string());
- } else {
- body_lines.push(line);
- }
- }
-
- let cmd_str = cmd_value.join("|||");
- if body_lines.is_empty() {
- result.push_str(&format!("{{{{ terminal(cmd=\"{cmd_str}\") }}}}\n"));
- } else {
- result.push_str(&format!("{{% terminal(cmd=\"{cmd_str}\") %}}\n"));
- for bl in &body_lines {
- result.push_str(bl);
- result.push('\n');
- }
- result.push_str("{% end %}\n");
- }
- continue;
- }
- result.push_str(line);
- result.push('\n');
- }
-
- // .lines() strips the trailing newline; match original
- if !text.ends_with('\n') {
- result.pop();
- }
- result
-}
-
-#[cfg(test)]
-mod tests {
- use super::*;
- use insta::assert_snapshot;
-
- #[test]
- fn test_convert_dollar_console_to_terminal() {
- // Command+output with {{ }} → cmd parameter with placeholders
- assert_snapshot!(convert_dollar_console_to_terminal(
- "```console\n$ wt step eval '{{ branch | hash_port }}'\n16066\n```"
- ), @r#"
- {% terminal(cmd="wt step eval '__WT_OPEN__ branch | hash_port __WT_CLOSE__'") %}
- 16066
- {% end %}
- "#);
-
- // Command only (no $) → unchanged
- assert_snapshot!(convert_dollar_console_to_terminal(
- "```console\nwt step commit --stage=tracked\n```"
- ), @r"
- ```console
- wt step commit --stage=tracked
- ```
- ");
-
- // Multi-line output, no {{ }} → cmd parameter
- assert_snapshot!(convert_dollar_console_to_terminal(
- "```console\n$ wt step eval -v 'test'\n○ Available template variables\n branch = feature/auth\ntest\n```"
- ), @r#"
- {% terminal(cmd="wt step eval -v 'test'") %}
- ○ Available template variables
- branch = feature/auth
- test
- {% end %}
- "#);
-
- // Single command with output, no {{ }} → cmd parameter
- assert_snapshot!(convert_dollar_console_to_terminal(
- "```console\n$ echo 'PORT=8080' > .env\noutput\n```"
- ), @r#"
- {% terminal(cmd="echo 'PORT=8080' > .env") %}
- output
- {% end %}
- "#);
-
- // Command only (single, no output) → self-closing shortcode
- assert_snapshot!(convert_dollar_console_to_terminal(
- "```console\n$ wt remove\n```"
- ), @r#"{{ terminal(cmd="wt remove") }}
- "#);
-
- // Multiple commands → |||‐delimited cmd with Syntect highlighting
- assert_snapshot!(convert_dollar_console_to_terminal(
- "```console\n$ wt step push\n$ wt step push develop\n```"
- ), @r#"{{ terminal(cmd="wt step push|||wt step push develop") }}
- "#);
-
- // Comment before $ commands → included in cmd, Syntect highlights as comment
- assert_snapshot!(convert_dollar_console_to_terminal(
- "```console\n# Recent commands\n$ tail -5 log.jsonl | jq .\n\n# Failed\n$ jq 'select(.exit != 0)' log.jsonl\n```"
- ), @r##"{{ terminal(cmd="# Recent commands|||tail -5 log.jsonl | jq .||||||# Failed|||jq 'select(.exit != 0)' log.jsonl") }}
- "##);
-
- // Blank line in mixed-mode block (cmd + output) stays in body, doesn't
- // leak into cmd= as a stray `$ ` prompt.
- assert_snapshot!(convert_dollar_console_to_terminal(
- "```console\n$ wt list\n Branch Status\n@ main\n\n○ Showing 1 worktree\n```"
- ), @r#"
- {% terminal(cmd="wt list") %}
- Branch Status
- @ main
-
- ○ Showing 1 worktree
- {% end %}
- "#);
- }
-}
diff --git a/src/help.rs b/src/help.rs
index 8bdb0705d..c7d09b487 100644
--- a/src/help.rs
+++ b/src/help.rs
@@ -7,7 +7,8 @@
//!
//! # Web docs generation (`--help-page`)
//!
-//! Each command page flows through several transforms before becoming web docs:
+//! Each command page flows through a small set of transforms before becoming
+//! portable Markdown:
//!
//! ```text
//! cli.rs (source of truth)
@@ -18,32 +19,27 @@
//! combine_command_docs() — assembles "definition. subtitle\n\n<after_long_help>"
//! │
//! ▼
-//! convert_dollar_console_to_terminal() — ```console with $ → {% terminal() %} shortcode
-//! console→bash replacement — remaining ```console → ```bash
-//! │
-//! ▼
//! post_process_for_html() — text replacements on after_long_help markdown:
//! │ [experimental] → badge <span>
//! │ `#` green → colored <span>
//! │ plain URLs → markdown links
//! ▼
-//! --help-page stdout — markdown with embedded HTML spans
+//! --help-page stdout — Markdown with small semantic HTML spans
//! │
//! ▼ (readme_sync.rs test captures and writes to docs/)
//! │
-//! convert_command_reference_to_html() — backtick-fenced --help blocks → {% terminal() %}
-//! expand_command_placeholders() — ```bash wt list``` → snapshot terminal blocks
+//! expand_command_placeholders() — command placeholders → snapshot console blocks
//! │
//! ▼
-//! docs/content/{command}.md — final markdown consumed by Zola
+//! docs/src/content/docs/{command}.md — final Markdown consumed by Astro
//! ```
//!
//! **Manually-written pages** (faq.md, llm-commits.md) bypass this pipeline.
//! They use `<span class="badge-experimental"></span>` directly for badges.
//!
-//! **Skill reference files** mirror docs/ content via `transform_docs_for_skill()`,
-//! which strips Zola syntax (terminal shortcodes, badge `<span>` → `[experimental]`)
-//! for plain-markdown consumption.
+//! **Skill reference files** mirror docs content via `transform_docs_for_skill()`,
+//! which strips site-only elements such as demo figures and converts badge
+//! `<span>` elements back to `[experimental]`.
use std::ffi::OsString;
use std::process;
@@ -52,15 +48,15 @@ use ansi_str::AnsiStr;
use clap::error::ErrorKind;
use worktrunk::docs::{
BADGE_EXPERIMENTAL_HTML, DEMO_MARKER_PREFIX, MARKER_CLOSE, MARKER_OPEN_PREFIX,
- SUBDOC_MARKER_PREFIX, convert_dollar_console_to_terminal,
+ SUBDOC_MARKER_PREFIX,
};
use worktrunk::styling::{ColorChoice, eprintln, print, println};
use crate::cli;
-/// Output format for a `--help-page`. Web pages keep Zola shortcodes, HTML
-/// spans, and demo GIF figures for the docs site; plain pages strip those for
-/// skill reference files that need portable markdown.
+/// Output format for a `--help-page`. Web pages keep semantic HTML spans and
+/// demo GIF figures for the docs site; plain pages strip those for skill
+/// reference files that need portable Markdown.
#[derive(Clone, Copy)]
enum PageMode {
Web,
@@ -68,32 +64,6 @@ enum PageMode {
}
impl PageMode {
- /// The page's one color choice, declared globally for the stdout it
- /// prints to. The embedded `--help` reference block always renders with
- /// escapes and the stream decides what survives: web keeps them for the
- /// docs pipeline to turn into HTML spans, plain strips them for the
- /// portable markdown skill files read. Both generators read a pipe rather
- /// than a tty, so without the global web's escapes would be stripped
- /// every time.
- fn color(self) -> ColorChoice {
- match self {
- Self::Web => ColorChoice::Always,
- Self::Plain => ColorChoice::Never,
- }
- }
-
- /// Transform freshly-combined raw help into mode-appropriate markdown. Web
- /// rewrites `$`-prefixed console blocks into `{% terminal() %}`
- /// shortcodes; both modes relabel plain ``` ```console ``` fences as
- /// ``` ```bash ``` for syntax highlighting.
- fn transform_raw(self, text: String) -> String {
- let text = match self {
- Self::Web => convert_dollar_console_to_terminal(&text),
- Self::Plain => text,
- };
- text.replace("```console\n", "```bash\n")
- }
-
/// Transform the body (everything before subdoc placeholders). Web expands
/// demo GIFs into `<picture>` figures and converts CLI markers into HTML
/// spans; plain strips demo placeholders so they don't leak as comments.
@@ -284,21 +254,17 @@ pub fn maybe_handle_help_with_pager(
}
}
-/// The help reference block, rendered with ANSI codes for the page's stdout
-/// stream to keep or strip.
+/// The help reference block, normalized for portable Markdown output.
fn help_reference(command_path: &[&str], width: Option<usize>) -> String {
let output = help_reference_inner(command_path, width);
- // Strip OSC 8 hyperlinks. Clap generates these from markdown links like [text](url),
- // but web docs convert ANSI to HTML via ansi_to_html which only handles SGR codes
- // (colors), not OSC sequences - hyperlinks leak through as garbage. The plain
- // stream drops them anyway, so the strip runs unconditionally.
+ // Clap turns Markdown links into OSC 8 hyperlinks even when color is disabled.
+ // Escape sequences are not valid portable Markdown, so retain their visible
+ // labels and discard the terminal-only control bytes.
worktrunk::styling::strip_osc8_hyperlinks(&output)
}
-/// Normalize fences in clap-rendered help output for downstream markdown
-/// consumers. `--help-md` and `help_reference_inner` both run this; the lone
-/// `console`→`bash` use in `PageMode::transform_raw` doesn't, because its input
-/// is `after_long_help` markdown which never contains clap's `text` blocks.
+/// Normalize fences in clap-rendered help output for downstream Markdown
+/// consumers. `--help-md` and `help_reference_inner` both run this.
fn normalize_clap_help_fences(text: &str) -> String {
text
// clap's default for usage blocks — strip the language for plain markdown
@@ -475,11 +441,12 @@ Commands with schemas: list"
/// ```
/// ```
///
-/// This is used to generate docs/content/merge.md etc from the source.
+/// This is used to generate docs/src/content/docs/merge.md etc from the source.
fn handle_help_page(subcommand: Option<&str>, mode: PageMode) {
- // This page's stdout is a pipe to a generator rather than a tty, so the
- // mode decides its color.
- mode.color().write_global();
+ // Help pages are portable Markdown, so terminal color escapes never enter
+ // the generated source. The website adds syntax and prompt styling when
+ // it renders fenced blocks.
+ ColorChoice::Never.write_global();
let mut cmd = cli::build_command();
cmd = crate::completion::inject_hook_subcommands(cmd);
@@ -500,7 +467,7 @@ Commands with pages: merge, switch, remove, list"
};
let parent_name = format!("wt {}", subcommand);
- let raw_help = mode.transform_raw(combine_command_docs(sub));
+ let raw_help = combine_command_docs(sub);
// Subdocs are expanded separately so the main command reference comes first.
let (main_content, subdoc_content) = match raw_help.find(SUBDOC_MARKER_PREFIX) {
@@ -548,15 +515,14 @@ Commands with pages: merge, switch, remove, list"
/// | `` `#` green `` | `<span style='color:#0a0'>#</span> green` |
/// | `[experimental]` | `<span class="badge-experimental"></span>` (text via CSS) |
/// | plain URL | markdown link |
-/// | approval prompt code block | `{% terminal() %}` with colored symbols and gutter |
+/// | approval prompt code block | unchanged portable Markdown |
///
-/// Only runs on `after_long_help` markdown — not on terminal reference blocks (those go
-/// through ANSI-to-HTML via `convert_command_reference_to_html` in readme_sync.rs).
+/// Only runs on `after_long_help` Markdown, not on terminal reference blocks.
///
/// The terminal counterpart is `md_help::colorize_status_symbols()`.
fn post_process_for_html(text: &str) -> String {
// First pass: move [experimental] from heading lines to a separate line after
- // the heading. This keeps the badge outside Zola's heading anchor link.
+ // the heading. This keeps the badge out of the generated anchor slug.
// Terminal help keeps [experimental] on the heading line (different render path).
let text = move_experimental_from_headings(text);
@@ -578,35 +544,6 @@ fn post_process_for_html(text: &str) -> String {
"Open an issue at https://github.com/max-sixty/worktrunk.",
"[Open an issue](https://github.com/max-sixty/worktrunk/issues).",
)
- // Approval prompt: plain code block → terminal shortcode with colored symbols
- // and gutter. CLI shows a plain ``` block; web shows styled terminal output
- // matching the actual CLI appearance (yellow ▲, dim ○, cyan ❯, gutter bar).
- .replace(
- "```\n\
- ▲ repo needs approval to execute 3 commands:\n\
- \n\
- ○ pre-start install:\n\
- \x20\x20\x20npm ci\n\
- ○ pre-start build:\n\
- \x20\x20\x20cargo build --release\n\
- ○ pre-start env:\n\
- \x20\x20\x20echo 'PORT={{ branch | hash_port }}' > .env.local\n\
- \n\
- ❯ Allow and remember? [y/N]\n\
- ```",
- "{% terminal() %}\n\
- <span class=\"y\">▲ <b>repo</b> needs approval to execute <b>3</b> commands:</span>\n\
- \n\
- <span class=\"d\">○</span> pre-start <b>install</b>:\n\
- <span style='background:var(--bright-white,#fff)'> </span> <span class=\"d\"><span class=\"b\">npm</span> ci</span>\n\
- <span class=\"d\">○</span> pre-start <b>build</b>:\n\
- <span style='background:var(--bright-white,#fff)'> </span> <span class=\"d\"><span class=\"b\">cargo</span> build <span class=\"c\">--release</span></span>\n\
- <span class=\"d\">○</span> pre-start <b>env</b>:\n\
- <span style='background:var(--bright-white,#fff)'> </span> <span class=\"d\"><span class=\"b\">echo</span> <span class=\"g\">'PORT={{ branch | hash_port }}'</span> <span class=\"c\">></span> .env.local</span>\n\
- \n\
- <span class=\"c\">❯</span> Allow and remember? <b>[y/N]</b>\n\
- {% end %}",
- )
}
/// Move `[experimental]` from heading lines to a separate line after the heading.
@@ -618,9 +555,9 @@ fn post_process_for_html(text: &str) -> String {
/// [experimental]
/// ```
///
-/// This keeps the badge outside Zola's `<a class="zola-anchor">` wrapper so it's
-/// not part of the heading link. The `[experimental]` is then replaced with the
-/// badge `<span>` by the caller's `.replace()` chain.
+/// This keeps the badge out of the heading text and therefore out of its slug.
+/// The `[experimental]` is then replaced with the badge `<span>` by the
+/// caller's `.replace()` chain.
fn move_experimental_from_headings(text: &str) -> String {
if !text.contains(" [experimental]") {
return text.to_string();
@@ -770,10 +707,10 @@ fn format_subcommand_section(
// full_command is "wt config create"
let full_command = format!("{} {}", parent_name, subcommand_name);
- let raw_help = mode.transform_raw(combine_command_docs(sub));
+ let raw_help = combine_command_docs(sub);
// Extract [experimental] marker from content start → badge after heading.
- // Web mode: placed after heading as HTML badge so Zola's anchor link doesn't wrap it.
+ // Web mode: placed after the heading so it does not affect the anchor slug.
// Plain mode: kept as [experimental] text.
let (has_experimental, raw_help) = match raw_help.strip_prefix("[experimental] ") {
Some(rest) => (true, rest.to_string()),
diff --git a/src/md_help.rs b/src/md_help.rs
index 75a40fe81..d9175d0b8 100644
--- a/src/md_help.rs
+++ b/src/md_help.rs
@@ -554,7 +554,7 @@ mod tests {
fn test_render_inline_formatting_strips_links() {
assert_eq!(render_inline_formatting("[text](url)"), "text");
assert_eq!(
- render_inline_formatting("See [wt hook](@/hook.md) for details"),
+ render_inline_formatting("See [wt hook](/hook/) for details"),
"See wt hook for details"
);
}
@@ -624,7 +624,7 @@ mod tests {
assert_snapshot!(mixed, @"text code more bold end");
// Backticks inside link text
- let link_code = render_inline_formatting("See [`wt hook`](@/hook.md) for details");
+ let link_code = render_inline_formatting("See [`wt hook`](/hook/) for details");
assert_snapshot!(link_code, @"See wt hook for details");
// Unclosed backtick
@@ -660,7 +660,7 @@ mod tests {
// header's own style covers the whole line (no literal backticks, no
// mid-line ANSI reset). Real case: `### Command log (`commands.jsonl`)`
// on the `wt config state logs` page.
- let md = "### `--stage`\n#### Run `wt merge`\n## See [the docs](@/x.md)";
+ let md = "### `--stage`\n#### Run `wt merge`\n## See [the docs](/x/)";
let result = render_markdown_in_help(md);
assert_snapshot!(result, @"
--stage
diff --git a/src/styling/hyperlink.rs b/src/styling/hyperlink.rs
index 626531771..51fad1ece 100644
--- a/src/styling/hyperlink.rs
+++ b/src/styling/hyperlink.rs
@@ -30,8 +30,8 @@ pub fn hyperlink(url: &str, text: &str) -> String {
///
/// OSC 8 terminal hyperlinks are great for terminal output (clickable links!), but can cause
/// issues in other contexts:
-/// - **Web docs**: `ansi_to_html` only handles SGR codes (colors), not OSC sequences—hyperlinks
-/// leak through as garbage text
+/// - **Markdown output**: terminal control bytes are not portable source and can render as
+/// garbage text
/// - **Test output**: PTY tests using vt100 parser may show hyperlinks as garbage characters
/// (like `^D`) in rendered terminal output
///
diff --git a/tests/integration_tests/doc_templates.rs b/tests/integration_tests/doc_templates.rs
index ec0a0765c..a112377d6 100644
--- a/tests/integration_tests/doc_templates.rs
+++ b/tests/integration_tests/doc_templates.rs
@@ -1,6 +1,6 @@
//! Tests for template examples shown in documentation.
//!
-//! These tests verify that template expressions documented in docs/content/ behave
+//! These tests verify that template expressions documented in docs/src/content/docs/ behave
//! as described. This catches operator precedence issues like the one fixed in PR #373
//! where `{{ 'db-' ~ branch | hash_port }}` was incorrectly documented without parentheses.
//!
@@ -26,7 +26,7 @@ fn hash_port(s: &str) -> u16 {
}
// =============================================================================
-// Basic Variables (docs/content/hook.md: Template variables table)
+// Basic Variables (docs/src/content/docs/hook.md: Template variables table)
// =============================================================================
#[rstest]
@@ -86,7 +86,7 @@ fn test_doc_basic_variables(repo: TestRepo) {
}
// =============================================================================
-// Sanitize Filter (docs/content/hook.md: Filters table)
+// Sanitize Filter (docs/src/content/docs/hook.md: Filters table)
// "Replace `/` and `\` with `-`"
// =============================================================================
@@ -141,7 +141,7 @@ fn test_doc_sanitize_filter(repo: TestRepo) {
}
// =============================================================================
-// Sanitize DB Filter (docs/content/hook.md: Filters table)
+// Sanitize DB Filter (docs/src/content/docs/hook.md: Filters table)
// "Transform to database-safe identifier ([a-z0-9_], max 48 chars)"
// =============================================================================
@@ -260,7 +260,7 @@ fn test_doc_sanitize_db_truncation(repo: TestRepo) {
}
// =============================================================================
-// Hash Port Filter (docs/content/hook.md: Filters table)
+// Hash Port Filter (docs/src/content/docs/hook.md: Filters table)
// "Hash to port 10000-19999"
// =============================================================================
@@ -298,13 +298,13 @@ fn test_doc_hash_port_filter(repo: TestRepo) {
}
// =============================================================================
-// Concatenation with hash_port (docs/content/tips-patterns.md)
+// Concatenation with hash_port (docs/src/content/docs/tips-patterns.md)
// CRITICAL: These test the operator precedence issue from PR #373
// =============================================================================
#[rstest]
fn test_doc_hash_port_concatenation_precedence(repo: TestRepo) {
- // From docs/content/tips-patterns.md:
+ // From docs/src/content/docs/tips-patterns.md:
// "The `'db-' ~ branch` concatenation hashes differently than plain `branch`"
//
// The docs show: {{ ('db-' ~ branch) | hash_port }}
@@ -360,7 +360,7 @@ fn test_doc_hash_port_concatenation_precedence(repo: TestRepo) {
#[rstest]
fn test_doc_hash_port_repo_branch_concatenation(repo: TestRepo) {
- // From docs/content/hook.md line 176:
+ // From docs/src/content/docs/hook.md line 176:
// dev = "npm run dev --port {{ (repo ~ '-' ~ branch) | hash_port }}"
let repository = Repository::at(repo.root_path()).unwrap();
@@ -393,7 +393,7 @@ fn test_doc_hash_port_repo_branch_concatenation(repo: TestRepo) {
#[rstest]
fn test_doc_example_docker_postgres(repo: TestRepo) {
- // From docs/content/tips-patterns.md lines 75-84:
+ // From docs/src/content/docs/tips-patterns.md lines 75-84:
// docker run ... -p {{ ('db-' ~ branch) | hash_port }}:5432
let repository = Repository::at(repo.root_path()).unwrap();
@@ -431,7 +431,7 @@ fn test_doc_example_docker_postgres(repo: TestRepo) {
#[rstest]
fn test_doc_example_database_url(repo: TestRepo) {
- // From docs/content/tips-patterns.md lines 96-101:
+ // From docs/src/content/docs/tips-patterns.md lines 96-101:
// DATABASE_URL=postgres://postgres:dev@localhost:{{ ('db-' ~ branch) | hash_port }}/{{ repo }}
let repository = Repository::at(repo.root_path()).unwrap();
@@ -459,7 +459,7 @@ fn test_doc_example_database_url(repo: TestRepo) {
#[rstest]
fn test_doc_example_dev_server(repo: TestRepo) {
- // From docs/content/hook.md lines 168-170:
+ // From docs/src/content/docs/hook.md lines 168-170:
// dev = "npm run dev -- --host {{ branch }}.localhost --port {{ branch | hash_port }}"
let repository = Repository::at(repo.root_path()).unwrap();
@@ -486,7 +486,7 @@ fn test_doc_example_dev_server(repo: TestRepo) {
#[rstest]
fn test_doc_example_worktree_path_sanitize(repo: TestRepo) {
- // From docs/content/tips-patterns.md line 217:
+ // From docs/src/content/docs/tips-patterns.md line 217:
// worktree-path = "{{ branch | sanitize }}"
let repository = Repository::at(repo.root_path()).unwrap();
diff --git a/tests/integration_tests/merge.rs b/tests/integration_tests/merge.rs
index 56789168b..17b59f5ee 100644
--- a/tests/integration_tests/merge.rs
+++ b/tests/integration_tests/merge.rs
@@ -1201,7 +1201,7 @@ command = "{llm_path_str}"
// appears on public pages.
// ============================================================================
-/// `wt merge` example for `docs/content/merge.md` — pre-merge hook running
+/// `wt merge` example for `docs/src/content/docs/merge.md` — pre-merge hook running
/// `cargo nextest run`, one-commit fast-forward merge, background cleanup.
#[rstest]
fn test_docs_merge_pre_merge_hook(mut repo: TestRepo) {
@@ -1293,7 +1293,7 @@ impl Registry {
);
}
-/// `wt merge` example for `docs/content/llm-commits.md` — three commits
+/// `wt merge` example for `docs/src/content/docs/llm-commits.md` — three commits
/// squashed with an LLM-generated message, then merged to default branch.
#[rstest]
fn test_docs_merge_squash_llm(mut repo: TestRepo) {
@@ -1363,7 +1363,7 @@ logic, and authentication tests.";
);
}
-/// `wt step squash` example for `docs/content/llm-commits.md` — three commits
+/// `wt step squash` example for `docs/src/content/docs/llm-commits.md` — three commits
/// squashed with an LLM-generated message.
#[rstest]
fn test_docs_step_squash_llm(mut repo: TestRepo) {
@@ -1421,7 +1421,7 @@ logic, and authentication tests.";
});
}
-/// `wt step commit` example for `docs/content/step.md` and `docs/content/llm-commits.md`.
+/// `wt step commit` example for `docs/src/content/docs/step.md` and `docs/src/content/docs/llm-commits.md`.
/// Feature worktree with two staged files + LLM-generated commit message.
#[rstest]
fn test_docs_step_commit_llm(mut repo: TestRepo) {
diff --git a/tests/integration_tests/output_system_guard.rs b/tests/integration_tests/output_system_guard.rs
index 1b9d66210..c22b68c66 100644
--- a/tests/integration_tests/output_system_guard.rs
+++ b/tests/integration_tests/output_system_guard.rs
@@ -502,8 +502,8 @@ fn test_color_follows_the_consumer(repo: TestRepo) {
(
&["merge", "--help-page"][..],
None,
- true,
- "the web reference block's ANSI is data the docs pipeline turns into HTML spans",
+ false,
+ "web reference pages are portable Markdown; the site renderer owns syntax styling",
),
(
&["merge", "--help-page", "--plain"][..],
diff --git a/tests/integration_tests/readme_sync.rs b/tests/integration_tests/readme_sync.rs
index 968d63144..3b5ca30e2 100644
--- a/tests/integration_tests/readme_sync.rs
+++ b/tests/integration_tests/readme_sync.rs
@@ -22,7 +22,6 @@
use crate::common::wt_command;
use ansi_str::AnsiStr;
-use ansi_to_html::convert as ansi_to_html;
use regex::Regex;
use std::collections::BTreeMap;
use std::fs;
@@ -56,13 +55,13 @@ static MARKER_PATTERN: LazyLock<Regex> = LazyLock::new(|| {
/// Regex for literal bracket notation (as stored in snapshots) - used by literal_to_escape
static ANSI_LITERAL_REGEX: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"\[[0-9;]*m").unwrap());
-/// Regex to find snapshot-driven terminal-shortcode markers in standalone docs files
-/// (worktrunk.md, llm-commits.md, etc.) for in-place refresh. The `.snap` ID
-/// requirement and `{% terminal() %}` body together are specific enough to
-/// exclude command-page help-region markers and other AUTO-GENERATED users.
+/// Regex to find snapshot-driven markers in standalone docs files
+/// (worktrunk.md, llm-commits.md, etc.) for in-place refresh. Matching the
+/// marker envelope instead of its body keeps snapshot sync independent of the
+/// documentation renderer.
static DOCS_SNAPSHOT_MARKER_PATTERN: LazyLock<Regex> = LazyLock::new(|| {
Regex::new(&format!(
- r"(?s){}([^\s]+\.snap) — edit source to update -->\n+\{{% terminal\([^)]*\) %\}}\n(.*?)\{{% end %\}}\n+{}",
+ r"(?s){}([^\s]+\.snap) — edit source to update -->\n+(.*?)\n+{}",
regex::escape(MARKER_OPEN_PREFIX),
regex::escape(MARKER_CLOSE),
))
@@ -121,58 +120,48 @@ static RUST_RAW_STRING_PATTERN: LazyLock<Regex> = LazyLock::new(|| {
.unwrap()
});
-/// Regex to convert Zola internal links to full URLs
-/// Matches: [text](@/page.md) or [text](@/page.md#anchor)
+/// Regex to convert site-root documentation links to full URLs.
+/// Matches: [text](/page/) or [text](/page/#anchor).
///
/// Link text tolerates `]` characters when they appear inside a backticked
/// code span (e.g. `[[block]]`), alternating "a `...` code span" with "any
/// non-`]`-non-backtick char". Bare backticks are forbidden so the regex
/// can't bridge across two unrelated code spans on the same line.
-static ZOLA_LINK_PATTERN: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r"\[((?:`[^`]*`|[^\]`])+)\]\(@/([^)#]+)\.md(#[^)]*)?\)").unwrap());
+static SITE_LINK_PATTERN: LazyLock<Regex> =
+ LazyLock::new(|| Regex::new(r"\[((?:`[^`]*`|[^\]`])+)\]\(/([^)/]+)/(#[^)]*)?\)").unwrap());
-/// Regex guardrail: any leftover `](@/...md...)` link that the transform
-/// above failed to rewrite. Used by [`assert_no_untransformed_zola_links`] to
-/// fail loudly on stray Zola internal links in generated content.
-static UNTRANSFORMED_ZOLA_LINK_PATTERN: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r"\]\(@/[^)]+\.md").unwrap());
+/// Guardrail for root-relative or legacy Zola links on generated non-site surfaces.
+static UNTRANSFORMED_SITE_LINK_PATTERN: LazyLock<Regex> =
+ LazyLock::new(|| Regex::new(r"\]\((?:/|@/)[^)]+\)").unwrap());
-/// Guardrail for every generated surface that rewrites Zola internal links.
+/// Guardrail for every generated non-site surface that rewrites internal links.
///
-/// A `@/page.md` target is meaningful only to Zola: it resolves when the docs
-/// site builds and is dead text anywhere else. Both link rewrites here are
-/// regexes over link *text*, so their failure mode is silence — an
-/// unanticipated character makes the pattern decline to match and the raw
-/// markdown survives into the generated file. Neither sync test can see it,
-/// because each compares the generated file against the same transform that
-/// produced it, so an unconverted link is "in sync" by construction.
+/// Root-relative links work on the site but not in installed skill files or
+/// generated config examples. Both rewrites are regexes over link text, so an
+/// unsupported shape can otherwise survive silently.
///
-/// So each surface asserts the negative afterwards: no `](@/…md` may remain.
+/// So each surface asserts the negative afterwards: no `](/…)` or legacy
+/// `](@/…)` may remain.
/// `surface` names the generated content for the failure message.
-fn assert_no_untransformed_zola_links(content: &str, surface: &str) {
- if let Some(m) = UNTRANSFORMED_ZOLA_LINK_PATTERN.find(content) {
+fn assert_no_untransformed_site_links(content: &str, surface: &str) {
+ if let Some(m) = UNTRANSFORMED_SITE_LINK_PATTERN.find(content) {
let snippet_start = content[..m.start()].rfind('\n').map_or(0, |i| i + 1);
let snippet_end = content[m.end()..]
.find('\n')
.map_or(content.len(), |i| m.end() + i);
panic!(
- "Failed to transform a Zola internal link in {surface} — likely an \
- unsupported character in the link text. Offending line:\n{}",
+ "Failed to transform an internal site link in {surface} — likely \
+ legacy syntax or an unsupported character in the link text. Offending line:\n{}",
&content[snippet_start..snippet_end]
);
}
}
-/// Regex to convert Zola rawcode shortcode to HTML pre tags
-/// Matches: {% rawcode() %}...{% end %}
-static ZOLA_RAWCODE_PATTERN: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r"(?s)\{% rawcode\(\) %\}(.*?)\{% end %\}").unwrap());
-
-/// Regex to convert Zola figure/picture elements to simple markdown images
+/// Regex to convert figure/picture elements to simple markdown images
/// Matches: <figure class="demo">...<img src="/assets/X.gif" alt="Y"...>...</figure>
/// Extracts: src path and alt text from the <img> tag
/// Note: Maps /assets/X to assets/X in the worktrunk-assets repo
-static ZOLA_FIGURE_PATTERN: LazyLock<Regex> = LazyLock::new(|| {
+static HTML_FIGURE_TO_IMAGE_PATTERN: LazyLock<Regex> = LazyLock::new(|| {
Regex::new(
r#"(?s)<figure class="demo">\s*<picture>.*?<img src="/assets/([^"]+)" alt="([^"]*)"[^>]*>.*?</picture>.*?</figure>"#,
)
@@ -185,8 +174,8 @@ static ZOLA_FIGURE_PATTERN: LazyLock<Regex> = LazyLock::new(|| {
/// Output format for section updates
enum OutputFormat {
- /// Docs: HTML with ANSI colors in {% terminal() %} shortcode
- DocsHtml,
+ /// Docs: framework-neutral console fence.
+ DocsMarkdown,
/// Unwrapped: raw markdown content (help commands, doc sections)
Unwrapped,
}
@@ -335,22 +324,15 @@ fn replace_placeholders(content: &str) -> String {
/// Format replacement content based on output format. The `wrap_in_marker`
/// envelope is identical for both; only the body construction varies.
-fn format_replacement(id: &str, content: &str, format: &OutputFormat) -> String {
- let body = match format {
- OutputFormat::DocsHtml => {
- // Extract command from <span class="cmd"> in body to also emit as
- // cmd= parameter (enables giallo syntax highlighting). The span
- // stays in body so sync comparisons remain stable.
- let cmd_re = Regex::new(r#"^<span class="cmd">([^<]+)</span>"#).unwrap();
- let cmd_attr = cmd_re
- .captures(content)
- .map(|c| format!(r#"cmd="{}""#, c.get(1).unwrap().as_str()))
- .unwrap_or_default();
- format!("{{% terminal({cmd_attr}) %}}\n{content}\n{{% end %}}")
- }
+fn format_body(content: &str, format: &OutputFormat) -> String {
+ match format {
+ OutputFormat::DocsMarkdown => format!("```console\n{content}\n```"),
OutputFormat::Unwrapped => content.to_string(),
- };
- wrap_in_marker(id, "source", &body)
+ }
+}
+
+fn format_replacement(id: &str, content: &str, format: &OutputFormat) -> String {
+ wrap_in_marker(id, "source", &format_body(content, format))
}
/// Update sections matching a pattern in content
@@ -373,7 +355,7 @@ fn update_section(
.map(|cap| {
let full_match = cap.get(0).unwrap();
let id = cap.get(1).unwrap().as_str().to_string();
- let current = trim_lines(cap.get(2).unwrap().as_str());
+ let current = cap.get(2).unwrap().as_str().to_string();
(full_match.start(), full_match.end(), id, current)
})
.collect();
@@ -390,7 +372,7 @@ fn update_section(
}
};
- if current != expected {
+ if current != format_body(&expected, &format) {
let replacement = format_replacement(&id, &expected, &format);
result.replace_range(start..end, &replacement);
updated += 1;
@@ -404,35 +386,73 @@ fn update_section(
}
}
+#[test]
+fn test_markdown_snapshot_section_converges() {
+ let content = "<!-- ⚠️ AUTO-GENERATED from tests/example.snap — edit source to update -->\n\n```console\n$ wt list\noutput\n```\n\n<!-- END AUTO-GENERATED -->";
+ let (unchanged, updated, total) = update_section(
+ content,
+ &DOCS_SNAPSHOT_MARKER_PATTERN,
+ OutputFormat::DocsMarkdown,
+ |_, _| Ok("$ wt list\noutput".to_string()),
+ )
+ .unwrap();
+ assert_eq!(unchanged, content);
+ assert_eq!((updated, total), (0, 1));
+
+ let (changed, updated, _) = update_section(
+ content,
+ &DOCS_SNAPSHOT_MARKER_PATTERN,
+ OutputFormat::DocsMarkdown,
+ |_, _| Ok("$ wt list\nnew output".to_string()),
+ )
+ .unwrap();
+ assert_eq!(updated, 1);
+ assert!(changed.contains("```console\n$ wt list\nnew output\n```"));
+
+ let content_with_trailing_space = content.replace("output\n```", "output \n```");
+ let (cleaned, updated, _) = update_section(
+ &content_with_trailing_space,
+ &DOCS_SNAPSHOT_MARKER_PATTERN,
+ OutputFormat::DocsMarkdown,
+ |_, _| Ok("$ wt list\noutput".to_string()),
+ )
+ .unwrap();
+ assert_eq!(updated, 1);
+ assert_eq!(cleaned, content);
+}
+
+#[test]
+fn test_snapshot_plain_text_has_no_trailing_whitespace() {
+ let rendered = trim_lines(&parse_snapshot_content("before\n\x1b[107m \x1b[0m \nafter"));
+ assert_eq!(rendered, "before\n\nafter");
+
+ let snapshot =
+ fs::read_to_string(Path::new(env!("CARGO_MANIFEST_DIR")).join(
+ "tests/snapshots/integration__integration_tests__merge__docs_merge_squash_llm.snap",
+ ))
+ .unwrap();
+ let rendered = trim_lines(&parse_snapshot_content(&snapshot));
+ assert!(
+ rendered.lines().all(|line| line.trim_end() == line),
+ "snapshot output retained trailing whitespace"
+ );
+}
+
// =============================================================================
// End Unified Infrastructure
// =============================================================================
/// Regex to find command placeholder comments in help pages.
///
-/// A placeholder is an HTML comment `<!-- wt <id> -->` followed by one of three
-/// code-block forms (the form depends on which stage of `--help-page` has run):
-///
-/// - ````bash``` with an optional `$ ` prompt, optionally followed by multi-line
-/// output — this is what plain (`--help-page --plain`) output contains, and
-/// also what `cli/mod.rs` source contains before `convert_dollar_console_to_terminal`.
-/// - `{{ terminal(cmd="...") }}` self-closing Zola shortcode — produced by
-/// `convert_dollar_console_to_terminal` when the source block has only a command.
-/// - `{% terminal(cmd="...") %}…{% end %}` Zola shortcode — produced by
-/// `convert_dollar_console_to_terminal` when the source block has output too.
+/// A placeholder is an HTML comment `<!-- wt <id> -->` followed by a `bash` or
+/// `console` fence with an optional `$ ` prompt and optional captured output.
///
/// Capture groups:
/// 1. placeholder id (e.g. `wt list (markers)`) — drives snapshot lookup
-/// 2. display command when matched in the ```bash form
-/// 3. display command when matched as `{{ terminal() }}`
-/// 4. display command when matched as `{% terminal() %}…{% end %}`
-///
-/// Exactly one of groups 2–4 is non-None per match.
+/// 2. display command
static COMMAND_PLACEHOLDER_PATTERN: LazyLock<Regex> = LazyLock::new(|| {
- Regex::new(
- r#"(?s)<!-- (wt [^>\n]+) -->\n(?:```bash\n(?:\$ )?(wt [^\n]+).*?\n```|\{\{ terminal\(cmd="(wt [^"]+)"\) \}\}|\{% terminal\(cmd="(wt [^"]+)"\) %\}.*?\{% end %\})"#,
- )
- .unwrap()
+ Regex::new(r"(?s)<!-- (wt [^>\n]+) -->\n```(?:bash|console)\n(?:\$ )?(wt [^\n]+).*?\n```")
+ .unwrap()
});
/// Map commands to their snapshot files for help page expansion
@@ -467,43 +487,23 @@ fn command_to_snapshot(command: &str) -> Option<&'static str> {
}
}
-/// Rendering mode for [`expand_command_placeholders`].
-enum ExpandMode {
- /// HTML docs (`docs/content/*.md`): emit a `{% terminal(cmd="...") %}`
- /// shortcode with an ANSI→HTML body, wrapped in AUTO-GENERATED markers.
- Html,
- /// Skill reference (`skills/worktrunk/reference/*.md`): emit a fenced code
- /// block with a `$ <cmd>` prompt and a plain-text body.
- Plain,
-}
-
/// Expand command placeholders in help page content into rendered snapshot blocks.
///
/// Finds `<!-- wt <id> -->` + ```bash\n[$ ]wt <cmd>\n``` blocks, looks up the
/// snapshot for the placeholder id (e.g. `wt list (markers)`), and replaces
-/// the block with a mode-appropriate rendering (see [`ExpandMode`]).
+/// the block with a portable console rendering.
///
/// The placeholder id drives snapshot lookup so disambiguation suffixes like
/// `(markers)` don't have to appear in the displayed command. Commands without
/// a snapshot mapping are left unchanged.
-fn expand_command_placeholders(
- content: &str,
- snapshots_dir: &Path,
- mode: ExpandMode,
-) -> Result<String, String> {
+fn expand_command_placeholders(content: &str, snapshots_dir: &Path) -> Result<String, String> {
let mut result = content.to_string();
let mut errors = Vec::new();
for cap in COMMAND_PLACEHOLDER_PATTERN.captures_iter(content) {
let full_match = cap.get(0).unwrap().as_str();
let placeholder_id = cap.get(1).unwrap().as_str();
- // Exactly one of groups 2–4 matched — pick whichever.
- let display_cmd = cap
- .get(2)
- .or_else(|| cap.get(3))
- .or_else(|| cap.get(4))
- .unwrap()
- .as_str();
+ let display_cmd = cap.get(2).unwrap().as_str();
let Some(snapshot_name) = command_to_snapshot(placeholder_id) else {
continue;
@@ -522,27 +522,13 @@ fn expand_command_placeholders(
let snapshot_content = fs::read_to_string(&snapshot_path)
.map_err(|e| format!("Failed to read {}: {}", snapshot_path.display(), e))?;
- let replacement = match mode {
- ExpandMode::Html => {
- let html = parse_snapshot_content_for_docs(&snapshot_content)?;
- let normalized = encode_leading_spaces(&trim_lines(&html));
- // cmd= parameter uses the displayed command (enables giallo
- // syntax highlighting on the command line) rather than the
- // placeholder id, so disambiguation suffixes like `(markers)`
- // don't leak into the rendered prompt. Prompt ($) is added
- // via CSS ::before, so not included in HTML.
- //
- // No inner AUTO-GENERATED wrapper — the whole command page
- // regenerates wholesale each sync, so the wrapper is dead
- // weight and would nest inside the outer help-page region's
- // markers (forcing the outer regex to use a tempered match).
- format!("{{% terminal(cmd=\"{display_cmd}\") %}}\n{normalized}\n{{% end %}}")
- }
- ExpandMode::Plain => {
- let plain = trim_lines(&parse_snapshot_content_for_skill(&snapshot_content));
- format!("```\n$ {display_cmd}\n{plain}\n```")
- }
+ let plain = trim_lines(&parse_snapshot_content(&snapshot_content));
+ let body = if plain.is_empty() {
+ format!("$ {display_cmd}")
+ } else {
+ format!("$ {display_cmd}\n{plain}")
};
+ let replacement = format!("```console\n{body}\n```");
result = result.replace(full_match, &replacement);
}
@@ -576,143 +562,14 @@ fn trim_lines(content: &str) -> String {
.to_string()
}
-/// Encode leading spaces on the first line as `&#32;` HTML entities.
-/// Zola trims leading whitespace from shortcode bodies, stripping the
-/// two-space gutter that aligns table headers with data rows in `wt list`.
-/// HTML entities survive the trim and render as spaces in `<pre>` blocks.
-fn encode_leading_spaces(content: &str) -> String {
- let first_line = content.lines().next().unwrap_or("");
- let leading = first_line.len() - first_line.trim_start().len();
- if leading == 0 {
- return content.to_string();
- }
- format!("{}{}", "&#32;".repeat(leading), &content[leading..])
-}
-
-/// Parse snapshot content for docs (with ANSI to HTML conversion)
-fn parse_snapshot_content_for_docs(content: &str) -> Result<String, String> {
- let content = parse_snapshot_raw(content);
- let content = replace_placeholders(&content);
- let content = literal_to_escape(&content);
- let html = ansi_to_html(&content).map_err(|e| format!("ANSI conversion failed: {e}"))?;
- Ok(clean_ansi_html(&html))
-}
-
-/// Parse snapshot content for skill reference files (plain text, ANSI stripped)
-fn parse_snapshot_content_for_skill(content: &str) -> String {
+/// Parse snapshot content into portable Markdown code-block text.
+fn parse_snapshot_content(content: &str) -> String {
let content = parse_snapshot_raw(content);
let content = replace_placeholders(&content);
let content = literal_to_escape(&content);
content.ansi_strip().into_owned()
}
-/// Ensure each line ends with a reset code, carrying active styles to the next line
-///
-/// Clap resets styles at line breaks when wrapping, so a bold span that wraps across
-/// lines loses its bold on the continuation. This tracks active SGR styles
-/// and re-opens them at the start of each continuation line, producing clean per-line
-/// HTML like `<b>first part</b>\n<b>second part</b>` instead of `<b>first part</b>\nsecond part`.
-fn ensure_line_resets_with_carry(ansi: &str) -> String {
- const RESET: &str = "\x1b[0m";
- // Match SGR sequences: ESC [ <params> m
- static SGR_RE: LazyLock<Regex> = LazyLock::new(|| Regex::new(r"\x1b\[([0-9;]*)m").unwrap());
-
- let lines: Vec<&str> = ansi.lines().collect();
- let mut result = Vec::with_capacity(lines.len());
- let mut active_styles: Vec<String> = Vec::new();
-
- for line in lines {
- // Prepend active styles from previous line
- let line = if active_styles.is_empty() {
- line.to_string()
- } else {
- let prefix: String = active_styles.iter().map(|s| s.as_str()).collect();
- format!("{prefix}{line}")
- };
-
- // Track which styles are active at end of this line
- active_styles.clear();
- for cap in SGR_RE.captures_iter(&line) {
- let params = &cap[1];
- if params.is_empty() || params == "0" {
- active_styles.clear();
- } else {
- active_styles.push(format!("\x1b[{params}m"));
- }
- }
-
- // Ensure line ends with reset
- if line.ends_with(RESET) {
- result.push(line);
- } else {
- result.push(format!("{line}{RESET}"));
- }
- }
-
- result.join("\n")
-}
-
-/// Clean up HTML output from ansi-to-html conversion
-fn clean_ansi_html(html: &str) -> String {
- // Regex to remove empty HTML spans (e.g., <span style='opacity:0.67'></span>)
- static EMPTY_SPAN_REGEX: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r"<span[^>]*></span>").unwrap());
-
- // Strip bare ESC characters left by the library
- let html = html.replace('\x1b', "");
-
- // Clean up empty tags generated by reset codes
- let html = html.replace("<b></b>", "");
- let html = EMPTY_SPAN_REGEX.replace_all(&html, "").to_string();
-
- // Replace verbose inline styles with CSS classes for cleaner output
- html.replace("<span style='opacity:0.67'>", "<span class=d>")
- .replace("<span style='color:var(--green,#0a0)'>", "<span class=g>")
- .replace("<span style='color:var(--red,#a00)'>", "<span class=r>")
- .replace("<span style='color:var(--cyan,#0aa)'>", "<span class=c>")
-}
-
-/// Regex to find command reference code blocks with ANSI content
-/// Matches: ## Command reference\n\n```\n<content with ANSI>\n```
-/// or: ### Command reference\n\n```\n<content with ANSI>\n```
-static COMMAND_REF_BLOCK_PATTERN: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r"(?s)(###? Command reference\n\n)```\n(.*?)\n```").unwrap());
-
-/// Convert command reference code blocks to terminal shortcodes with HTML
-///
-/// Finds code blocks after "## Command reference" or "### Command reference" headers
-/// and converts ANSI escape codes to HTML, wrapping in {% terminal() %} shortcode.
-fn convert_command_reference_to_html(content: &str) -> Result<String, String> {
- let mut result = content.to_string();
-
- // Find all command reference blocks and convert them
- // Process in reverse order to preserve positions
- let matches: Vec<_> = COMMAND_REF_BLOCK_PATTERN
- .captures_iter(content)
- .map(|cap| {
- let full_match = cap.get(0).unwrap();
- let header = cap.get(1).unwrap().as_str();
- let code_content = cap.get(2).unwrap().as_str();
- (full_match.start(), full_match.end(), header, code_content)
- })
- .collect();
-
- for (start, end, header, code_content) in matches.into_iter().rev() {
- // Convert ANSI to HTML
- let with_resets = ensure_line_resets_with_carry(code_content);
- let html =
- ansi_to_html(&with_resets).map_err(|e| format!("ANSI conversion failed: {e}"))?;
- let clean_html = clean_ansi_html(&html);
- let trimmed_html = trim_lines(&clean_html);
-
- // Build terminal shortcode
- let replacement = format!("{header}{{% terminal() %}}\n{trimmed_html}\n{{% end %}}");
- result.replace_range(start..end, &replacement);
- }
-
- Ok(result)
-}
-
/// Get help output for a command
///
/// Expected format: `wt <subcommand> --help-md` (ID includes backticks from marker)
@@ -896,51 +753,15 @@ fn heading_to_anchor(heading: &str) -> String {
.join("-")
}
-/// Regex to match terminal-shortcode AUTO-GENERATED markers in docs files,
-/// for conversion to plain code blocks when extracting sections into README.
-/// Optionally consumes a preceding ```bash``` block (rendered redundant by
-/// the cmd= parameter on the shortcode).
-/// Matches both `{% terminal() %}` and `{% terminal(cmd="...") %}` forms.
-static TERMINAL_MARKER_PATTERN: LazyLock<Regex> = LazyLock::new(|| {
- Regex::new(&format!(
- r"(?s)(?:```bash\n[^\n]+\n```\n+)?{}[^\n]+ -->\n+\{{% terminal\([^)]*\) %\}}\n(.*?)\{{% end %\}}\n+{}",
- regex::escape(MARKER_OPEN_PREFIX),
- regex::escape(MARKER_CLOSE),
- ))
- .unwrap()
-});
-
-/// Strip HTML tags from content, converting .cmd spans to `$ ` prefixed commands
-fn strip_html(content: &str) -> String {
- // First, convert <span class="cmd">...</span> to "$ ..." (add prompt)
- let cmd_pattern = Regex::new(r#"<span class="cmd">([^<]*)</span>"#).unwrap();
- let result = cmd_pattern.replace_all(content, "$ $1");
-
- // Strip remaining HTML tags
- let tag_pattern = Regex::new(r"<[^>]+>").unwrap();
- let result = tag_pattern.replace_all(&result, "");
-
- // Decode HTML entities
- result
- .replace("&amp;", "&")
- .replace("&lt;", "<")
- .replace("&gt;", ">")
- .replace("&quot;", "\"")
- .replace("&#39;", "'")
-}
-
-/// Transform Zola-flavored markdown to GitHub-flavored markdown
+/// Transform site Markdown for embedding in GitHub-rendered files.
///
/// Converts:
-/// - `[text](@/page.md)` → `[text](https://worktrunk.dev/page/)`
-/// - `[text](@/page.md#anchor)` → `[text](https://worktrunk.dev/page/#anchor)`
-/// - `{% rawcode() %}...{% end %}` → `<pre>...</pre>`
+/// - `[text](/page/)` → `[text](https://worktrunk.dev/page/)`
/// - `<figure class="demo">...<img src="/assets/X.gif"...>...</figure>` → `![alt](raw.githubusercontent.com/.../X.gif)`
-/// - AUTO-GENERATED terminal markers → plain code blocks
-/// - `{{ terminal(cmd="...") }}` → ```bash code blocks
-fn transform_zola_to_github(content: &str) -> String {
+/// - AUTO-GENERATED marker comments → removed, leaving their Markdown body
+fn transform_docs_to_github(content: &str) -> String {
// Transform internal links
- let content = ZOLA_LINK_PATTERN
+ let content = SITE_LINK_PATTERN
.replace_all(content, |caps: &regex::Captures| {
let text = caps.get(1).unwrap().as_str();
let page = caps.get(2).unwrap().as_str();
@@ -948,35 +769,13 @@ fn transform_zola_to_github(content: &str) -> String {
format!("[{text}](https://worktrunk.dev/{page}/{anchor})")
})
.into_owned();
-
- // Transform rawcode shortcodes to pre tags
- let content = ZOLA_RAWCODE_PATTERN
- .replace_all(&content, |caps: &regex::Captures| {
- let inner = caps.get(1).unwrap().as_str();
- format!("<pre>{}</pre>", inner)
- })
- .into_owned();
-
- // Transform terminal markers to console code blocks for README
- let content = TERMINAL_MARKER_PATTERN
- .replace_all(&content, |caps: &regex::Captures| {
- let inner = caps.get(1).unwrap().as_str();
- // Strip HTML, converting .cmd spans to "$ ..." (adds prompt)
- let plain = strip_html(inner);
- format!("```console\n{}\n```", plain)
- })
- .into_owned();
-
- // Transform self-closing terminal shortcodes to bash code blocks for README
- // These are `{{ terminal(cmd="...") }}` shortcodes without body content
- let content = ZOLA_TERMINAL_SELF_CLOSING_PATTERN
- .replace_all(&content, |caps: &regex::Captures| {
- cmd_to_bash_block(caps.get(1).map_or("", |m| m.as_str()), "", false)
- })
+ let content = AUTO_GENERATED_MARKER_PATTERN
+ .replace_all(&content, "")
.into_owned();
+ let content = content.replace(worktrunk::docs::BADGE_EXPERIMENTAL_HTML, "[experimental]");
// Transform figure/picture elements to markdown images with GitHub raw URLs
- ZOLA_FIGURE_PATTERN
+ let content = HTML_FIGURE_TO_IMAGE_PATTERN
.replace_all(&content, |caps: &regex::Captures| {
let filename = caps.get(1).unwrap().as_str();
let alt = caps.get(2).unwrap().as_str();
@@ -984,13 +783,15 @@ fn transform_zola_to_github(content: &str) -> String {
"![{alt}](https://raw.githubusercontent.com/max-sixty/worktrunk-assets/main/assets/{filename})"
)
})
- .into_owned()
+ .into_owned();
+ assert_no_untransformed_site_links(&content, "README content");
+ content
}
/// Get section content from docs file, transformed for README
///
/// Parses `path#anchor` ID format, extracts section(s) by anchor
-/// (supports ranges like `start..end`), and transforms Zola links to GitHub URLs.
+/// (supports ranges like `start..end`), and makes site links absolute.
fn docs_section_for_readme(id: &str, project_root: &Path) -> Result<String, String> {
let (path, anchor) = id
.split_once('#')
@@ -1003,8 +804,7 @@ fn docs_section_for_readme(id: &str, project_root: &Path) -> Result<String, Stri
let section = extract_section_by_anchor(&content, anchor)
.ok_or_else(|| format!("Section '{}' not found in {}", anchor, docs_path.display()))?;
- // Transform Zola links to GitHub URLs
- Ok(transform_zola_to_github(&section))
+ Ok(transform_docs_to_github(&section))
}
/// Get content for a README marker based on its type
@@ -1049,13 +849,13 @@ fn sync_readme_markers(
let total = matches.len();
// Process in reverse order to preserve positions. README markers are always
- // Help/Section (unwrapped); a Snapshot marker would mean a stale shortcode
- // leaked through `transform_zola_to_github` and is a real bug to surface.
+ // Help/Section (unwrapped); generated snapshot marker comments are removed
+ // when docs sections are embedded.
for (start, end, id, current) in matches.into_iter().rev() {
if matches!(MarkerType::from_id(&id), MarkerType::Snapshot) {
errors.push(format!(
"❌ {id}: README must not contain snapshot markers — \
- transform_zola_to_github should have stripped this"
+ transform_docs_to_github should have stripped this"
));
continue;
}
@@ -1117,7 +917,7 @@ fn transform_config_source_to_toml(source: &str) -> String {
}
// Convert markdown links to plain text for config file readability
- // [Link text](@/page.md) → Link text (https://worktrunk.dev/page/)
+ // [Link text](/page/) → Link text (https://worktrunk.dev/page/)
// [Link text](https://...) → Link text (https://...)
let line = convert_markdown_links_for_config(line);
@@ -1139,8 +939,8 @@ fn transform_config_source_to_toml(source: &str) -> String {
// Guardrail: a link `convert_markdown_links_for_config` declined to match
// survives as raw markdown into the generated example file, which
// `wt config create` writes to the user's config and `wt config create
- // --help` prints — so the `@/` target would reach the user verbatim.
- assert_no_untransformed_zola_links(&result, "a generated config example");
+ // --help` prints — so a root-relative site link would reach the user verbatim.
+ assert_no_untransformed_site_links(&result, "a generated config example");
result
}
@@ -1148,17 +948,17 @@ fn transform_config_source_to_toml(source: &str) -> String {
/// Convert markdown links to plain text with URL in parentheses.
///
/// Config files aren't rendered as markdown, so links need to be readable as plain text.
-/// - `[Link text](@/page.md)` → `Link text (https://worktrunk.dev/page/)`
+/// - `[Link text](/page/)` → `Link text (https://worktrunk.dev/page/)`
/// - `[Link text](https://example.com)` → `Link text (https://example.com)`
///
/// The link text may itself contain a bracketed span — a TOML section name in
-/// backticks (``[pattern-keyed `[projects]` entry](@/config.md#…)``) is the
+/// backticks (``[pattern-keyed `[projects]` entry](/config/#…)``) is the
/// shape that occurs here. A link that isn't converted survives as raw
/// markdown into the generated example file, which `wt config create` writes
-/// to the user's config and `wt config create --help` prints, so a Zola `@/`
+/// to the user's config and `wt config create --help` prints, so a site-relative
/// target reaches the user verbatim. Brackets in these link texts always sit
/// inside a backticked code span, so the text class alternates a code span
-/// with any non-`]`-non-backtick char — the same rule `ZOLA_LINK_PATTERN`
+/// with any non-`]`-non-backtick char — the same rule `SITE_LINK_PATTERN`
/// uses above, which also covers `[[…]]` array-of-tables names.
fn convert_markdown_links_for_config(line: &str) -> String {
use regex::Regex;
@@ -1172,17 +972,8 @@ fn convert_markdown_links_for_config(line: &str) -> String {
let text = &caps[1];
let url = &caps[2];
- // Convert Zola @/ links to full URLs
- let url = if let Some(path) = url.strip_prefix("@/") {
- // Handle anchors: @/config.md#section → config/#section
- let (page, anchor) = match path.split_once('#') {
- Some((p, a)) => (p.trim_end_matches(".md"), Some(a)),
- None => (path.trim_end_matches(".md"), None),
- };
- match anchor {
- Some(a) => format!("https://worktrunk.dev/{page}/#{a}"),
- None => format!("https://worktrunk.dev/{page}/"),
- }
+ let url = if let Some(path) = url.strip_prefix('/') {
+ format!("https://worktrunk.dev/{path}")
} else {
url.to_string()
};
@@ -1196,19 +987,19 @@ fn convert_markdown_links_for_config(line: &str) -> String {
/// one whose text carries a bracketed span of its own.
///
/// The generated file is what `wt config create` writes and what `wt config
-/// create --help` prints, so a link this misses ships a raw `@/page.md` target
+/// create --help` prints, so a link this misses ships a raw site target
/// to the user. Nothing downstream catches that: the sync test compares the
/// example against this same transform, so an unconverted link is "in sync".
#[test]
fn test_config_markdown_links_convert_to_plain_text() {
let cases = [
- // Zola page link, and the same with an anchor.
+ // Site page link, and the same with an anchor.
(
- "See [hooks](@/hook.md) for details",
+ "See [hooks](/hook/) for details",
"See hooks (https://worktrunk.dev/hook/) for details",
),
(
- "See [forge platform](@/config.md#forge-platform).",
+ "See [forge platform](/config/#forge-platform).",
"See forge platform (https://worktrunk.dev/config/#forge-platform).",
),
// An absolute URL passes through untouched.
@@ -1220,19 +1011,19 @@ fn test_config_markdown_links_convert_to_plain_text() {
// backticks. The pre-fix regex stopped at the inner `]` and left the
// whole link as raw markdown.
(
- "name it once with a [pattern-keyed `[projects]` entry](@/config.md#user-project-specific-settings) instead",
+ "name it once with a [pattern-keyed `[projects]` entry](/config/#user-project-specific-settings) instead",
"name it once with a pattern-keyed `[projects]` entry (https://worktrunk.dev/config/#user-project-specific-settings) instead",
),
// The same shape naming an array-of-tables. These sections document
// `[[projects."…".post-start]]` pipelines, so a link naming one is the
// next form to arrive; the code-span class covers it.
(
- "see [`[[projects.\"…\".post-start]]` hooks](@/config.md#hooks) for the pipeline form",
+ "see [`[[projects.\"…\".post-start]]` hooks](/config/#hooks) for the pipeline form",
"see `[[projects.\"…\".post-start]]` hooks (https://worktrunk.dev/config/#hooks) for the pipeline form",
),
// Two links on one line still both convert.
(
- "[a](@/hook.md) and [b](@/config.md)",
+ "[a](/hook/) and [b](/config/)",
"a (https://worktrunk.dev/hook/) and b (https://worktrunk.dev/config/)",
),
// A bare bracketed span is not a link and must survive verbatim —
@@ -1253,7 +1044,7 @@ fn test_config_markdown_links_convert_to_plain_text() {
}
/// A link shape the rewrite declines to match fails loudly rather than
-/// shipping its `@/` target.
+/// shipping its site-relative target.
///
/// This is the backstop for the case the test above can't anticipate: the next
/// unsupported link text. The generated config example runs through
@@ -1261,10 +1052,16 @@ fn test_config_markdown_links_convert_to_plain_text() {
/// regex silently declined" into a test failure naming the line.
#[test]
#[should_panic(expected = "a generated config example")]
-fn test_untransformed_zola_link_fails_the_config_transform() {
+fn test_untransformed_site_link_fails_the_config_transform() {
// An unbalanced backtick in the link text: the code-span alternative can't
- // close, so the rewrite declines and the raw `@/` target would survive.
- transform_config_source_to_toml("See [a `broken span](@/config.md#hooks) here");
+ // close, so the rewrite declines and the raw target would survive.
+ transform_config_source_to_toml("See [a `broken span](/config/#hooks) here");
+}
+
+#[test]
+#[should_panic(expected = "legacy syntax")]
+fn test_legacy_zola_link_fails_the_guardrail() {
+ assert_no_untransformed_site_links("See [hooks](@/hook.md)", "test content");
}
/// Extract a config section from src/cli/mod.rs by marker pattern.
@@ -1462,13 +1259,14 @@ fn test_project_config_docs_include_all_sections() {
);
}
-/// Verify that LLM tool commands in docs/content/llm-commits.md match
+/// Verify that LLM tool commands in the Starlight LLM commits page match
/// the examples in config.example.toml (the single source of truth).
#[test]
fn test_llm_docs_commands_match_config_example() {
let project_root = Path::new(env!("CARGO_MANIFEST_DIR"));
let config_example = fs::read_to_string(project_root.join("dev/config.example.toml")).unwrap();
- let llm_docs = fs::read_to_string(project_root.join("docs/content/llm-commits.md")).unwrap();
+ let llm_docs =
+ fs::read_to_string(project_root.join("docs/src/content/docs/llm-commits.md")).unwrap();
// Extract commands from config example: "# command = ..." lines
let config_commands: Vec<String> = config_example
@@ -1500,7 +1298,7 @@ fn test_llm_docs_commands_match_config_example() {
for cmd in &config_commands {
assert!(
doc_commands.contains(cmd),
- "Command from config.example.toml not found in docs/content/llm-commits.md:\n {cmd}\n\
+ "Command from config.example.toml not found in docs/src/content/docs/llm-commits.md:\n {cmd}\n\
Update llm-commits.md to match the config example (source of truth: dev/config.example.toml, \
generated from src/cli/mod.rs)."
);
@@ -1641,7 +1439,7 @@ fn test_config_source_templates_are_in_sync() {
}
}
-/// Sync docs snapshot markers in a single file (with ANSI to HTML conversion)
+/// Sync snapshot markers in a docs file as portable console fences.
fn sync_docs_snapshots(doc_path: &Path, project_root: &Path) -> Result<usize, Vec<String>> {
if !doc_path.exists() {
return Ok(0);
@@ -1654,7 +1452,7 @@ fn sync_docs_snapshots(doc_path: &Path, project_root: &Path) -> Result<usize, Ve
match update_section(
&content,
&DOCS_SNAPSHOT_MARKER_PATTERN,
- OutputFormat::DocsHtml,
+ OutputFormat::DocsMarkdown,
|snap_path, _current_content| {
let full_path = project_root_for_snapshots.join(snap_path);
let raw = fs::read_to_string(&full_path)
@@ -1663,14 +1461,11 @@ fn sync_docs_snapshots(doc_path: &Path, project_root: &Path) -> Result<usize, Ve
// Extract command from snapshot YAML header
let command = extract_command_from_snapshot(&raw);
- let html_content = parse_snapshot_content_for_docs(&raw)?;
- let normalized = trim_lines(&html_content);
-
- // Prepend command line with styling if present
- // Prompt ($) is added via CSS ::before, so not included in HTML
+ let plain = trim_lines(&parse_snapshot_content(&raw));
Ok(match command {
- Some(cmd) => format!("<span class=\"cmd\">{}</span>\n{}", cmd, normalized),
- None => normalized,
+ Some(cmd) if plain.is_empty() => format!("$ {cmd}"),
+ Some(cmd) => format!("$ {cmd}\n{plain}"),
+ None => plain,
})
},
) {
@@ -1684,7 +1479,7 @@ fn sync_docs_snapshots(doc_path: &Path, project_root: &Path) -> Result<usize, Ve
}
}
-/// Update or insert the `description` field in TOML frontmatter.
+/// Update or insert the `description` field in YAML frontmatter.
///
/// Handles three cases:
/// - Description field exists → update it
@@ -1692,12 +1487,14 @@ fn sync_docs_snapshots(doc_path: &Path, project_root: &Path) -> Result<usize, Ve
/// - No frontmatter → return content unchanged
fn sync_frontmatter_description(content: &str, description: &str) -> String {
static DESC_PATTERN: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r#"(?m)^description\s*=\s*"[^"]*""#).unwrap());
+ LazyLock::new(|| Regex::new(r"(?m)^description:\s*.*$").unwrap());
- let new_field = format!(r#"description = "{}""#, description.replace('"', r#"\""#));
+ let new_field = format!(
+ "description: {}",
+ serde_json::to_string(description).unwrap()
+ );
- // Check if we're in a TOML frontmatter block
- if !content.starts_with("+++\n") {
+ if !content.starts_with("---\n") {
return content.to_string();
}
@@ -1709,7 +1506,7 @@ fn sync_frontmatter_description(content: &str, description: &str) -> String {
} else {
// Insert after title line
static TITLE_PATTERN: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r#"(?m)^(title\s*=\s*"[^"]*")\n"#).unwrap());
+ LazyLock::new(|| Regex::new(r"(?m)^(title:\s*.*)\n").unwrap());
TITLE_PATTERN
.replace(content, |caps: &regex::Captures| {
@@ -1719,6 +1516,27 @@ fn sync_frontmatter_description(content: &str, description: &str) -> String {
}
}
+#[test]
+fn test_starlight_frontmatter_helpers() {
+ let source = "---\ntitle: \"wt list\"\nsidebar:\n order: 11\n---\nBody\n";
+ let frontmatter = YAML_FRONTMATTER_PATTERN
+ .captures(source)
+ .and_then(|captures| captures.get(1))
+ .unwrap();
+ assert_eq!(
+ yaml_scalar(frontmatter.as_str(), "title").as_deref(),
+ Some("wt list")
+ );
+
+ let updated = sync_frontmatter_description(source, "List worktrees & show \"status\".");
+ assert!(updated.contains("description: \"List worktrees & show \\\"status\\\".\""));
+ assert!(updated.contains("sidebar:\n order: 11"));
+
+ let updated_again = sync_frontmatter_description(&updated, "Updated description.");
+ assert_eq!(updated_again.matches("description:").count(), 1);
+ assert!(updated_again.contains("description: \"Updated description.\""));
+}
+
/// Command pages generated via `wt <cmd> --help-page`
/// Each page preserves its frontmatter and replaces the AUTO-GENERATED marker region.
/// Note: `select` is excluded because it's a deprecated hidden alias for `wt switch`.
@@ -1748,14 +1566,14 @@ fn write_tracked(
updated.push(rel_path.into());
}
-/// Sync command pages from --help-page output to docs/content/*.md
+/// Sync command pages from --help-page output to the Starlight content collection.
/// Returns (errors, updated_files)
fn sync_command_pages(project_root: &Path) -> (Vec<String>, Vec<String>) {
let mut errors = Vec::new();
let mut updated_files = Vec::new();
for cmd in COMMAND_PAGES {
- let doc_path = project_root.join(format!("docs/content/{}.md", cmd));
+ let doc_path = project_root.join(format!("docs/src/content/docs/{}.md", cmd));
// Run wt <cmd> --help-page (outputs START marker + content + END marker)
let output = wt_command()
@@ -1789,26 +1607,13 @@ fn sync_command_pages(project_root: &Path) -> (Vec<String>, Vec<String>) {
continue;
}
- // Expand command placeholders (wt list -> terminal shortcode with snapshot output)
+ // Expand command placeholders into portable snapshot-backed console fences.
let snapshots_dir = project_root.join("tests/snapshots");
- let generated =
- match expand_command_placeholders(&generated, &snapshots_dir, ExpandMode::Html) {
- Ok(expanded) => expanded,
- Err(e) => {
- errors.push(format!(
- "Failed to expand placeholders for '{}': {}",
- cmd, e
- ));
- continue;
- }
- };
-
- // Convert command reference code blocks to terminal shortcodes with HTML
- let generated = match convert_command_reference_to_html(&generated) {
- Ok(converted) => converted,
+ let generated = match expand_command_placeholders(&generated, &snapshots_dir) {
+ Ok(expanded) => expanded.ansi_strip().into_owned(),
Err(e) => {
errors.push(format!(
- "Failed to convert command reference for '{}': {}",
+ "Failed to expand placeholders for '{}': {}",
cmd, e
));
continue;
@@ -1866,7 +1671,7 @@ fn sync_command_pages(project_root: &Path) -> (Vec<String>, Vec<String>) {
write_tracked(
&doc_path,
&new_content,
- format!("docs/content/{}.md", cmd),
+ format!("docs/src/content/docs/{}.md", cmd),
&mut updated_files,
);
}
@@ -1879,28 +1684,19 @@ fn sync_command_pages(project_root: &Path) -> (Vec<String>, Vec<String>) {
// Docs to Skill File Sync
// =============================================================================
-/// Regex to match Zola frontmatter and extract title
-static ZOLA_FRONTMATTER_PATTERN: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r"(?s)^\+\+\+\n(.*?)\n\+\+\+\n*").unwrap());
-
-/// Regex to extract title from frontmatter
-static ZOLA_TITLE_PATTERN: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r#"title\s*=\s*"([^"]+)""#).unwrap());
-
-/// Regex to strip body-form terminal shortcodes ({% terminal(...) %}...{% end %}).
-/// Optionally captures the cmd parameter value (group 1) and body (group 2).
-static ZOLA_TERMINAL_BODY_PATTERN: LazyLock<Regex> = LazyLock::new(|| {
- Regex::new(r#"(?s)\{%\s*terminal\((?:cmd="([^"]*)"\s*)?\)\s*%\}\n?(.*?)\{%\s*end\s*%\}"#)
- .unwrap()
-});
-
-/// Regex to strip self-closing terminal shortcodes ({{ terminal(cmd="...") }}).
-static ZOLA_TERMINAL_SELF_CLOSING_PATTERN: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r#"\{\{ terminal\(cmd="([^"]*)"\) \}\}"#).unwrap());
+/// YAML frontmatter used by Astro's Starlight content collection.
+static YAML_FRONTMATTER_PATTERN: LazyLock<Regex> =
+ LazyLock::new(|| Regex::new(r"(?s)^---\n(.*?)\n---\n*").unwrap());
-/// Regex to replace Zola experimental shortcode with plain text for skill files
-static ZOLA_EXPERIMENTAL_SHORTCODE: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r"\{\{\s*experimental\(\)\s*\}\}").unwrap());
+fn yaml_scalar(frontmatter: &str, key: &str) -> Option<String> {
+ let value = frontmatter
+ .lines()
+ .find_map(|line| line.strip_prefix(&format!("{key}:")))?
+ .trim();
+ serde_json::from_str(value)
+ .ok()
+ .or_else(|| (!value.is_empty()).then(|| value.to_string()))
+}
/// Regex to strip AUTO-GENERATED marker comments (just the comments, not content).
/// Matches the open prefix (with ⚠️) and the bare close form.
@@ -1917,102 +1713,23 @@ static AUTO_GENERATED_MARKER_PATTERN: LazyLock<Regex> = LazyLock::new(|| {
static HTML_FIGURE_PATTERN: LazyLock<Regex> =
LazyLock::new(|| Regex::new(r"(?s)<figure[^>]*>.*?</figure>\n*").unwrap());
-/// Regex to strip `<span class="cmd">...</span>` lines from shortcode bodies.
-/// These duplicate the cmd parameter content (the template uses `clean_body` for this).
-static SPAN_CMD_PATTERN: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r#"<span class="cmd">[^<]*</span>\n?"#).unwrap());
-
-/// Regex to convert `<span class="cmd">X</span>` → `$ X` for no-cmd body shortcodes.
-static SPAN_CMD_TO_DOLLAR: LazyLock<Regex> =
- LazyLock::new(|| Regex::new(r#"<span class="cmd">([^<]*)</span>"#).unwrap());
-
-/// Convert a `|||`-delimited cmd string (and optional body) into a ```bash block.
-/// When `with_prompt` is false, command lines pass through verbatim so the block
-/// is directly copy-pasteable. When true, command lines get a `$ ` prefix to
-/// distinguish them from interleaved output. Comment-only lines (`#`) and blank
-/// lines never get the prefix.
-fn cmd_to_bash_block(cmd: &str, body: &str, with_prompt: bool) -> String {
- let mut result = String::from("```bash\n");
- for line in cmd.split("|||") {
- if line.is_empty() {
- result.push('\n');
- } else if line.starts_with('#') {
- result.push_str(line);
- result.push('\n');
- } else {
- if with_prompt {
- result.push_str("$ ");
- }
- result.push_str(line);
- result.push('\n');
- }
- }
- // Strip <span class="cmd"> lines that duplicate the cmd parameter
- let clean_body = SPAN_CMD_PATTERN.replace_all(body, "");
- if !clean_body.is_empty() {
- result.push_str(&clean_body);
- if !clean_body.ends_with('\n') {
- result.push('\n');
- }
- }
- result.push_str("```");
- result
-}
-
/// Transform docs content for skill file consumption
///
/// Transforms:
-/// - Extracts title from Zola frontmatter and prepends as H1
-/// - Strips Zola terminal shortcodes ({% terminal() %}...{% end %}) - keeps inner content
+/// - Extracts title from YAML frontmatter and prepends it as H1
/// - Strips AUTO-GENERATED marker comments (keeps content)
/// - Strips HTML figure elements (demo GIFs not useful for skill)
-/// - Replaces Zola shortcodes with plain text equivalents
-/// - Converts Zola internal links (@/page.md) -> full URLs
+/// - Converts site-root links to full URLs
/// - Removes "See also" section (just links to other docs pages)
fn transform_docs_for_skill(content: &str) -> String {
// Extract title from frontmatter
- let title = ZOLA_FRONTMATTER_PATTERN
+ let title = YAML_FRONTMATTER_PATTERN
.captures(content)
.and_then(|caps| caps.get(1))
- .and_then(|fm| ZOLA_TITLE_PATTERN.captures(fm.as_str()))
- .and_then(|caps| caps.get(1))
- .map(|m| m.as_str().to_string());
+ .and_then(|fm| yaml_scalar(fm.as_str(), "title"));
// Strip frontmatter
- let content = ZOLA_FRONTMATTER_PATTERN.replace(content, "");
-
- // Strip terminal shortcodes, converting cmd parameters back to bash blocks.
- // Commands joined by `|||` are split into separate lines. Block-form shortcodes
- // with a body interleave command + output, so we keep the `$ ` prompt prefix
- // there to distinguish the two; self-closing shortcodes are pure commands and
- // get no prefix so the block stays copy-pasteable.
- let content = ZOLA_TERMINAL_BODY_PATTERN.replace_all(&content, |caps: &regex::Captures| {
- let body = caps.get(2).map_or("", |m| m.as_str());
- match caps.get(1) {
- Some(cmd) => cmd_to_bash_block(cmd.as_str(), body, !body.trim().is_empty()),
- None if body.contains(r#"<span class="cmd">"#) => {
- // Old-style body shortcode with <span class="cmd"> — convert to $ lines
- let converted = SPAN_CMD_TO_DOLLAR.replace_all(body, "$$ $1");
- format!("```bash\n{converted}```")
- }
- // Terminal bodies without cmd are styled CLI output demos (colored
- // spans, bold text). Strip HTML to plain text for skill files.
- None => strip_html(body),
- }
- });
- let content =
- ZOLA_TERMINAL_SELF_CLOSING_PATTERN.replace_all(&content, |caps: &regex::Captures| {
- cmd_to_bash_block(caps.get(1).map_or("", |m| m.as_str()), "", false)
- });
-
- // Strip rawcode shortcodes (keep content)
- let content = ZOLA_RAWCODE_PATTERN.replace_all(&content, "$1");
-
- // Replace placeholders used to escape Tera template syntax in cmd parameters
- let content = content
- .replace("__WT_OPEN__", "{{")
- .replace("__WT_CLOSE__", "}}")
- .replace("__WT_QUOT__", "\"");
+ let content = YAML_FRONTMATTER_PATTERN.replace(content, "");
// Strip AUTO-GENERATED marker comments (keep content)
let content = AUTO_GENERATED_MARKER_PATTERN.replace_all(&content, "");
@@ -2020,11 +1737,10 @@ fn transform_docs_for_skill(content: &str) -> String {
// Strip HTML figure elements (demo GIFs)
let content = HTML_FIGURE_PATTERN.replace_all(&content, "");
- // Replace experimental markers (shortcode and HTML badge) with plain text.
+ // Replace the HTML badge with its portable text equivalent.
// Sourcing the badge HTML from `worktrunk::docs` keeps producer (help.rs)
// and consumer (this strip) in lockstep: a format change there breaks
// here at compile time rather than silently leaking HTML into skills.
- let content = ZOLA_EXPERIMENTAL_SHORTCODE.replace_all(&content, "[experimental]");
let content = content.replace(worktrunk::docs::BADGE_EXPERIMENTAL_HTML, "[experimental]");
// Prepend title as H1 if extracted
@@ -2034,7 +1750,7 @@ fn transform_docs_for_skill(content: &str) -> String {
content.trim().to_string()
};
- // Apply shared finalization: Zola links, See also removal, blank line cleanup
+ // Apply shared finalization: links, See also removal, blank line cleanup
finalize_skill_content(&content)
}
@@ -2063,41 +1779,7 @@ fn remove_section(content: &str, heading: &str) -> String {
}
}
-/// Convert ```console blocks with $ to terminal shortcodes in all docs files.
-///
-/// Command pages already have this conversion via --help-page, but hand-written
-/// docs (faq.md, llm-commits.md, claude-code.md) can also use ```console with $
-/// and get the same treatment.
-fn convert_console_blocks_in_docs(project_root: &Path) -> (Vec<String>, Vec<String>) {
- let mut errors = Vec::new();
- let mut updated_files = Vec::new();
- let docs_dir = project_root.join("docs/content");
-
- for name in docs_content_page_names(&docs_dir) {
- let path = docs_dir.join(&name);
- let content = match fs::read_to_string(&path) {
- Ok(c) => c,
- Err(e) => {
- errors.push(format!("read {}: {e}", path.display()));
- continue;
- }
- };
- let converted = worktrunk::docs::convert_dollar_console_to_terminal(&content);
- if converted != content {
- write_tracked(
- &path,
- &converted,
- format!("docs/content/{name}"),
- &mut updated_files,
- );
- }
- }
-
- (errors, updated_files)
-}
-
-/// Sorted `.md` page filenames in `docs/content/` (excluding `_index.md`
-/// and similar underscore-prefixed Zola section markers).
+/// Sorted Markdown page filenames in the Starlight content collection.
fn docs_content_page_names(docs_dir: &Path) -> Vec<String> {
let mut names: Vec<String> = fs::read_dir(docs_dir)
.unwrap_or_else(|e| panic!("Failed to read {}: {}", docs_dir.display(), e))
@@ -2114,7 +1796,7 @@ fn sync_skill_files(project_root: &Path) -> (Vec<String>, Vec<String>) {
let mut errors = Vec::new();
let mut updated_files = Vec::new();
- let docs_dir = project_root.join("docs/content");
+ let docs_dir = project_root.join("docs/src/content/docs");
let skill_dir = project_root.join("skills/worktrunk/reference");
let entries = docs_content_page_names(&docs_dir);
@@ -2133,7 +1815,7 @@ fn sync_skill_files(project_root: &Path) -> (Vec<String>, Vec<String>) {
}
}
} else {
- // Non-command pages: read from docs, transform Zola syntax, strip residual HTML
+ // Non-command pages: read portable site Markdown and remove site-only elements.
let docs_file = docs_dir.join(name);
let docs_content = fs::read_to_string(&docs_file)
.unwrap_or_else(|e| panic!("Failed to read {}: {}", docs_file.display(), e));
@@ -2160,7 +1842,7 @@ fn sync_skill_files(project_root: &Path) -> (Vec<String>, Vec<String>) {
/// Generate a skill reference file directly from `--help-page --plain` output.
///
/// For command pages, this produces clean markdown without HTML. The only
-/// post-processing needed is Zola link transformation and section cleanup.
+/// post-processing needed is link expansion and section cleanup.
fn generate_skill_from_help(cmd: &str, project_root: &Path) -> Result<String, String> {
let output = wt_command()
.args([cmd, "--help-page", "--plain"])
@@ -2188,16 +1870,15 @@ fn generate_skill_from_help(cmd: &str, project_root: &Path) -> Result<String, St
// Expand command placeholders (e.g., <!-- wt list --> → plain text snapshot output)
let snapshots_dir = project_root.join("tests/snapshots");
- let content = expand_command_placeholders(&content, &snapshots_dir, ExpandMode::Plain)?;
+ let content = expand_command_placeholders(&content, &snapshots_dir)?;
Ok(finalize_skill_content(&content))
}
/// Apply final transforms shared between command and non-command skill files:
-/// Zola internal links → full URLs, remove "See also" section, collapse blank lines.
+/// Site-root links → full URLs, remove "See also", and collapse blank lines.
fn finalize_skill_content(content: &str) -> String {
- // Transform Zola internal links to full URLs
- let content = ZOLA_LINK_PATTERN
+ let content = SITE_LINK_PATTERN
.replace_all(content, |caps: &regex::Captures| {
let text = caps.get(1).unwrap().as_str();
let page = caps.get(2).unwrap().as_str();
@@ -2206,9 +1887,8 @@ fn finalize_skill_content(content: &str) -> String {
})
.into_owned();
- // Guardrail: ZOLA_LINK_PATTERN must catch every Zola internal link before
- // we ship skill content, which would otherwise carry a dead link.
- assert_no_untransformed_zola_links(&content, "skill content");
+ // Installed skills don't have the site's root URL as a resolution base.
+ assert_no_untransformed_site_links(&content, "skill content");
// Remove "See also" section (just contains links to other pages)
let content = remove_section(&content, "## See also");
@@ -2311,7 +1991,7 @@ fn sync_plugin_skills_mirror(project_root: &Path) -> (Vec<String>, Vec<String>)
/// Sync .well-known/agent-skills/ index.json and verify symlink.
///
/// The skill files are served via a symlink:
-/// docs/static/.well-known/agent-skills/worktrunk → ../../../../skills/worktrunk
+/// docs/public/.well-known/agent-skills/worktrunk → ../../../../skills/worktrunk
///
/// This function verifies the symlink is correct and generates index.json
/// with the correct SHA-256 digest per the Cloudflare agent-skills-discovery RFC.
@@ -2319,7 +1999,7 @@ fn sync_well_known_skills(project_root: &Path) -> (Vec<String>, Vec<String>) {
let mut errors = Vec::new();
let mut updated_files = Vec::new();
- let well_known_dir = project_root.join("docs/static/.well-known/agent-skills");
+ let well_known_dir = project_root.join("docs/public/.well-known/agent-skills");
let symlink_path = well_known_dir.join("worktrunk");
// Verify the symlink exists and points to the right place
@@ -2387,7 +2067,7 @@ fn sync_well_known_skills(project_root: &Path) -> (Vec<String>, Vec<String>) {
write_tracked(
&index_dst,
&index_json,
- "docs/static/.well-known/agent-skills/index.json",
+ "docs/public/.well-known/agent-skills/index.json",
&mut updated_files,
);
}
@@ -2464,7 +2144,7 @@ fn sync_cli_mod_example_bodies(project_root: &Path) -> (Vec<String>, Vec<String>
}
};
- let plain = trim_lines(&parse_snapshot_content_for_skill(&snapshot_content));
+ let plain = trim_lines(&parse_snapshot_content(&snapshot_content));
// Body ends with a newline before the closing fence; match the source
// convention so we don't churn whitespace on subsequent runs.
let new_body = if plain.is_empty() {
@@ -2493,7 +2173,7 @@ fn sync_cli_mod_example_bodies(project_root: &Path) -> (Vec<String>, Vec<String>
(errors, updated_files)
}
-/// Generate `docs/static/schema/list-v2.json` from `wt list --print-schema`,
+/// Generate `docs/public/schema/list-v2.json` from `wt list --print-schema`,
/// publishing it at the `$id` the document carries
/// (`https://worktrunk.dev/schema/list-v2.json`).
///
@@ -2530,7 +2210,7 @@ fn sync_json_schema(project_root: &Path) -> (Vec<String>, Vec<String>) {
return (errors, updated_files);
}
- let rel_path = "docs/static/schema/list-v2.json";
+ let rel_path = "docs/public/schema/list-v2.json";
let dst = project_root.join(rel_path);
if fs::read_to_string(&dst).unwrap_or_default() != generated {
write_tracked(&dst, &generated, rel_path, &mut updated_files);
@@ -2539,70 +2219,34 @@ fn sync_json_schema(project_root: &Path) -> (Vec<String>, Vec<String>) {
(errors, updated_files)
}
-/// Generate `docs/static/llms.txt` from `docs/content/*.md` front-matter,
+/// Generate `docs/public/llms.txt` from the Starlight content collection,
/// following the llms.txt spec (https://llmstxt.org/): H1, blockquote summary,
/// optional intro prose, H2 section headings with bulleted link lists.
///
/// Link targets use the `.md` companion URLs (served via symlinks in
-/// `docs/static/*.md` → `skills/worktrunk/reference/*.md`).
+/// `docs/public/*.md` → `skills/worktrunk/reference/*.md`).
fn sync_llms_txt(project_root: &Path) -> (Vec<String>, Vec<String>) {
- use serde::Deserialize;
use std::collections::BTreeMap;
- #[derive(Deserialize)]
- struct ExtraFm {
- group: Option<String>,
- }
-
- #[derive(Deserialize)]
struct Frontmatter {
title: String,
- #[serde(default)]
description: Option<String>,
- weight: i64,
- #[serde(default)]
- extra: Option<ExtraFm>,
+ order: i64,
}
let mut errors = Vec::new();
let mut updated = Vec::new();
- let docs_dir = project_root.join("docs/content");
- let config_path = project_root.join("docs/config.toml");
-
- let config_content = match fs::read_to_string(&config_path) {
- Ok(c) => c,
- Err(e) => {
- errors.push(format!("read {}: {e}", config_path.display()));
- return (errors, updated);
- }
- };
- let site_config: toml::Value = match toml::from_str(&config_content) {
- Ok(v) => v,
- Err(e) => {
- errors.push(format!("parse {}: {e}", config_path.display()));
- return (errors, updated);
- }
- };
- let site_title = site_config
- .get("title")
- .and_then(|v| v.as_str())
- .unwrap_or("Worktrunk");
- let site_description = site_config
- .get("extra")
- .and_then(|e| e.get("site_description"))
- .and_then(|v| v.as_str())
- .unwrap_or("");
- let base_url = site_config
- .get("base_url")
- .and_then(|v| v.as_str())
- .unwrap_or("https://worktrunk.dev/")
- .trim_end_matches('/');
+ let docs_dir = project_root.join("docs/src/content/docs");
+ let mut site_title = None;
+ let mut site_description = None;
+ let base_url = "https://worktrunk.dev";
let mut home_intro = String::new();
- // Group pages by `extra.group`; order groups by their minimum weight so
- // `## Commands` (weights 10–17) precedes `## Reference` (21–25) without
- // hard-coding group names.
+ // Starlight's sidebar is configured in astro.config.mjs. COMMAND_PAGES is
+ // already the sync taxonomy's canonical command-page set; all other listed
+ // pages are reference material. Order within each group follows
+ // `sidebar.order` from frontmatter.
let mut groups: BTreeMap<String, Vec<(String, Frontmatter)>> = BTreeMap::new();
for name in docs_content_page_names(&docs_dir) {
@@ -2615,41 +2259,77 @@ fn sync_llms_txt(project_root: &Path) -> (Vec<String>, Vec<String>) {
continue;
}
};
- let Some(rest) = content.strip_prefix("+++\n") else {
+ let Some(captures) = YAML_FRONTMATTER_PATTERN.captures(&content) else {
+ errors.push(format!("missing YAML frontmatter in {}", path.display()));
continue;
};
- let Some((fm_text, body)) = rest.split_once("\n+++\n") else {
+ let fm_text = captures.get(1).unwrap().as_str();
+ let body = &content[captures.get(0).unwrap().end()..];
+ let Some(title) = yaml_scalar(fm_text, "title") else {
+ errors.push(format!("frontmatter in {} has no title", path.display()));
continue;
};
- let fm: Frontmatter = match toml::from_str(fm_text) {
- Ok(fm) => fm,
- Err(e) => {
- errors.push(format!("parse frontmatter of {}: {e}", path.display()));
- continue;
- }
+ let order = fm_text
+ .lines()
+ .find_map(|line| line.trim().strip_prefix("order:"))
+ .and_then(|value| value.trim().parse::<i64>().ok());
+ let Some(order) = order else {
+ errors.push(format!(
+ "frontmatter in {} has no numeric sidebar.order",
+ path.display()
+ ));
+ continue;
+ };
+ let fm = Frontmatter {
+ title,
+ description: yaml_scalar(fm_text, "description"),
+ order,
};
- // Ungrouped pages supply the document's intro prose instead of becoming bullets.
- let Some(group) = fm.extra.as_ref().and_then(|e| e.group.clone()) else {
+ if slug == "worktrunk" {
+ site_title = Some(fm.title);
+ site_description = fm.description;
home_intro = extract_intro_prose(body);
continue;
+ }
+
+ let group = if COMMAND_PAGES.contains(&slug.as_str()) {
+ "Commands"
+ } else {
+ "Reference"
};
- groups.entry(group).or_default().push((slug, fm));
+ groups
+ .entry(group.to_string())
+ .or_default()
+ .push((slug, fm));
}
+ if !errors.is_empty() {
+ return (errors, updated);
+ }
+
+ let Some(site_title) = site_title else {
+ errors.push("docs content has no worktrunk.md homepage".to_string());
+ return (errors, updated);
+ };
+ let Some(site_description) =
+ site_description.filter(|description| !description.trim().is_empty())
+ else {
+ errors.push("worktrunk.md frontmatter has no description".to_string());
+ return (errors, updated);
+ };
+
for pages in groups.values_mut() {
- pages.sort_by_key(|(_, fm)| fm.weight);
+ pages.sort_by_key(|(_, fm)| fm.order);
}
let mut ordered: Vec<(String, Vec<(String, Frontmatter)>)> = groups.into_iter().collect();
- ordered.sort_by_key(|(_, pages)| pages.first().map(|(_, fm)| fm.weight).unwrap_or(i64::MAX));
+ ordered.sort_by_key(|(_, pages)| pages.first().map(|(_, fm)| fm.order).unwrap_or(i64::MAX));
use std::fmt::Write;
let mut out = String::new();
writeln!(out, "# {site_title}\n").unwrap();
- if !site_description.is_empty() {
- writeln!(out, "> {site_description}\n").unwrap();
- }
+ writeln!(out, "> {site_description}\n").unwrap();
if !home_intro.is_empty() {
writeln!(out, "{home_intro}\n").unwrap();
}
@@ -2670,10 +2350,10 @@ fn sync_llms_txt(project_root: &Path) -> (Vec<String>, Vec<String>) {
let out = format!("{}\n", out.trim_end());
- let dst = project_root.join("docs/static/llms.txt");
+ let dst = project_root.join("docs/public/llms.txt");
let current = fs::read_to_string(&dst).unwrap_or_default();
if current != out {
- write_tracked(&dst, &out, "docs/static/llms.txt", &mut updated);
+ write_tracked(&dst, &out, "docs/public/llms.txt", &mut updated);
}
(errors, updated)
}
@@ -2729,22 +2409,17 @@ fn test_docs_are_in_sync() {
let (mod_errors, mod_files) = sync_cli_mod_example_bodies(project_root);
tag("cli/mod.rs", mod_errors, mod_files);
- // Step 1: Sync command pages (mod.rs → docs/content/*.md)
+ // Step 1: Sync command pages into the Starlight content collection.
let (cmd_errors, cmd_files) = sync_command_pages(project_root);
tag("command pages", cmd_errors, cmd_files);
- // Step 1b: Convert $ console blocks to terminal shortcodes in ALL docs
- // (command pages already converted via --help-page; this catches hand-written docs)
- let (console_errors, console_files) = convert_console_blocks_in_docs(project_root);
- tag("console→terminal", console_errors, console_files);
-
- // Step 2: Sync standalone docs files (snapshots → docs/content/*.md).
+ // Step 2: Sync standalone docs files from snapshots.
// README extraction in step 5 reads these, so they must be current first.
let standalone_doc_files = [
- "docs/content/worktrunk.md",
- "docs/content/claude-code.md",
- "docs/content/tips-patterns.md",
- "docs/content/llm-commits.md",
+ "docs/src/content/docs/worktrunk.md",
+ "docs/src/content/docs/claude-code.md",
+ "docs/src/content/docs/tips-patterns.md",
+ "docs/src/content/docs/llm-commits.md",
];
let mut docs_errors: Vec<String> = Vec::new();
let mut docs_files: Vec<String> = Vec::new();
@@ -2761,7 +2436,7 @@ fn test_docs_are_in_sync() {
}
tag("standalone docs", docs_errors, docs_files);
- // Step 3: Sync skill files (docs/content/*.md → skills/*)
+ // Step 3: Sync skill files (Starlight Markdown → skills/*)
let (skill_errors, skill_files) = sync_skill_files(project_root);
tag("skill files", skill_errors, skill_files);
@@ -2770,23 +2445,23 @@ fn test_docs_are_in_sync() {
let (mirror_errors, mirror_files) = sync_plugin_skills_mirror(project_root);
tag("plugin skills mirror", mirror_errors, mirror_files);
- // Step 4: Sync .well-known/agent-skills/ (skills/ → docs/static/)
+ // Step 4: Sync .well-known/agent-skills/ (skills/ → docs/public/)
let (well_known_errors, well_known_files) = sync_well_known_skills(project_root);
tag(".well-known", well_known_errors, well_known_files);
- // Step 5: Generate docs/static/llms.txt from docs/content front-matter
+ // Step 5: Generate docs/public/llms.txt from Starlight frontmatter.
let (llms_errors, llms_files) = sync_llms_txt(project_root);
tag("llms.txt", llms_errors, llms_files);
- // Step 5b: Generate docs/static/schema/list-v2.json from the derived
- // schema. Grouped here because it also writes docs/static/, but it reads
+ // Step 5b: Generate docs/public/schema/list-v2.json from the derived
+ // schema. Grouped here because it also writes docs/public/, but it reads
// the binary rather than the markdown pipeline, so it has no ordering
// dependency on the steps above.
let (schema_errors, schema_files) = sync_json_schema(project_root);
tag("json schema", schema_errors, schema_files);
// Step 6: Sync README from the now-fresh docs files. Runs last because
- // section extraction depends on docs/content/*.md being current.
+ // section extraction depends on site Markdown being current.
let readme_path = project_root.join("README.md");
let readme_content = fs::read_to_string(&readme_path).unwrap();
let mut readme_errors: Vec<String> = Vec::new();
@@ -2826,7 +2501,7 @@ fn test_docs_are_in_sync() {
fn test_no_nested_auto_generated_markers() {
let project_root = Path::new(env!("CARGO_MANIFEST_DIR"));
let mut violations = Vec::new();
- for entry in fs::read_dir(project_root.join("docs/content")).unwrap() {
+ for entry in fs::read_dir(project_root.join("docs/src/content/docs")).unwrap() {
let path = entry.unwrap().path();
if path.extension().is_some_and(|e| e == "md") {
let content = fs::read_to_string(&path).unwrap();
@@ -2856,33 +2531,6 @@ fn test_no_nested_auto_generated_markers() {
);
}
-/// `terminal(cmd=...)` shortcodes must use the `__WT_QUOT__` placeholder for
-/// embedded double quotes — the terminal template substitutes that back to `"`
-/// before Syntect highlighting. Raw `&quot;` HTML entities pass through Tera
-/// untouched and render literally in the docs site (see #2495).
-#[test]
-fn test_terminal_cmd_uses_wt_quot_placeholder() {
- let project_root = Path::new(env!("CARGO_MANIFEST_DIR"));
- let mut violations = Vec::new();
- for entry in fs::read_dir(project_root.join("docs/content")).unwrap() {
- let path = entry.unwrap().path();
- if path.extension().is_some_and(|e| e == "md") {
- let content = fs::read_to_string(&path).unwrap();
- for (i, line) in content.lines().enumerate() {
- if line.contains("terminal(cmd=") && line.contains("&quot;") {
- violations.push(format!("{}:{}: {}", path.display(), i + 1, line.trim()));
- }
- }
- }
- }
- assert!(
- violations.is_empty(),
- "Found `&quot;` inside terminal(cmd=...) shortcodes — these render \
- literally on the docs site. Replace with `__WT_QUOT__`.\n\n{}",
- violations.join("\n")
- );
-}
-
/// The hand-authored `## Template variables` table in `src/cli/mod.rs` must
/// match the variable constants in `src/config/expansion.rs`. Drift means the
/// help docs lie about which vars hooks and aliases can reference.
@@ -2992,24 +2640,3 @@ fn test_template_variables_table_matches_constants() {
constants in src/config/expansion.rs. Update the table or the constants."
);
}
-
-/// Verify that post_process_for_html() transforms the approval prompt code block
-/// into a styled terminal shortcode. If the source text in cli/mod.rs changes
-/// without updating the replacement in help.rs, the .replace() silently stops
-/// matching and the web docs fall back to a plain code block.
-#[test]
-fn test_approval_prompt_styled_in_hook_page() {
- let project_root = Path::new(env!("CARGO_MANIFEST_DIR"));
- let output = wt_command()
- .args(["hook", "--help-page"])
- .current_dir(project_root)
- .output()
- .expect("Failed to run wt hook --help-page");
-
- let stdout = String::from_utf8_lossy(&output.stdout);
- assert!(
- stdout.contains(r#"class="y""#),
- "hook --help-page should contain styled approval prompt (class=\"y\" for yellow ▲). \
- If cli/mod.rs approval example changed, update the replacement in help.rs post_process_for_html()."
- );
-}
diff --git a/tests/integration_tests/remove.rs b/tests/integration_tests/remove.rs
index ccc68b626..e36ddbbc0 100644
--- a/tests/integration_tests/remove.rs
+++ b/tests/integration_tests/remove.rs
@@ -4012,7 +4012,7 @@ fn restore_dir_permissions(dir: &std::path::Path) {
// convention — `<!-- wt remove (docs-example) -->` in `src/cli/mod.rs`.
// ============================================================================
-/// `wt remove` example for `docs/content/remove.md` — pre-remove hook running
+/// `wt remove` example for `docs/src/content/docs/remove.md` — pre-remove hook running
/// `flyctl scale count 0`, background cleanup.
#[rstest]
fn test_docs_remove_pre_remove_hook(mut repo: TestRepo) {
diff --git a/tests/integration_tests/step_tether.rs b/tests/integration_tests/step_tether.rs
index 5facf7230..a2e697ab8 100644
--- a/tests/integration_tests/step_tether.rs
+++ b/tests/integration_tests/step_tether.rs
@@ -134,7 +134,7 @@ fn test_tether_kills_process_group_when_command_exits(repo: TestRepo) {
}
/// The global `-C <dir>` flag runs the tethered command in that directory —
-/// the canonical way to start a server from a subdirectory (zola in `docs/`,
+/// the canonical way to start a server from a subdirectory (Astro in `docs/`,
/// a dev server in `frontend/`) given the command runs directly with no shell
/// to `cd`. The reaper still watches the launch cwd, not `-C`.
#[rstest]
diff --git a/tests/integration_tests/user_hooks.rs b/tests/integration_tests/user_hooks.rs
index 40ccd1452..8acfa97e5 100644
--- a/tests/integration_tests/user_hooks.rs
+++ b/tests/integration_tests/user_hooks.rs
@@ -3982,7 +3982,7 @@ approved-commands = ["echo project-hook"]
// convention — `<!-- wt hook pre-merge (docs-example) -->` in `src/cli/mod.rs`.
// ============================================================================
-/// `wt hook pre-merge` example for `docs/content/hook.md` — two named
+/// `wt hook pre-merge` example for `docs/src/content/docs/hook.md` — two named
/// pre-merge hooks (test, lint) running mocked `cargo` commands.
#[rstest]
fn test_docs_hook_pre_merge(repo: TestRepo) {
diff --git a/tests/snapshots/integration__integration_tests__help__help_md_merge.snap b/tests/snapshots/integration__integration_tests__help__help_md_merge.snap
index f1f412dcf..f36aedc7a 100644
--- a/tests/snapshots/integration__integration_tests__help__help_md_merge.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_md_merge.snap
@@ -166,9 +166,9 @@ $ wt merge --no-commit --no-rebase
1. **Commit** — Pre-commit hooks run, then uncommitted changes are committed. Post-commit hooks run in background. Skipped when squashing (the default) — changes are staged during the squash step instead. With `--no-squash`, this is the only commit step.
2. **Squash** — Combines all commits since target into one (like GitHub's "Squash and merge"). Use `--stage` to control what gets staged: `all` (default), `tracked`, or `none`. Working-tree changes swept into the squash are backed up first to `refs/wt-backup/<branch>`. With `--no-squash`, individual commits are preserved.
-3. **Rebase** — Rebases onto target, skipping when nothing needs replaying ([`wt step rebase`](@/step.md#wt-step-rebase) gives the conditions). A conflict stops the merge with the rebase left open in the worktree, to resolve or abort. With `--no-rebase`, the graph produced by earlier commit/squash steps is preserved and the target must be able to fast-forward to its tip.
-4. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [`wt hook`](@/hook.md).
-5. **Merge** — Fast-forward merge to the target branch ([`wt step push`](@/step.md#wt-step-push)). With `--no-ff`, a merge commit is created instead — semi-linear history after the default rebase, while explicit `--no-rebase` preserves the graph produced by earlier steps before adding the merge commit. Non-fast-forward merges are rejected.
+3. **Rebase** — Rebases onto target, skipping when nothing needs replaying ([`wt step rebase`](/step/#wt-step-rebase) gives the conditions). A conflict stops the merge with the rebase left open in the worktree, to resolve or abort. With `--no-rebase`, the graph produced by earlier commit/squash steps is preserved and the target must be able to fast-forward to its tip.
+4. **Pre-merge hooks** — Hooks run after rebase, before merge. Failures abort. See [`wt hook`](/hook/).
+5. **Merge** — Fast-forward merge to the target branch ([`wt step push`](/step/#wt-step-push)). With `--no-ff`, a merge commit is created instead — semi-linear history after the default rebase, while explicit `--no-rebase` preserves the graph produced by earlier steps before adding the merge commit. Non-fast-forward merges are rejected.
6. **Pre-remove hooks** — Hooks run before removing worktree. Failures abort.
7. **Cleanup** — Removes the worktree and branch. Use `--no-remove` to keep the worktree. When already on the target branch or in the primary worktree, the worktree is preserved.
8. **Post-remove + post-merge hooks** — Run in background after cleanup.
@@ -193,8 +193,8 @@ lint = "cargo clippy"
## See also
-- [`wt step`](@/step.md) — Run individual operations (commit, squash, rebase, push)
-- [`wt remove`](@/remove.md) — Remove worktrees without merging
-- [`wt switch`](@/switch.md) — Navigate to other worktrees
+- [`wt step`](/step/) — Run individual operations (commit, squash, rebase, push)
+- [`wt remove`](/remove/) — Remove worktrees without merging
+- [`wt switch`](/switch/) — Navigate to other worktrees
----- stderr -----
diff --git a/tests/snapshots/integration__integration_tests__help__help_switch_long.snap b/tests/snapshots/integration__integration_tests__help__help_switch_long.snap
index b85c101d4..5f4d14a05 100644
--- a/tests/snapshots/integration__integration_tests__help__help_switch_long.snap
+++ b/tests/snapshots/integration__integration_tests__help__help_switch_long.snap
@@ -73,7 +73,7 @@ Usage: wt switch [OPTIONS] [BRANCH] [--
Without a branch argument, the interactive picker opens and the command runs against the selected worktree — so wt switch -x claude picks a worktree, then launches Claude Code there.
- Supports ]8;;@/hook.md#template-variables\hook template variables]8;;\ ({{ branch }}, {{ worktree_path }}, etc.) and filters. {{ base }} and {{ base_worktree_path }} describe the source: the selected base with --create, or the invoking worktree when switching to an existing worktree.
+ Supports ]8;;https://worktrunk.dev/hook/#template-variables\hook template variables]8;;\ ({{ branch }}, {{ worktree_path }}, etc.) and filters. {{ base }} and {{ base_worktree_path }} describe the source: the selected base with --create, or the invoking worktree when switching to an existing worktree.
Especially useful with shell aliases: