Preview gp-sphinx#36 curated default-value rendering

.github/workflows/docs.yml

@@ -4,6 +4,8 @@ on:
   push:
     branches:
       - main
+      # [DO NOT MERGE] preview branch for gp-sphinx PR #36 — revert before merge.
+      - improved-defaults-reprs
 
 permissions:
   contents: read
@@ -48,6 +50,21 @@ jobs:
         if: env.PUBLISH == 'true'
         run: uv python install ${{ matrix.python-version }}
 
+      # [DO NOT MERGE] pnpm + Node bootstrap for sphinx-vite-builder source build
+      # of gp-furo-theme — required while gp-sphinx-family deps resolve from the
+      # improved-defaults-reprs branch (see [tool.uv.sources]). Revert with the
+      # uv.sources block when gp-sphinx>=0.0.1a18 lands.
+      - name: Install pnpm
+        if: env.PUBLISH == 'true'
+        uses: pnpm/action-setup@v6
+        with:
+          version: 10
+      - name: Set up Node
+        if: env.PUBLISH == 'true'
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22
+
       - name: Install dependencies [w/ docs]
         if: env.PUBLISH == 'true'
         run: uv sync --all-extras --dev

.github/workflows/tests.yml

@@ -31,6 +31,19 @@ jobs:
           print("libtmux-mcp version:", __version__)
           '
 
+      # [DO NOT MERGE] pnpm + Node bootstrap for sphinx-vite-builder source build
+      # of gp-furo-theme — required while gp-sphinx-family deps resolve from the
+      # improved-defaults-reprs branch (see [tool.uv.sources]). Revert with the
+      # uv.sources block when gp-sphinx>=0.0.1a18 lands.
+      - name: Install pnpm
+        uses: pnpm/action-setup@v6
+        with:
+          version: 10
+      - name: Set up Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22
+
       - name: Install dependencies
         run: uv sync --all-extras --dev
 
@@ -109,6 +122,19 @@ jobs:
       - name: Set up Python ${{ matrix.python-version }}
         run: uv python install ${{ matrix.python-version }}
 
+      # [DO NOT MERGE] pnpm + Node bootstrap for sphinx-vite-builder source build
+      # of gp-furo-theme — required while gp-sphinx-family deps resolve from the
+      # improved-defaults-reprs branch (see [tool.uv.sources]). Revert with the
+      # uv.sources block when gp-sphinx>=0.0.1a18 lands.
+      - name: Install pnpm
+        uses: pnpm/action-setup@v6
+        with:
+          version: 10
+      - name: Set up Node
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22
+
       - name: Install dependencies
         run: uv sync --all-extras --dev
 

pyproject.toml

@@ -111,6 +111,16 @@ lint = [
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
+[tool.uv.sources]
+# TEMPORARY: pull gp-sphinx-family deps from the improved-defaults-reprs
+# branch on git-pull/gp-sphinx so this PR previews the curated-default
+# rendering work before a release bump propagates the changes via PyPI.
+# Revert this block when gp-sphinx>=0.0.1a18 lands.
+gp-sphinx = { git = "https://github.com/git-pull/gp-sphinx.git", branch = "improved-defaults-reprs", subdirectory = "packages/gp-sphinx" }
+sphinx-autodoc-typehints-gp = { git = "https://github.com/git-pull/gp-sphinx.git", branch = "improved-defaults-reprs", subdirectory = "packages/sphinx-autodoc-typehints-gp" }
+sphinx-autodoc-api-style = { git = "https://github.com/git-pull/gp-sphinx.git", branch = "improved-defaults-reprs", subdirectory = "packages/sphinx-autodoc-api-style" }
+sphinx-autodoc-fastmcp = { git = "https://github.com/git-pull/gp-sphinx.git", branch = "improved-defaults-reprs", subdirectory = "packages/sphinx-autodoc-fastmcp" }
+
 [tool.uv.exclude-newer-package]
 # git-pull packages release in lockstep with their workspaces, so a
 # fresh release blocking on the 3-day cooldown blocks every